Top match performances
/
View as MarkdownTry in Playground →
Record individual match performances in a league season. For each statistic — in football goals, assists, rating, xG, key passes, saves, top speed, distance covered, …; in basketball points, rebounds, assists, …; in ice hockey points, hits, saves, … — you get up to 10 players, each with the value and the fixture in which it was achieved. Pass category to limit the response to one statistic.
Parameters
idpathrequired
league id issued by DataSportsAPI, a positive integer
seasonqueryrequired
season id, as listed by /v2/leagues/{id}/seasons
typequery
overall | home | away | regularSeason | playoffs. When omitted, the season’s own default applies: overall if the season has it (football), otherwise regularSeason (NBA, NHL, …); meta.type reports the value used
categoryquery
restricts the response to a single statistic key from the list (e.g. topSpeed)
Response
- data
TopPerformancesCategory[]- meta
- season, type (the value actually applied), category (null when every statistic is included), count (how many categories)
- errors
- 400
bad_request— one of: season missing or invalid; type outside overall, home, away, regularSeason, playoffs; category malformed404not_found— the season id does not belong to this league
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/leagues/{id}/top-performances?season=…"{ "data": [ { "category": "rating", "performances": [
{ "player": { "id": 3802, "name": "Bruno Fernandes", "image": "…", … },
"fixture": { "id": 701102, "home": { "name": "Manchester United", … }, "away": { "name": "Ipswich Town", … },
"homeScore": { "current": 5, … }, "awayScore": { "current": 2, … }, "status": { "type": "finished", … }, … },
"value": 10 }, … ] },
{ "category": "topSpeed", "performances": [ { "player": { "name": "Harvey Barnes", … }, "fixture": { … }, "value": 36.207 }, … ] }, … ],
"meta": { "season": 200386, "type": "overall", "category": null, "count": 21 } }