Player season statistics
GET
/
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
idpathrequired
DataSportsAPI player id, a positive integer
leaguequeryrequired
league id, as listed by /v2/players/{id}/seasons
seasonqueryrequired
season id, as listed by /v2/leagues/{id}/seasons
typequery
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
- data
PlayerStatistics- 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 playoffs404no_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)404not_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" } }