GET/fussballde/amateur-statsapiKey1 credit/request
Returns a page of one of the ten Top-Amateurstatistiken rankings (Kreisklasse to Regionalliga, championship matches): top teams by goals, goal ratio, goals against and points average, highest-scoring matches, biggest draws, and top scorers by goals, ratio and goals in one match per week or season. Filter by season, team type and federation and page with `limit` and `offset`. A ranking is bounded to roughly its top 200 entries; `final` marks the last page.
Required: stat (10 allowed values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10). Optional: season, team_type (8 allowed values: 1, 3, 6, 8, 4, 5, 7, 9), federation_id (22 allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35), limit, offset.
Open in Playground
GET/fussballde/club-matchesapiKey2 credits/request
Returns the fixtures and results across all of a club's teams (senior and youth). `all` (default) is the club match plan for a date window (default the current season) optionally for one competition kind and paged with `limit` and `offset`; `next` is the next fixtures and `previous` the latest results. Each match names its competition and team type.
Required: club_id. Optional: kind (3 allowed values: all, next, previous), date_from, date_to, competition_kind (9 allowed values: 1, 8, 3, 7, 6, 11, 2, 21, 9), limit, offset.
Open in Playground
GET/fussballde/club-searchapiKey2 credits/request
Searches FUSSBALL.DE clubs by club name, postcode or place, or both (both must match), and returns each club's id, name, postal code, city and logo. The first page reports the `total` hit count; page with `limit` (1 to 100, default 20) and `offset`, and `final` marks the last page. Zero results is a valid response.
Optional: text, place, limit, offset.
Open in Playground
GET/fussballde/clubapiKey2 credits/request
Returns one club: name, federation, team counts, profile facts (founding year, address, website) and the club's teams with their competitions and team type. Teams are those of the current season; set `season` for an earlier one and `competition_kind` to keep only teams in championships, cups, friendlies and so on. Club ids appear as `club_id` on teams and matches.
Required: club_id. Optional: season, competition_kind (9 allowed values: 1, 8, 3, 7, 6, 11, 2, 21, 9).
Open in Playground
GET/fussballde/competition-optionsapiKey1 credit/request
Returns the team types (Herren, Frauen, A-Junioren, ...), the leagues (Spielklassen) of each team type and the areas (Gebiete) of each league for one federation, season and competition type. Team type, league and area ids are federation-specific, so take them from this response and pass them to `fussballde-competitions`.
Required: federation_id (22 allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35), season. Optional: competition_type (11 allowed values: 1, 308, 300, 70, 305, -300, -305, 11, 2, -2, 12).
Open in Playground
GET/fussballde/competitionsapiKey1 credit/request
Returns the competitions (Staffeln) at one selector path: a federation, season, competition type, team type, league and area. Each competition `id` (for example `031BFREJC800001BVS5489BUVUR5FS5A-G` for the 2026/27 Bundesliga) is the key used by the matchday, match plan, table and top-scorer endpoints. An empty list is a valid result for a path with no competitions.
Required: federation_id (22 allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35), season, team_type, league, area. Optional: competition_type (11 allowed values: 1, 308, 300, 70, 305, -300, -305, 11, 2, -2, 12).
Open in Playground
GET/fussballde/federationapiKey1 credit/request
Returns the profile of one of the 22 federations (the DFB and the regional and state associations) or of one of the five regional associations (Norddeutscher, Nordostdeutscher, Süddeutscher, Südwest and Westdeutscher): name, address, website, president, club, member and team counts, and the latest news items. Provide exactly one of `federation_id` and `regional_association`.
Optional: federation_id (22 allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35), regional_association (5 allowed values: nord, nordost, sued, suedwest, west).
Open in Playground
GET/fussballde/filtersapiKey1 credit/request
Returns the competition selector base data of FUSSBALL.DE, the German amateur-football portal: the 22 federations (DFB plus regional associations), the available seasons per federation, and the competition types per federation and season. Use it first to get valid `federation_id`, `season` and `competition_type` values for the competition discovery endpoints.
Optional: federation_id (22 allowed values: 89, 32, 31, 66, 61, 02, 03, 34, 62, 23, 22, 01, 41, 43, 63, 64, 04, 33, 42, 65, 21, 35).
Open in Playground
GET/fussballde/match-calendarapiKey1 credit/request
Returns the matches FUSSBALL.DE's Matchkalender lists around a five-digit postcode within a date range (default today plus six days, at most 92 days), optionally filtered by team types and competition kind. Each match includes its team type (for example D-Junioren) and league. The upstream returns at most 10 matches per request and has no paging: `truncated` is true when the page is full, so narrow the dates or filters to see the rest. Zero matches is a valid response.
Required: postal_code. Optional: date_from, date_to, team_types, competition_kind (9 allowed values: 1, 8, 3, 7, 6, 11, 2, 21, 9).
Open in Playground
GET/fussballde/match-comparisonapiKey1 credit/request
Returns a pre-match comparison for one match: `history` is the all-time head-to-head record (duels, wins, draws, defeats, goals), `meetings` lists the other fixtures and results between the two teams, and `season` compares both teams' current standing, points, goals, form, top scorer and cards.
Required: match_id. Optional: view (3 allowed values: history, meetings, season).
Open in Playground
GET/fussballde/match-planapiKey3 credits/request
Returns every match of a competition's season (fixtures and results), including the earliest matchdays, optionally filtered to one team and a date window; the date window is applied by the site, so a narrow window is cheaper than filtering a full season. Use it for a complete schedule; use `fussballde-matchday` for one matchday.
Required: competition_id. Optional: team_id, date_from, date_to.
Open in Playground
GET/fussballde/matchapiKey1 credit/request
Returns one match: teams, competition, date, kick-off time, venue, score and half-time score, match number and matchday, officials, goals with minutes and timeline events such as substitutions. Fields the match has not published (for example a future match's score) are omitted.
Required: match_id.
Open in Playground
GET/fussballde/matchdayapiKey1 credit/request
Returns the matches of a competition's current matchday, of a numbered matchday (`matchday`, 1 to the competition's matchday count, reported as `matchday_count`) or of the matchday around a date. Each match has teams, date, kick-off time, score and status (`finished`, `scheduled` or `other` with a note). Cups and tournaments have no numbered matchdays. Dates, times and scores are decoded from the site's obfuscated glyph fonts.
Required: competition_id. Optional: date, matchday.
Open in Playground
GET/fussballde/national-top-scorersapiKey1 credit/request
Returns the top 10 scorers of every league level across Germany for men or women (the site's Torjägerkanone), with goals, matches played and club. Only championship matches count and the upstream refreshes the ranking once a day; the response `note` carries its last-update time. Adult teams only.
Optional: team_type (2 allowed values: men, women).
Open in Playground
GET/fussballde/news-articleapiKey1 credit/request
Returns one FUSSBALL.DE news article: title, category, publication date and time, lead image and caption, and the body paragraphs as plain text.
Required: article_id.
Open in Playground
GET/fussballde/news-searchapiKey2 credits/request
Searches FUSSBALL.DE editorial news (`news`) or the Profi-Newsflash (`pro_news`) by keyword and returns teasers with title, category, date and excerpt. The first page (offset 0) also reports the total hit count; page with `limit` (1 to 50) and `offset`. No hits is a valid empty result.
Required: q. Optional: channel (2 allowed values: news, pro_news), limit, offset.
Open in Playground
GET/fussballde/newsapiKey1 credit/request
Returns news teasers of one FUSSBALL.DE stream (all news, magazine, Regionalliga, federations, service, campaigns or help center) with title, category, publication date and time, and excerpt, paged with `limit` (1 to 50, default 10) and `offset`; `final` is true on the last page. Use `regional_league` or `help_category` to narrow the Regionalliga and help-center streams to one league or category. Use the article id with `fussballde-news-article` for the full text.
Optional: stream (7 allowed values: all_news, magazin, regionalliga, verbaende, service, aktionen, helpcenter), regional_league (5 allowed values: nord, nordost, west, suedwest, bayern), help_category (8 allowed values: allgemeines, app, liveticker, mannschaftsseite, profile, registrierung, training_service, widgets), limit, offset.
Open in Playground
GET/fussballde/player-matchesapiKey1 credit/request
Returns a registered player's matches for one season and team: date, teams, result and per match the goals, the minute they were substituted in or out, and minutes played. Also lists the player's teams and competitions for the season so another team can be selected with `team_id`. Basic profiles without registration have no match data.
Required: player_id. Optional: season, team_id.
Open in Playground
GET/fussballde/player-searchapiKey2 credits/request
Searches players registered on FUSSBALL.DE by first and/or last name, optionally narrowed by postcode or place, and returns each player's id, name, birth date, team and team type. The first page reports the `total` hit count; page with `limit` (1 to 100, default 20) and `offset`, and `final` marks the last page. At least one of `first_name` and `last_name` is required. No match is a valid empty result.
Optional: first_name, last_name, place, limit, offset.
Open in Playground
GET/fussballde/playerapiKey1 credit/request
Returns a player's public profile: name, team, team type, birth date and, for registered players (`profile_type` full), the current-season statistics such as appearances, minutes played, goals, goals against and cards. Players without a registered profile (`profile_type` basic) only have name, team and team type. Player ids come from `fussballde-player-search`, scorer lists, squads and amateur statistics.
Required: player_id.
Open in Playground
GET/fussballde/position-historyapiKey1 credit/request
Returns every team's table position after each played matchday of a competition (the site's Fieberkurve), as one ordered list of positions per team. Position 1 is the leader; the list index is the matchday.
Required: competition_id.
Open in Playground
GET/fussballde/postal-codesapiKey1 credit/request
Returns the German postcodes (with city and district) that FUSSBALL.DE's own location search suggests for a place name or postcode prefix. Use it to turn a place such as Dortmund into the five-digit `postal_code` that `fussballde-match-calendar` requires. No match is a valid empty list.
Required: q.
Open in Playground
GET/fussballde/tableapiKey1 credit/request
Returns a competition's standings in one view: `overall`, `home_away` (home and away tables), `rounds` (first and second half-season tables), `fairness` (fair-play table) or `cross` (cross table of results between every pair of teams). Set `matchday` to get the standings as they were after that matchday (not available for `fairness`). Rows carry position, team, played, won, drawn, lost, goals and points where the view has them, plus the raw cells.
Required: competition_id. Optional: view (5 allowed values: overall, home_away, rounds, fairness, cross), matchday.
Open in Playground
GET/fussballde/team-matchesapiKey2 credits/request
Returns a team's matches across its competitions. `all` (default) is the match plan for a date window (default the current season, 1 July to 30 June), optionally for one competition kind and paged with `limit` and `offset`; `next` is the next 10 fixtures, `previous` the latest 10 results, and `wins`, `draws` and `losses` the latest 10 finished matches with that outcome.
Required: team_id. Optional: kind (6 allowed values: all, next, previous, wins, draws, losses), date_from, date_to, competition_kind (9 allowed values: 1, 8, 3, 7, 6, 11, 2, 21, 9), limit, offset.
Open in Playground
GET/fussballde/team-squadapiKey1 credit/request
Returns a team's players for a season: the `squad` (appearances, minutes, goals), `arrivals` or `departures` with the columns the site publishes for each. Player names come in the site's `Surname, Forename` order.
Required: team_id. Optional: season, kind (3 allowed values: squad, arrivals, departures).
Open in Playground
GET/fussballde/teamapiKey1 credit/request
Returns one team page: name, team type, federation, standing summary (competition, table position, points, goal ratio), current competitions, home venues, the club profile (founding year, address, contact) and the team's season-by-season history with final placings and the highest league reached. Use `fussballde-team-matches` and `fussballde-team-squad` for fixtures and players.
Required: team_id.
Open in Playground
GET/fussballde/top-scorersapiKey2 credits/request
Returns a page of a competition's top-scorer list with position, player, team and goals; page through it with `limit` (1 to 100, default 30) and `offset`. Tied scorers share a position. A competition without recorded scorers returns an empty list.
Required: competition_id. Optional: limit, offset.
Open in Playground