German Football Results & Tables

What does German Football Results & Tables do?

German Football Results & Tables returns structured German football match results and league tables for selected men's and women's competitions. It focuses on German domestic football only: Bundesliga, 2. Bundesliga, 3. Liga, DFB-Pokal, Frauen-Bundesliga, and 2. Frauen-Bundesliga.

The actor is useful as a lightweight German football API alternative when you need clean rows for dashboards, spreadsheets, scheduled updates, reporting workflows, or downstream data pipelines.

Why use German Football Results & Tables?

Use this actor when you need German football data in a consistent dataset instead of manually checking separate competition pages. You can select several competitions in one run, limit match output to a specific round or matchday, and return matches and current standings as two separate output tables.

Main capabilities:

• Retrieve matches, dates, teams, scores, status, and winners.
• Retrieve standings for league competitions with position, points, record, and goals.
• Compare men's and women's German football competitions in one normalized format.
• Schedule matchday runs on Apify and export data through the API.
• Append results into an existing Apify dataset with datasetId.
• Add your own workflow identifier with runId.

What data can it extract?

Field	Type	Description
leagueName	string	German competition name
competitionType	string	league or cup
competitionGender	string	men or women
season	number	Season start year
round	number	Matchday or cup round when available
matchDate	string	Match date in ISO 8601 format
homeTeam, awayTeam	string	Teams for match rows
homeScore, awayScore	number	Score when available
winner	string	home, away, draw, or empty
position, teamName, points	number/string	Standing row fields
played, won, drawn, lost	number	League record
goalsFor, goalsAgainst, goalDifference	number	League-table goal fields

Supported German competitions

The dropdown currently supports:

• Bundesliga
• 2. Bundesliga
• 3. Liga
• DFB-Pokal
• Frauen-Bundesliga
• 2. Frauen-Bundesliga

DFB-Pokal is a cup competition, so it returns match rows only. Standings apply to league competitions.

Use cases

• Build German football dashboards and matchday trackers.
• Keep a spreadsheet of Bundesliga and Frauen-Bundesliga results.
• Feed editorial tools with structured score and standings data.
• Compare men's and women's German domestic competitions.
• Schedule daily or matchday updates through Apify.
• Combine this dataset with your own club, attendance, betting, or media workflows where legally permitted.

How to use it

1. Open the actor input tab.
2. Choose one or more German competitions from the Competitions dropdown.
3. Set the season start year, for example 2025 for 2025/2026.
4. Optionally set Round to retrieve only one matchday or cup round.
5. Keep Include Matches enabled for fixtures and scores.
6. Keep Include Standings enabled when you want league tables.
7. Run the actor and download the Matches and Standings tables as JSON, CSV, Excel, XML, or HTML.

Input

See the input tab for full configuration options.

Example input:

{
  "leagues": ["bundesliga", "frauen-bundesliga"],
  "season": 2025,
  "round": 1,
  "includeMatches": true,
  "includeStandings": true,
  "maxMatches": 20
}

For scheduled matchday updates, set round and keep maxMatches low. For full-season match exports, leave round blank and raise maxMatches. Standings rows represent the current season table available for that competition, not a historical table for the selected round.

Output

The actor creates two output tables: Matches and Standings. You can download each dataset in various formats such as JSON, HTML, CSV, or Excel.

Example output:

[
  {
    "leagueName": "Bundesliga",
    "competitionType": "league",
    "competitionGender": "men",
    "season": 2025,
    "round": 1,
    "matchDate": "2025-08-22T18:30:00.000Z",
    "status": "finished",
    "homeTeam": "FC Bayern München",
    "awayTeam": "RB Leipzig",
    "homeScore": 6,
    "awayScore": 0,
    "winner": "home"
  },
  {
    "leagueName": "Bundesliga",
    "competitionType": "league",
    "competitionGender": "men",
    "season": 2025,
    "position": 1,
    "teamName": "FC Bayern München",
    "played": 31,
    "won": 26,
    "drawn": 4,
    "lost": 1,
    "goalsFor": 113,
    "goalsAgainst": 32,
    "goalDifference": 81,
    "points": 82
  }
]

API usage example

curl "https://api.apify.com/v2/acts/trovevault~german-football-results-tables/runs?waitForFinish=120" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "leagues": ["bundesliga", "2-bundesliga"],
    "season": 2025,
    "round": 1,
    "includeMatches": true,
    "includeStandings": true,
    "maxMatches": 20
  }'

Limitations

This actor covers German domestic competitions only. It does not include Champions League, Europa League, national-team fixtures, non-German leagues, or player-level scorer feeds.

The underlying data is community-maintained, so coverage can vary by competition, season, and timing. Recent high-quality German competitions are the best fit. Cup competitions do not produce standings.

FAQ

Does this actor include Champions League?

No. The scope is German domestic football only.

Can I select multiple leagues?

Yes. The Competitions field is a multi-select dropdown.

Does DFB-Pokal return standings?

No. DFB-Pokal is a cup competition, so it returns matches only.

Which season format should I use?

Use the season start year. For example, 2025 means the 2025/2026 season for most competitions.

Can I get only one round?

Yes. Set Round to a matchday or cup round number.

Does the actor include scorers?

No. This actor is standardized around match results and standings only.

Is the output suitable for spreadsheets?

Yes. Matches and standings are separate flat tables that export cleanly to CSV or Excel.

Can I append results to an existing dataset?

Yes. Fill datasetId to append rows to another Apify dataset in addition to the default run datasets. When both matches and standings are appended to this external dataset, the actor adds entityType so downstream workflows can distinguish match and standing rows.

Troubleshooting

If a run returns fewer rows than expected, check the selected season and round first. Some competitions may not have data for every historical season, and cup round numbering can differ from league matchdays. If standings do not match the selected round, that is expected: tables are current season standings.

If standings are missing for DFB-Pokal, that is expected because cups do not have league tables.

For bugs, missing competitions, or output issues, use the Issues tab on the actor page.

Related actors

You may also want actors for football analytics, sports monitoring, or other TroveVault sports datasets as they become available.

Changelog

0.1

Initial version with German domestic football matches and league tables.