Season ratings
GET
/
View as MarkdownTry in Playground →
Match-by-match ratings for a player across one league season, oldest first, forming the points of a rating graph; each point gives the match, its kick-off, the player’s side and the opponent.
Values are the source’s football match ratings on a 0–10 scale. The array is empty if none of the player’s matches that season received a rating.
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
Response
- data
PlayerRating[]- meta
- league, season, count
- errors
- 403
history_not_in_plan— the season finished before your plan’s history window begins404not_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/players/{id}/ratings?league=…&season=…"Example
{ "data": [
{ "fixtureId": 701120, "startTime": "2026-09-19T14:00:00.000Z", "rating": 7.3, "side": "away", "opponent": { "id": 30, "name": "Brighton & Hove Albion", … } },
{ "fixtureId": 701233, "startTime": "2026-10-11T12:30:00.000Z", "rating": 7.2, "side": "home", "opponent": { "name": "Leeds United", … } }, … ],
"meta": { "league": 195828, "season": 200386, "count": 7 } }