Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab

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.

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"
GET /v2/leagues/195937 · trimmed
{ "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.

TopicHistoryWhat it covers of the Bundesliga
FreeLast 7 daysLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 7 days.
StarterLast 30 daysLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 30 days.
ProLast 6 monthsLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 6 months.
BusinessLast 12 monthsLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 12 months.
EnterpriseFull historyThe 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

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.