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

> Access football match results, fixtures, team histories, and in-match statistics from Flashscore. Look up matches by date, retrieve a team's recent and upcoming games, and pull detailed events and performance metrics for any match.

**Category:** Sports | **Website:** [flashscore.com.ua/](https://flashscore.com.ua/) | **Docs:** [parse.bot/marketplace/3bcdd130-1baa-4d05-a214-88deac9ea11f/flashscore-com-ua-api](https://parse.bot/marketplace/3bcdd130-1baa-4d05-a214-88deac9ea11f/flashscore-com-ua-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-com-ua-api-3bcdd130/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_football_results_by_date

Retrieve football match results and fixtures for a specific date across all competitions. Returns both completed matches with scores and upcoming scheduled matches. The date is calculated relative to today using an offset. A single request returns all matches for that day grouped by competition.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date_offset` | integer | No | Date offset from today (0=today, -1=yesterday, -2=two days ago, 1=tomorrow, etc.). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-com-ua-api-3bcdd130/get_football_results_by_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_offset":"<integer>"}'
```

### get_match_details

Retrieve match events/incidents (goals, cards, substitutions) for a specific match. Returns events for finished matches; scheduled or in-progress matches may return an empty events array. Each event includes the minute, player involved, event type, and running score.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Flashscore match identifier (alphanumeric, e.g. 'OvKeupeC'). Obtainable from get_football_results_by_date or get_team_results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-com-ua-api-3bcdd130/get_match_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<string>"}'
```

### get_match_statistics

Retrieve detailed in-match statistics for a match (possession, shots, corners, etc.). Not all matches have statistics available; matches without statistics return an empty statistics array. Statistics are grouped by period and category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Flashscore match identifier (alphanumeric, e.g. 'OvKeupeC'). Obtainable from get_football_results_by_date or get_team_results. |

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

### get_team_results

Retrieve recent and upcoming match results for a specific football team. Returns matches where the team participated. The country_id must match the team's actual country for results to appear. Each match includes competition context and scores for finished matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_id` | string | No | Country identifier matching the team's country. Obtainable from get_football_results_by_date results as country_id. |
| `team_id` | string | Yes | Flashscore team identifier (alphanumeric, e.g. 'M9UocgKt'). Obtainable from get_football_results_by_date results as home_team_id or away_team_id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-com-ua-api-3bcdd130/get_team_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_id":"<string>","team_id":"<string>"}'
```

### get_teams_with_consecutive_0_0_draws

Analyze a list of teams for consecutive 0:0 draws. For each team, fetches recent finished match results and checks whether the team has two or more consecutive 0:0 draws in their recent history. Returns analysis for each team including match counts and whether the pattern was found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_ids` | string | Yes | JSON array of team ID strings to check, e.g. '["M9UocgKt","jcQwCm5i"]'. Team IDs obtainable from get_football_results_by_date results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-flashscore-com-ua-api-3bcdd130/get_teams_with_consecutive_0_0_draws \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_ids":"<string>"}'
```