Statistics
GET
/
View as MarkdownTry in Playground →
Team statistics for the match, organised by period and by category.
Coverage is graded the same way as for lineups and grows richer as the match goes on: a lower-tier fixture might offer nothing but cards, whereas a top league delivers every group. Statistic keys form one shared vocabulary across all sports (totalShots, shotsOnGoal, passes, fouls, …; the reference’s Statistic keys lists every key per sport), and group keys follow a fixed table for each sport. In American football, the team-level passingNetYards and passingYardsPerAttempt are gross figures from the source (sacks are not subtracted), whereas a player’s passingNetYards in the lineups is net. A fixture without statistics (yet — before kick-off, for instance) returns 200 with { "periods": [] }; you only get 404 for an id that does not exist. Data is refreshed approximately every 30 seconds during a live match.
Parameters
idpathrequired
fixture id issued by DataSportsAPI, a positive integer
Response
- data
Statistics
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/fixtures/{id}/statistics"Example
{ "data": { "periods": [ { "period": "all", "groups": [
{ "key": "matchOverview", "name": "Match overview", "items": [
{ "key": "ballPossession", "name": "Ball possession", "kind": "value", "higherIs": "better",
"home": { "display": "26%", "value": 26, "total": null }, "away": { "display": "74%", "value": 74, "total": null } },
{ "key": "fouls", "name": "Fouls", "kind": "value", "higherIs": "worse",
"home": { "display": "13", "value": 13, "total": null }, "away": { "display": "11", "value": 11, "total": null } },
{ "key": "accurateLongBalls", "name": "Long balls", "kind": "ratio", "higherIs": "better",
"home": { "display": "30/64 (47%)", "value": 30, "total": 64 }, "away": { … } }, … ] } ] },
{ "period": "period1", "groups": [ … ] } ] } }