SOCCER — OpenLigaDB (api.openligadb.de, community German football)

sportsdataverse.soccer — 11 endpoints.

openligadb_current_group

Current matchday.

Endpoint URL: GET https://api.openligadb.de/getcurrentgroup/{league_slug}

Valid URL: https://api.openligadb.de/getcurrentgroup/bl1

API Parameter	Python	Pattern	Required	Nullable	Description
`league_slug`	`league_slug`		`Y`		League shortcut from /getavailableleagues, e.g. bl1 (Bundesliga).

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
`group_name`	character
`group_order_id`	character
`group_id`	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

openligadb_current_group(league_slug='bl1')

Last validated n/a.

openligadb_goalgetters

Top scorers.

Endpoint URL: GET https://api.openligadb.de/getgoalgetters/{league_slug}/{season}

Valid URL: https://api.openligadb.de/getgoalgetters/bl1/2025

API Parameter	Python	Pattern	Required	Nullable	Description
`league_slug`	`league_slug`		`Y`		League shortcut from /getavailableleagues, e.g. bl1 (Bundesliga).
`season`	`season`		`Y`		Season start year, e.g. 2025 for 2025/26.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
`goal_getter_id`	character
`goal_getter_name`	character
`goal_count`	integer

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

openligadb_goalgetters(league_slug='bl1', season='2025')

Last validated n/a.

openligadb_group_matches

Matches of one matchday.

Endpoint URL: GET https://api.openligadb.de/getmatchdata/{league_slug}/{season}/{group}

Valid URL: https://api.openligadb.de/getmatchdata/bl1/2025/1

API Parameter	Python	Required	Description
`league_slug`	`league_slug`	`Y`	League shortcut from /getavailableleagues, e.g. bl1 (Bundesliga).
`season`	`season`	`Y`	Season start year, e.g. 2025 for 2025/26.
`group`	`group`	`Y`	Matchday number (groupOrderID from /getavailablegroups), e.g. 1.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
`match_id`	character
`match_date_time`	character
`time_zone_id`	character
`league_id`	character
`league_name`	character
`league_season`	integer
`league_shortcut`	character
`match_date_time_utc`	character
`last_update_date_time`	character
`match_is_finished`	logical
`match_results`	character
`goals`	character
`location`	character
`number_of_viewers`	character
`group_group_name`	character
`group_group_order_id`	character
`group_group_id`	character
`team1_team_id`	character
`team1_team_name`	character
`team1_short_name`	character
`team1_team_icon_url`	character
`team1_team_group_name`	character
`team2_team_id`	character
`team2_team_name`	character
`team2_short_name`	character
`team2_team_icon_url`	character
`team2_team_group_name`	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

openligadb_group_matches(group='1', league_slug='bl1', season='2025')

Last validated n/a.

openligadb_groups

Matchdays of a league-season.

Endpoint URL: GET https://api.openligadb.de/getavailablegroups/{league_slug}/{season}

Valid URL: https://api.openligadb.de/getavailablegroups/bl1/2025

API Parameter	Python	Pattern	Required	Nullable	Description
`league_slug`	`league_slug`		`Y`		League shortcut from /getavailableleagues, e.g. bl1 (Bundesliga).
`season`	`season`		`Y`		Season start year, e.g. 2025 for 2025/26.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
`group_name`	character
`group_order_id`	character
`group_id`	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

openligadb_groups(league_slug='bl1', season='2025')

Last validated n/a.

openligadb_last_change_date

Last change timestamp (bare ISO string).

Endpoint URL: GET https://api.openligadb.de/getlastchangedate/{league_slug}/{season}/{group}

Valid URL: https://api.openligadb.de/getlastchangedate/bl1/2025/1

API Parameter	Python	Required	Description
`league_slug`	`league_slug`	`Y`	League shortcut from /getavailableleagues, e.g. bl1 (Bundesliga).
`season`	`season`	`Y`	Season start year, e.g. 2025 for 2025/26.
`group`	`group`	`Y`	Matchday number (groupOrderID from /getavailablegroups), e.g. 1.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
`value`	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

openligadb_last_change_date(group='1', league_slug='bl1', season='2025')

Last validated n/a.

openligadb_leagues

All leagues (shortcut, season, sport).

Endpoint URL: GET https://api.openligadb.de/getavailableleagues

Valid URL: https://api.openligadb.de/getavailableleagues

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
`league_id`	character
`league_name`	character
`league_shortcut`	character
`league_season`	character
`sport_sport_id`	character	Yahoo identifier of the sport the league belongs to.
`sport_sport_name`	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

openligadb_leagues()

Last validated n/a.

openligadb_match

One match.

Endpoint URL: GET https://api.openligadb.de/getmatchdata/{match_id}

Valid URL: https://api.openligadb.de/getmatchdata/77264

API Parameter	Python	Pattern	Required	Nullable	Description
`match_id`	`match_id`		`Y`		Match id (matchID from any getmatchdata list), e.g. 77264.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
`match_id`	character
`match_date_time`	character
`time_zone_id`	character
`league_id`	character
`league_name`	character
`league_season`	integer
`league_shortcut`	character
`match_date_time_utc`	character
`last_update_date_time`	character
`match_is_finished`	logical
`match_results`	character
`goals`	character
`location`	character
`number_of_viewers`	character
`group_group_name`	character
`group_group_order_id`	character
`group_group_id`	character
`team1_team_id`	character
`team1_team_name`	character
`team1_short_name`	character
`team1_team_icon_url`	character
`team1_team_group_name`	character
`team2_team_id`	character
`team2_team_name`	character
`team2_short_name`	character
`team2_team_icon_url`	character
`team2_team_group_name`	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

