# Flashscore (Germany) — 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.

> Get match listings, match details and statistics, team rosters, and a German-language sports news feed from Flashscore.de, plus lineup data with player rating fields when available.

**Category:** Sports | **Website:** [flashscore.de/](https://flashscore.de/) | **Docs:** [parse.bot/marketplace/a3308382-c1e8-4374-a378-576f1f7ec7be/flashscore-de-api](https://parse.bot/marketplace/a3308382-c1e8-4374-a378-576f1f7ec7be/flashscore-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-flashscore-de-api-a3308382/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_match_detail

Retrieve detailed information for a specific match including team image references, participant IDs, and league table data. Returns key-value pairs parsed from the match detail feed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | The match/event ID (alphanumeric, e.g. 'xrichL03'). Obtain from get_matches results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-de-api-a3308382/get_match_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_match_lineups

Retrieve lineups with individual player ratings for a completed football match via the GraphQL endpoint. Returns player data including names, shirt numbers, positional side, and numeric ratings. For future or non-football matches the players array is empty and average ratings are null.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | The match/event ID (alphanumeric, e.g. 'xrichL03'). Obtain from get_matches results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-de-api-a3308382/get_match_lineups \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_match_statistics

Retrieve match statistics (xG, possession, shots, corners, fouls, passes, cards, etc.) organized by named sections with home/away values. Returns structured statistics for completed matches. For future matches the sections array is empty.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | The match/event ID (alphanumeric, e.g. 'xrichL03'). Obtain from get_matches results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-de-api-a3308382/get_match_statistics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_matches

Retrieve match listings for a given sport and country. Returns parsed match sections including league headers and individual match entries with event IDs, team names, and start times. Pagination is not supported; one page of current/upcoming matches is returned. Default scope is all football worldwide.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | integer | No | Country ID. 0 returns matches from all countries. |
| `date` | string | No | Date/locale string for the feed. Use 'de_1' for today's German-locale feed. |
| `sport` | integer | No | Sport ID: 1=football, 2=tennis, 3=basketball. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-de-api-a3308382/get_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<integer>","date":"<string>","sport":"<integer>"}'
```

### get_news

Retrieve the football news feed from flashscore.de. Returns structured article data organized into named sections (e.g. Fußball, WM 2026, Champions League) with titles, timestamps, image URLs, and article types. Hardcoded to Soccer/Fußball news for the German locale.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-de-api-a3308382/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_player_ratings_for_matches

Retrieve player ratings for multiple matches in one call. Calls the lineups endpoint for each provided event ID and aggregates results into a single response with per-match player arrays.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_ids` | string | Yes | Comma-separated list of match/event IDs (e.g. 'xrichL03,QeX6IHJ8'). Obtain event IDs from get_matches results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-de-api-a3308382/get_player_ratings_for_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_ids":"<string>"}'
```

### get_team_roster

Retrieve the full team roster with player statistics (goals, assists, cards, minutes played) by parsing the team page on flashscore.de. Requires team_id and team_slug from the flashscore.de team page URL pattern: /team/{team_slug}/{team_id}/team/. Returns stale_input for invalid combinations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_id` | string | Yes | The team ID (alphanumeric, e.g. '4jcj2zMd' for Bayer Leverkusen). |
| `team_slug` | string | Yes | URL-friendly team name slug (e.g. 'bayer-leverkusen'). Found in the team page URL on flashscore.de. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-de-api-a3308382/get_team_roster \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_id":"<string>","team_slug":"<string>"}'
```