# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/flashscore-germany/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/flashscore-germany/get-match-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/flashscore-germany/get-match-lineups \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/flashscore-germany/get-match-statistics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/flashscore-germany/get-matches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/flashscore-germany/get-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/flashscore-germany/get-player-ratings-for-matches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/flashscore-germany/get-team-roster \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"team_id":"<string>","team_slug":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.