Leagues

League/v2/leagues/{id}

Returns a league’s profile: its tier (where it sits in the national pyramid), gender, the reigning champion with its title count, the clubs holding the most titles, the divisions directly above and below, and the opening and closing dates…

id

Seasons/v2/leagues/{id}/seasons

Lists the league’s seasons, most recent first.

id

Champions/v2/leagues/{id}/champions

Recent title winners of the league, most recent first — each entry gives the season, the year in which it finished and the champion.

id

Season venues/v2/leagues/{id}/venues

Lists every venue where matches of a league season are played.

id · season

Season calendar/v2/leagues/{id}/calendar

Returns each UTC day of a league season on which fixtures are scheduled, together with the number of fixtures — handy for drawing a season calendar or linking straight to a matchday via /v2/fixtures?date=&league=.

id · season

Players of the season/v2/leagues/{id}/player-of-the-season/history

A season-by-season record of the league’s player of the season — an award our data source bases on match ratings — giving the winner, his club, his average rating and his number of appearances.

id

Season teams/v2/leagues/{id}/teams

Lists the participants of a single league season; works just as well for cups and other competitions that have no table.

id · season

Season/v2/leagues/{id}/seasons/{seasonId}

Key figures for a season — running totals such as goals, home and away wins, draws and cards — plus the teams new to the division, whether relegated into it from above or promoted from below.

id · seasonId

Standings/v2/leagues/{id}/standings

League tables for a single season.

id · season · +2 optional

Rounds/v2/leagues/{id}/rounds

Lists every round of a season and indicates which one is current.

id · season

League fixtures/v2/leagues/{id}/fixtures

Returns all fixtures in a single round of a season.

id · season · round · +2 optional

Top players/v2/leagues/{id}/top-players

Per-statistic player leaderboards for a season — rating, goals, xG, assists, tackles, saves and more, each holding up to 50 players at our data source.

id · season · +4 optional

Top match performances/v2/leagues/{id}/top-performances

Record individual match performances in a league season.

id · season · +2 optional

Draft/v2/leagues/{id}/draft

Returns a single round of a league’s draft — the NBA, the NFL and any other league whose draft our data source tracks.

id · year · +1 optional

Top teams/v2/leagues/{id}/top-teams

Per-statistic team leaderboards for a season — average rating, goals scored, clean sheets, possession and more — paged the same way as top-players.

id · season · +4 optional

Player statistics explorer/v2/leagues/{id}/player-statistics

A sortable player-statistics table for a football season: every player in the league, 20 per page, ordered by any statistic and returned with one column set — summary, attack, defense, passing, goalkeeping or other — with optional position…

id · season · +6 optional

Cup trees/v2/leagues/{id}/cup-trees

Knockout brackets for a season, such as a cup’s knockout phase, a playoff tree or a tennis draw.

id · season

Team of the week periods/v2/leagues/{id}/team-of-the-week/periods

Every period in the season for which a team of the week exists, newest first — rounds in football and other round-based leagues, weeks in the NBA.

id · season

Team of the week/v2/leagues/{id}/team-of-the-week

The team of the week for a single round or week, laid out as a line-up of the top-rated players: the formation, then each player with his club, his position, the rating that won him the spot and the match in which he earned it.

id · season · +1 optional

Featured fixtures/v2/leagues/{id}/featured-fixtures

Matches our data source highlights for a league, typically the standout game of the round.

id

Player of the season/v2/leagues/{id}/player-of-the-season

Player of the season for a completed league season as chosen by our data source — the highest average match rating among players with enough appearances — together with his club and appearance count.

id · season

Player of the season race/v2/leagues/{id}/player-of-the-season/race

The ongoing contest for player of the season: the front-runners ranked by average rating, highest first.

id · season