Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Players

Player season statistics

GET

/v2/players/{id}/statistics

All plans

View as MarkdownTry in Playground →

Season totals and averages for a player within a single league — goals, minutes, averageRating, expected goals, passes, duels and more.

Keys use the same vocabulary as match statistics: totalShots, shotsOnGoal, passes, averageRating, goalInvolvements, minutesPerGoal (omitted when the player has not scored), kilometersCovered (metersCovered / 1000) and so on. The data reference lists every football key with what it measures (season statistic keys). For football, ratingBreakdown shows how much shooting, passing, dribbling, defending and (goalkeepers only) goalkeeping added to the season rating; it is null when the source provides none.

Parameters

id

pathrequired

DataSportsAPI player id, a positive integer

league

queryrequired

league id, as listed by /v2/players/{id}/seasons

season

queryrequired

season id, as listed by /v2/leagues/{id}/seasons

type

query

a type the season offers according to /seasons (overall | home | away | regularSeason | playoffs); when omitted, the season’s native type applies — overall, otherwise regularSeason

Response

meta
league, season, type (as applied)
errors
400 bad_request — league or season is absent, or type is something other than overall, home, away, regularSeason or playoffs404 no_data — no statistics exist at the source for this combination of player, league, season and type (an id DataSportsAPI never assigned gives 404 not_found instead)404 not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/players/{id}/statistics?league=…&season=…"
Example
{ "data": { "team": { "id": 4438, "name": "Manchester City", "slug": "manchester-city", "shortName": "Man City",
             "code": "MCI", "image": "…" },
    "statistics": { "appearances": 7, "minutesPlayed": 620, "goals": 8, "assists": 0, "averageRating": 7.93,
                    "totalShots": 27, "shotsOnGoal": 13, "expectedAssists": 0.91, … },
    "ratingBreakdown": { "shotValue": 0.46, "passValue": 0.12, "dribbleValue": 0.05, "defensiveValue": 0.02,
                         "goalkeeperValue": null } },
  "meta": { "league": 195828, "season": 200386, "type": "overall" } }