Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Fixtures

Statistics

GET

/v2/fixtures/{id}/statistics

All plans

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

id

pathrequired

fixture id issued by DataSportsAPI, a positive integer

Response

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": [ … ] } ] } }