fussballdaten.de APIfussballdaten.de ↗
Access soccer match schedules, scores, and team data from fussballdaten.de. Covers Bundesliga, Premier League, La Liga, Champions League, and more.
curl -X GET 'https://api.parse.bot/scraper/8b3591cb-cd83-4dfe-8492-35c438b61d6e/get_matches_by_date?date=2026-05-14&filter=topligen' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all soccer matches for a specific date. Returns matches across all competitions including Bundesliga, 2. Bundesliga, Premier League, La Liga, Serie A, Champions League, etc. Can filter to specific league groups.
| Param | Type | Description |
|---|---|---|
| date | string | Date in YYYY-MM-DD format. When omitted, returns today's matches. |
| filter | string | Filter matches by league group. Accepted values: 'all' (everything), 'deutsch' (all German leagues incl. Regionalliga), 'topligen' (top European leagues: Bundesliga, Premier League, La Liga, Serie A, Ligue 1, Süper Lig), 'uefa' (UEFA competitions), 'nichtuefa' (non-UEFA). |
{
"type": "object",
"fields": {
"date": "string - The date queried in YYYY-MM-DD format",
"filter": "string - Filter applied",
"matches": "array of match objects with date, competition, home_team, away_team, kick_off_time (upcoming), score and half_time_score (completed), match_url, match_id, home_rank, away_rank",
"total_matches": "integer - Total number of matches returned"
},
"sample": {
"data": {
"date": "2026-05-14",
"filter": "topligen",
"matches": [
{
"date": "2026-05-14",
"match_id": "840110",
"away_rank": 10,
"away_team": "Vallecano",
"home_rank": 12,
"home_team": "Valencia",
"match_url": "https://www.fussballdaten.de/spanien/2026/36/valencia-vallecano/",
"competition": "Spanien, Primera División, 36. Spieltag",
"kick_off_time": "19:00"
}
],
"total_matches": 3
},
"status": "success"
}
}About the fussballdaten.de API
The fussballdaten.de API exposes 4 endpoints for retrieving soccer match data across German and European competitions. Use get_matches_by_date to pull all fixtures and scores for any calendar date, get_upcoming_matches to scan ahead up to 60 days with optional team filtering, get_team_schedule for a club's full-season results and fixtures, and search_teams to resolve team slugs. Response objects include kick-off times, half-time scores, competition names, league group filters, and team rankings.
Match Data by Date and Lookahead
get_matches_by_date accepts a date parameter in YYYY-MM-DD format and an optional filter parameter (all, deutsch, topligen, etc.) to narrow results to a league group. Each match object in the response carries home_team, away_team, competition, kick_off_time for upcoming matches, and score plus half_time_score for completed ones. Omitting date returns today's fixtures. The total_matches integer tells you how many records came back without counting the array manually.
get_upcoming_matches lets you look ahead from today by setting days (up to 60). Pass a comma-separated teams string to scope results to specific clubs using case-insensitive partial matching — for example, 'Bayern,Dortmund' — useful when you only care about a handful of sides across all competitions. The response includes home_rank and away_rank fields alongside match_url and match_id, which link directly to the source detail page.
Team Schedule and Club Discovery
get_team_schedule returns a full-season view for one club across all competitions — league, cup, and continental. It requires a team_slug such as fc-bayern-muenchen or borussia-dortmund. Past matches include scores; future matches include kick-off times. The venue field marks each fixture as home or away. Use search_teams first to find valid slugs: pass a query string for a partial-match search, or omit it to list all available teams. Each result includes name, slug, url, and optionally country.
- Build a Bundesliga match calendar that surfaces kick-off times and half-time scores for each matchday.
- Set up fixture alerts for specific clubs by filtering
get_upcoming_matcheswith a team name list. - Aggregate weekly fixtures across Champions League and Europa League for a multi-competition dashboard.
- Track a team's home-versus-away record using the
venuefield inget_team_scheduleresponses. - Populate a fantasy football app with upcoming fixtures and results for top European leagues.
- Cross-reference
home_rankandaway_rankdata from upcoming matches to build form-based previews.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does fussballdaten.de offer an official public developer API?+
What does the `filter` parameter in `get_matches_by_date` actually control?+
deutsch returns German leagues including Bundesliga, 2. Bundesliga, 3. Liga, and Regionalliga. topligen returns top European competitions. all returns everything. Omitting it defaults to all matches for the given date.Does the API return live in-match scores or only pre-match and full-time data?+
score plus half_time_score for completed ones. Live in-progress scores are not currently distinguished as a separate state in the response. You can fork this API on Parse and revise it to add a live-match polling endpoint.