22 endpoints
Leagues endpoints
A competition and everything inside one of its seasons: the table, rounds and fixtures, leaderboards, knockout brackets, team of the week and the season awards.
- GETLeague/
v2/ leagues/ {id}A league’s profile: tier (level in the national pyramid), gender, reigning champion and its title count, clubs with the most titles, the divisions above and below, and when the current season starts… - GETSeasons/
v2/ leagues/ {id}/ seasonsLists the league’s seasons, most recent first. - GETChampions/
v2/ leagues/ {id}/ championsRecent title winners of the league, most recent first — each entry gives the season, the year in which it finished and the champion. - GETSeason venues/
v2/ leagues/ {id}/ venuesLists every venue where matches of a league season are played. - GETSeason calendar/
v2/ leagues/ {id}/ calendarReturns 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?… - GETPlayers of the season/
v2/ leagues/ {id}/ player-of-the-season/ historyPro and upA season-by-season record of the league’s player of the season — an award our data source bases on match ratings — giving the winner, their club, their average rating and their number of appearances. - GETSeason teams/
v2/ leagues/ {id}/ teamsLists the participants of a single league season; works just as well for cups and other competitions that have no table. - GETSeason/
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. - GETStandings/
v2/ leagues/ {id}/ standingsLeague tables for a single season. - GETRounds/
v2/ leagues/ {id}/ roundsLists every round of a season and indicates which one is current. - GETLeague fixtures/
v2/ leagues/ {id}/ fixturesReturns all fixtures in a single round of a season. - GETTop players/
v2/ leagues/ {id}/ top-playersPro and upSeason leaderboards per statistic (rating, goals, assists, xG, tackles, saves and more; up to 50 players each at our data source), paged with limit players per board (10 by default), or one board via… - GETTop match performances/
v2/ leagues/ {id}/ top-performancesPro and upRecord individual match performances in a league season. - GETDraft/
v2/ leagues/ {id}/ draftOne round of a league’s draft (NBA, NFL or any league whose draft our data source tracks): picks in order, each with the selecting club, the club it came from by trade and the player (an id for /v2/p… - GETTop teams/
v2/ leagues/ {id}/ top-teamsPer-statistic team leaderboards for a season — average rating, goals scored, clean sheets, possession and more — paged the same way as top-players. - GETPlayer statistics explorer/
v2/ leagues/ {id}/ player-statisticsPro and upA 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, goalk… - GETCup trees/
v2/ leagues/ {id}/ cup-treesA season’s knockout brackets (the knockout phase of a cup in football and other sports, a playoff tree, a tennis draw), nested as rounds, then ties, then each tie’s two participants (team, seed, winn… - GETTeam of the week periods/
v2/ leagues/ {id}/ team-of-the-week/ periodsEvery 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. - GETTeam of the week/
v2/ leagues/ {id}/ team-of-the-weekPro and upThe team of the week for one round or week, set out as a line-up of the top-rated players: formation, then each player with their club, position, the rating that won them the spot and the match they… - GETFeatured fixtures/
v2/ leagues/ {id}/ featured-fixturesMatches our data source highlights for a league, typically the standout game of the round. - GETPlayer of the season/
v2/ leagues/ {id}/ player-of-the-seasonPro and upPlayer 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 their club and appearance coun… - GETPlayer of the season race/
v2/ leagues/ {id}/ player-of-the-season/ racePro and upThe ongoing contest for player of the season: the front-runners ranked by average rating, highest first.