Match statistics
Retrieve aggregated team statistics for one game.
- Refresh interval
- Every minute
- Level
- Team totals
The path parameter is the match id, which comes from matches.
Shape of the response
The response is an array of exactly two elements, one per team.
Each element holds a team object, which carries the team's
id, name and logo together with a
statistics list. Each entry in that list is a single metric with a
name, a group of Batting,
Pitching or Fielding, and a numeric value.
Batting
Team offensive performance.
| Statistic | Measures |
|---|---|
| Total At Bats | Official team at bats. |
| Total Hits | Hits recorded by the team. |
| Total Runs | Runs scored. |
| Total RBIs | Runs driven in by the team's offensive actions. |
| Total Home Runs | Home runs hit. |
| Total Walks | Bases on balls earned. |
| Total Strikeouts | Strikeouts by batters. |
| Batting Average | Hits divided by total at bats. |
| On-Base Percentage | How often the team reaches base safely. |
| Slugging Percentage | Batting power, based on total bases per at bat. |
| On-Base Plus Slugging | On base and slugging percentage combined. |
Pitching
Team performance while pitching.
| Statistic | Measures |
|---|---|
| Innings Pitched | Total innings pitched by the team. |
| Hits Allowed | Hits allowed by team pitchers. |
| Runs Allowed | Runs conceded. |
| Total Earned Runs | Runs that scored without defensive errors. |
| Total Walks Allowed | Batters walked. |
| Total Strikeouts | Batters struck out. |
| Home Runs Allowed | Home runs conceded. |
| Earned Run Average | Average earned runs allowed per nine innings. |
| Total Pitches Thrown | Pitches thrown by team pitchers. |
Fielding
Team defensive performance.
| Statistic | Measures |
|---|---|
| Total Putouts | Outs recorded by fielders. |
| Total Assists | Assists recorded. |
| Total Errors | Defensive errors committed. |
| Total Chances | Total defensive chances. |
| Fielding Percentage | Share of defensive plays completed successfully. |
Team totals and per player
This endpoint aggregates a game to two team records. For the same game broken down to one record per player, use box scores, which refreshes at the same rate.
Parameters
| Parameter | Type | Description |
|---|---|---|
idrequired
|
numberpath | Requested match id |
Request
curl --request GET \
--url 'https://baseball.highlightly.net/statistics/{id}' \
--header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://baseball.highlightly.net/statistics/{id}', {
headers: {
'x-rapidapi-key': process.env.HIGHLIGHTLY_API_KEY
}
})
if (!response.ok) {
throw new Error(`Highlightly responded ${response.status}`)
}
const data = await response.json()
import os
import requests
response = requests.get(
'https://baseball.highlightly.net/statistics/{id}',
headers={
'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
},
timeout=10,
)
response.raise_for_status()
data = response.json()
Response
teamBaseballMatchTeamStatisticsResponserequired7 fields
idnumberrequired
namestringrequired
logostring
statisticsBaseballTeamStatItemResponse[]required3 fields
namestringrequired
valuenumberrequired
groupstringrequired
Example response
[
{
"team": {
"id": 10291185,
"name": "Toronto Blue Jays",
"logo": "https://highlightly.net/baseball/images/teams/10291185.png",
"statistics": [
{
"name": "Total Strikeouts",
"value": 12,
"group": "Batting"
}
]
}
}
]
Values are the examples declared in the OpenAPI spec, not a captured live response.
Errors
| Status | Description |
|---|---|
400 |
Bad request descriptive error. |