openligadb_match(match_id='77264')

Last validated n/a.

openligadb_next_match

Next match of a team (404 text once the season is over).

Endpoint URL: GET https://api.openligadb.de/getnextmatchbyleagueteam/{league_id}/{team_id}

Valid URL: https://api.openligadb.de/getnextmatchbyleagueteam/4937/40

API Parameter	Python	Pattern	Required	Nullable	Description
`league_id`	`league_id`		`Y`		Numeric leagueId from /getavailableleagues of a season still in progress, e.g. 4937 (bl1 2026); a finished season answers 404 text.
`team_id`	`team_id`		`Y`		Team id (teamId from /getavailableteams), e.g. 40 (FC Bayern München).

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
`match_id`	character
`match_date_time`	character
`time_zone_id`	character
`league_id`	character
`league_name`	character
`league_season`	integer
`league_shortcut`	character
`match_date_time_utc`	character
`last_update_date_time`	character
`match_is_finished`	logical
`match_results`	character
`goals`	character
`location`	character
`number_of_viewers`	character
`group_group_name`	character
`group_group_order_id`	character
`group_group_id`	character
`team1_team_id`	character
`team1_team_name`	character
`team1_short_name`	character
`team1_team_icon_url`	character
`team1_team_group_name`	character
`team2_team_id`	character
`team2_team_name`	character
`team2_short_name`	character
`team2_team_icon_url`	character
`team2_team_group_name`	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

openligadb_next_match(league_id='4937', team_id='40')

Last validated n/a.

openligadb_season_matches

All matches of a season.

Endpoint URL: GET https://api.openligadb.de/getmatchdata/{league_slug}/{season}

Valid URL: https://api.openligadb.de/getmatchdata/bl1/2025

API Parameter	Python	Pattern	Required	Nullable	Description
`league_slug`	`league_slug`		`Y`		League shortcut from /getavailableleagues, e.g. bl1 (Bundesliga).
`season`	`season`		`Y`		Season start year, e.g. 2025 for 2025/26.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
`match_id`	character
`match_date_time`	character
`time_zone_id`	character
`league_id`	character
`league_name`	character
`league_season`	integer
`league_shortcut`	character
`match_date_time_utc`	character
`last_update_date_time`	character
`match_is_finished`	logical
`match_results`	character
`goals`	character
`location`	character
`number_of_viewers`	character
`group_group_name`	character
`group_group_order_id`	character
`group_group_id`	character
`team1_team_id`	character
`team1_team_name`	character
`team1_short_name`	character
`team1_team_icon_url`	character
`team1_team_group_name`	character
`team2_team_id`	character
`team2_team_name`	character
`team2_short_name`	character
`team2_team_icon_url`	character
`team2_team_group_name`	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

openligadb_season_matches(league_slug='bl1', season='2025')

Last validated n/a.

openligadb_table

League table.

Endpoint URL: GET https://api.openligadb.de/getbltable/{league_slug}/{season}

Valid URL: https://api.openligadb.de/getbltable/bl1/2025

API Parameter	Python	Pattern	Required	Nullable	Description
`league_slug`	`league_slug`		`Y`		League shortcut from /getavailableleagues, e.g. bl1 (Bundesliga).
`season`	`season`		`Y`		Season start year, e.g. 2025 for 2025/26.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
`team_info_id`	character
`team_name`	character
`short_name`	character
`team_icon_url`	character
`points`	integer
`opponent_goals`	integer
`goals`	integer
`matches`	integer
`won`	integer
`lost`	integer
`draw`	integer
`goal_diff`	integer

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

openligadb_table(league_slug='bl1', season='2025')

Last validated n/a.

openligadb_teams

Teams of a league-season.

Endpoint URL: GET https://api.openligadb.de/getavailableteams/{league_slug}/{season}

Valid URL: https://api.openligadb.de/getavailableteams/bl1/2025

API Parameter	Python	Pattern	Required	Nullable	Description
`league_slug`	`league_slug`		`Y`		League shortcut from /getavailableleagues, e.g. bl1 (Bundesliga).
`season`	`season`		`Y`		Season start year, e.g. 2025 for 2025/26.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
`team_id`	character	ESPN numeric identifier for the team.
`team_name`	character
`short_name`	character
`team_icon_url`	character
`team_group_name`	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

openligadb_teams(league_slug='bl1', season='2025')

Last validated n/a.

openligadb_current_group​

Returns​

Example​

openligadb_goalgetters​

Returns​

Example​

openligadb_group_matches​

Returns​

Example​

openligadb_groups​

Returns​

Example​

openligadb_last_change_date​

Returns​

Example​

openligadb_leagues​

Returns​

Example​

openligadb_match​

Returns​

Example​

openligadb_next_match​

Returns​

Example​

openligadb_season_matches​

Returns​

Example​

openligadb_table​

Returns​

Example​

openligadb_teams​

Returns​

Example​

openligadb_current_group

Returns

Example

openligadb_goalgetters

Returns

Example

openligadb_group_matches

Returns

Example

openligadb_groups

Returns

Example

openligadb_last_change_date

Returns

Example

openligadb_leagues

Returns

Example

openligadb_match

Returns

Example

openligadb_next_match

Returns

Example

openligadb_season_matches

Returns

Example

openligadb_table

Returns

Example

openligadb_teams

Returns

Example