# Fussballdaten — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Find live soccer match schedules, scores, and team information across German leagues and Europe's top competitions, with the ability to filter by date, team, or league. Quickly look up upcoming fixtures, past results, and complete team schedules for Bundesliga, Premier League, La Liga, Serie A, Ligue 1, Champions League, and more.

**Category:** Sports | **Website:** [fussballdaten.de/](https://fussballdaten.de/) | **Docs:** [parse.bot/marketplace/89e36209-8c5b-446e-862f-f69567bd8c2a/fussballdaten-de-api](https://parse.bot/marketplace/89e36209-8c5b-446e-862f-f69567bd8c2a/fussballdaten-de-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-fussballdaten-de-api-89e36209/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_matches_by_date

Retrieve all soccer matches scheduled for a specific date across all tracked competitions. Returns match details including teams, scores (for completed matches), kick-off times (for upcoming), and competition context. Supports filtering by league group. When no date is provided, returns today's matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYY-MM-DD format. When omitted, returns today's matches. |
| `filter` | string | No | Filter matches by league group. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fussballdaten-de-api-89e36209/get_matches_by_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","filter":"<string>"}'
```

### get_team_schedule

Retrieve the full season schedule for a specific team across all competitions (league, cup, Champions League, etc.). Shows both past results (with scores and outcome) and upcoming matches (with kick-off times). Use search_teams to discover valid team slugs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_slug` | string | Yes | Team URL slug from search_teams endpoint. Examples: 'fc-bayern-muenchen', 'borussia-dortmund', 'hamburger-sv'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fussballdaten-de-api-89e36209/get_team_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_slug":"<string>"}'
```

### get_upcoming_matches

Collect upcoming matches over the next N days (up to 60). Iterates through daily calendar pages and aggregates results. Supports league-group filtering and team-name filtering (case-insensitive partial match). Each day is a separate page fetch, so larger day ranges are slower.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `days` | integer | No | Number of days to look ahead from today (max 60). |
| `filter` | string | No | Filter matches by league group. |
| `teams` | string | No | Comma-separated team names to filter (case-insensitive partial match). Example: 'Bayern,Dortmund,Chelsea,Real Madrid'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fussballdaten-de-api-89e36209/get_upcoming_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"days":"<integer>","filter":"<string>","teams":"<string>"}'
```

### search_teams

Browse and search for teams on fussballdaten.de to find their URL slugs. Lists Bundesliga teams and top international clubs available on the site. Use the returned slug with get_team_schedule to retrieve a team's full season schedule.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search term to filter teams (case-insensitive partial match on name or slug). When omitted, lists all available teams. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fussballdaten-de-api-89e36209/search_teams \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```