Football · Germany · Tier 1
Bundesliga API with every season since 1970/71
A Bundesliga API for Germany's top flight: live scores, fixtures, the table, line-ups and statistics on league id 195937, with seasons back to 1970/71. Eighteen clubs and 306 matches a season, in the same JSON as every other league.
- 57 seasons since 1970/71
- 18 clubs · 306 matches a season
- League id 195937
- Team of the week from Pro

Bundesliga
GET /v2/leagues/195937
- League id
195937- Category
- Germany
- Tier
- 1
- Archive
- 57 seasons since 1970/71
- Teams
- 18 clubs
- Matches
- 306 matches a season
- Division below
- 2. Bundesliga
- Live channel
league:195937
In the data
The Bundesliga in the API
What league id 195937 holds, and how its seasons are laid out.
The right Bundesliga
Several competitions share the name: Austria's top football league is a Bundesliga too, and so is Germany's handball league. Pin league id 195937 instead of matching on the name; /v2/search returns every Bundesliga with its sport and category, which tells them apart. This one's archive starts in 1970/71, and its league card names the 2. Bundesliga below it.
Thirty-four rounds
With 18 clubs a season is 34 rounds and 306 matches. /rounds and /fixtures walk it round by round, the table comes overall, home or away, and a season's detail keeps running totals: goals, home and away wins, draws and cards. From Pro, /team-of-the-week picks the best-rated eleven of each round in formation, and /player-of-the-season/race follows the contest for the season's top average rating.
When the goals come
/v2/teams/{id}/goal-distribution splits a club's goals scored and conceded over a league season into 15-minute bands, home and away apart, the kind of figure a preview or a betting model reaches for. The shot map, momentum and heat maps follow each match from Pro, and /top-teams ranks the clubs by any team statistic on every plan.
Endpoints
The calls behind a Bundesliga app
Each takes league id 195937, a season id from its seasons list, or a match or team id from those. Every row opens its page in the docs.
- GET
/v2/leagues/{id}/seasonsSeasonsEvery Bundesliga season since 1970/71, newest first.All plans - GET
/v2/leagues/{id}/seasons/{seasonId}SeasonA season's totals and the clubs new to the division.All plans - GET
/v2/leagues/{id}/standingsStandingsThe table overall, home or away, with form and zones.All plans - GET
/v2/leagues/{id}/team-of-the-weekTeam of the weekThe best-rated eleven of a round, in formation.Pro and up - GET
/v2/leagues/{id}/player-of-the-season/racePlayer of the season raceThe front-runners for the season's top average rating.Pro and up - GET
/v2/teams/{id}/goal-distributionGoal distributionA club's goals for and against in 15-minute bands.All plans - GET
/v2/leagues/{id}/top-teamsTop teamsClubs ranked by rating, goals, clean sheets, possession and more.All plans - GET
/v2/fixtures/{id}/shotmapShot mapEach shot with xG and xGOT, where it was taken and how.Pro and up
First request
The Bundesliga in three calls
Every call starts from the league id, 195937. The seasons list gives the season ids, newest first, and the season id is what the tables, rounds, leaderboards and statistics ask for.
The answers use the usual { data, meta } envelope and the same field names as every other football competition, so the code works unchanged for the next league you add.
# Every season, newest first, with its season id
curl "https://api.datasportsapi.com/v2/leagues/195937/seasons" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
# The season's totals: goals, results, cards
curl "https://api.datasportsapi.com/v2/leagues/195937/seasons/{seasonId}" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
# Clubs ranked by any team statistic
curl "https://api.datasportsapi.com/v2/leagues/195937/top-teams?season={seasonId}" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"{ "data": {
"id": 195937, "name": "Bundesliga", "sport": "football",
"category": "Germany", "country": { "code": "DE", "name": "Germany" },
"tier": 1, "gender": "male",
"lowerDivisions": [ { "name": "2. Bundesliga", … } ],
…
} }History
How much of the Bundesliga each plan reads
The archive goes back to 1970/71. Each plan reads back a set time from today; nothing live or upcoming is ever held back.
| Topic | History | What it covers of the Bundesliga |
|---|---|---|
| Free | Last 7 days | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 7 days. |
| Starter | Last 30 days | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 30 days. |
| Pro | Last 6 months | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 6 months. |
| Business | Last 12 months | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 12 months. |
| Enterprise | Full history | The whole archive: 57 seasons since 1970/71. |
Questions
Bundesliga API, answered
Anything else? The full FAQ covers quota, plans and the data in general.
How do I make sure I get the German Bundesliga?
Use the id, 195937. Austria's top league and Germany's handball league are also called Bundesliga, so matching on the name is unsafe; /v2/search?q=bundesliga lists them all with their sport and category if you need to tell them apart.
Is there a team of the week for the Bundesliga?
Yes, from Pro. /v2/leagues/195937/team-of-the-week/periods lists the rounds that have one, and /team-of-the-week returns the eleven best-rated players of a round in formation, each with the match rating that put them there and the game it was earned in. Once published, a team of the week does not change.
Can I get the goals per game of a Bundesliga season?
Yes. /v2/leagues/195937/seasons/{seasonId} returns the season's running totals, goals, home and away wins, draws and cards, and the number of matches played comes from the fixtures. Per club, /v2/teams/{id}/statistics has the same figures and /goal-distribution shows when in a match they happen.
How far back does Bundesliga data go?
To 1970/71: the archive holds 57 seasons of the Bundesliga. How far back a key can read is set by its plan, counted back from today: Free 7 days, Starter 30 days, Pro 6 months, Business 12 months, and Enterprise the whole archive. Live and upcoming matches, and the table and statistics of a season still being played, are open on every plan.
Can I follow Bundesliga matches live on the free plan?
Yes. Live and upcoming matches are never held back by a plan, so a Free key follows every Bundesliga match in play through /v2/livescores or /v2/fixtures/{id}, with score, status and clock current to the second, within the plan's request quota. On Business and Enterprise, the WebSocket channel league:195937 pushes every change instead.
Keep reading
Other competitions
Premier League APILeague id 195828: live scores, the table, xG and every season since 1992/93.
Champions League APILeague id 4409: the 36-club league phase, the knockout bracket and every season since 1992/93.
La Liga APILeague id 4408: Spain's top flight, head-to-head records and every season since 1969/70.
Serie A APILeague id 195910: Italy's top flight, venues and the longest big-five archive, back to 1965/66.
Ligue 1 APILeague id 195793: France's top flight, every player's statistics and seasons since 1970/71.
World Cup APILeague id 195843: all 23 tournaments from 1930 to 2026, group tables and the bracket.
Süper Lig APILeague id 172801: Turkey's top division, its referees on record and seasons back to 1980/81.
MLS APILeague id 6540: 30 clubs, two conference tables and calendar-year seasons since 2008.
Europa League APILeague id 43443: one 36-club table, knockout ties on aggregate and seasons since 2009/10.
NBA APILeague id 198277: box scores, play-by-play, shot charts, the draft and live player tracking.
NFL APILeague id 201295: down and distance live, win probability, the draft and seasons back to 1920.
NHL APILeague id 201302: conference and division tables, shot maps by strength, the three stars and playoff series.
MLB APILeague id 201220: the live count, every at-bat and pitch, umpire crews and ballpark weather.
IPL APILeague id 195830: full scorecards, every ball with wagon wheel and pitch map, and seasons since 2013.
Everything in the football data Sports statistics API Live scores API
Build on the Bundesliga today.
1,000 free requests a day during the beta. No card, no sales call.