get_standings
League table of a league, with summary: ready paragraphs on the league from our data (the race at the top and bottom, form side, scoring, top scorer, champions; English; summary_as_of; absent when not fresh; with lang de, es, it or fr in sold sports and a plan with Insights: the most important facts of the league's matches of the last 14 days in that language, from our fact templates only, else English; summary_lang says which); for soccer also the top scorers, most assists or most cards (top_scorers), every player's season statistics sorted by goals, assists, minutes, rating, xg or apps (player_stats), every team's season statistics with ranks such as the best defence (team_stats), the referees with cards and penalties per game (referees), the roll of honour with champions and runners-up per season and their sources (champions), home attendance per team and league (attendance), the xG table with expected points against real points (xg_table), players banned or one booking away from a ban (suspensions) and past seasons' final tables (season); for every sport with results Elo-style team ratings of a league or the whole sport (ratings); for tennis the ATP or WTA singles ranking (tour); for golf the season money list with wins (tour); for snooker and darts the world ranking (WPBSA, PDC Order of Merit); for boxing the current world champions per weight class and body; for cricket the points table of a series or league.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | language of team, league and country names: de, es, it or fr (default English) | |
| tour | No | tennis: atp or wta (the singles ranking, top 100); golf: pga (default) or lpga | |
| sport | Yes | sport (see list_sports) | |
| season | No | soccer: a past season's final table (2016-17, or 2016 for Brazil and MLS; the last 10 seasons of the top leagues, from Wikipedia: cite the attribution) instead of the current table; tennis: a year (2026) for that year's year-end ranking, first 100 places (final false while the year is not over; stored weekly from 2026-10) | |
| history | No | the league's table round by round instead of the table (position charts; sports with the data provider league tables, not cricket): soccer from our results for the current and previous season plus stored tables, other sports the stored tables from 2026-10-11 (history_from); with team_id only that team's row per round | |
| ratings | No | any sport with results: Elo-style team ratings (tennis: players) instead of the table, highest first, of the league (league_id) or of the whole sport without it; matches_rated and rated_from say how much history a rating stands on, provisional below 10; ratings compare across leagues only where those leagues' teams meet (cups, continental matches) | |
| team_id | No | with history: only this team | |
| referees | No | soccer: the league's referees instead of the table: games, yellow and red cards and penalties per game (computed from our match data, top leagues; league_matches_with_referee of league_matches_played says how complete; season: a past season) | |
| xg_table | No | soccer: xpts, xg_diff or points_minus_xpts for the league's xG table instead of the table: xG for and against, expected points (xpts, independent Poisson goals from both sides' xG) against real points and the difference (positive = more than expected: luckier or better finishing), all over matches_with_xg of played (top leagues; season: a past season) | |
| champions | No | soccer: the league's (or cup's) roll of honour instead of the table: champion and runner_up per season, each with its sources (wikipedia: the final tables of the last 10 seasons, top leagues; provider: the trophy lists of team profiles, further back but missing teams we do not hold); conflicts lists a team another source names for the same place: report it, do not pick silently; cite the attribution | |
| league_id | No | league code (or number) from find_leagues (not for tennis) | |
| attendance | No | soccer: the league season's home attendance instead of the table: league average and record, per team average, record and rank; matches_with_attendance of matches_played says how complete (often low: the feed lacks attendance for many matches, so say the average stands on that many matches; season: a past season) | |
| team_stats | No | soccer: ppg, goals_for, goals_against (best defence), clean_sheets, failed_to_score, xg_for, xg_against or attendance for every team's season statistics (home/away records, xG, attendance, ranks per metric) sorted by it, instead of the table (matches_with_xg and matches_with_attendance say how complete xG and attendance are; season: a past season) | |
| suspensions | No | soccer: the league's suspension watch instead of the table: players banned now (status suspended, matches_left) and one booking away from a ban (next_threshold, next_ban), from the league's official card rules (Premier League, EFL, Bundesliga, 2. Bundesliga, LaLiga, Segunda, Serie A, Serie B; rules.source) and our cards; rules_known and matches_with_stats of matches_played on every row; leagues without known rules list cards so far only | |
| top_scorers | No | soccer: goals, assists or cards for the league's top scorers, most assists or most cards instead of the table | |
| player_stats | No | soccer: goals, assists, minutes, rating, xg or apps for every player's season statistics in the league sorted by it, instead of the table (computed from our matches; matches_with_stats of team_matches_played says how complete a row is; season: a past season); NBA, MLB, NFL: a stat name such as points_per_game, home_runs, earned_run_average or passing.yards (category.stat) for the players' season lines from the data provider's team feeds (season null for the NBA: before a new season the feed still holds the last one; as_of says when it was read); hockey: goals, assists, points (NHL, Liiga, SHL, DEL lines from box scores); handball: goals, penalty_goals or expulsions (Swedish and Austrian lower leagues' lines from the federations' statistics and match reports; null = not in our data) |