Flashscore API endpoint
Lists the seasons and winners (both players for doubles) from a public competition archive page. Discover archive paths through flashscore-navigation or flashscore-competitions. Each returned results_path and fixtures_path can be passed to flashscore-tournament-events to retrieve season event feeds.
/flashscore/tournament-seasonsParameters:
path (required): a relative public Flashscore competition archive path ending in /archive/. Obtain competition paths from /api/v1/flashscore/navigation, /api/v1/flashscore/competitions, or /api/v1/flashscore/search.Notable response behavior: returns every archived season with its label, winners, and ready-to-use results_path and fixtures_path values, newest first as listed upstream. The current season's path is the competition path without a year. winners lists every winner (two players for doubles); winner joins their names with /, and winner_path is set only when there is a single winner. Seasons not yet decided have no winner fields. The path is restricted to Flashscore navigation paths; no arbitrary host is fetched.
| Field | Filled in, of 56 checked | Values in the sample |
|---|---|---|
| name | 56 | “Champions League 2026/2027” and 55 other values |
| season | 56 | “2026/2027” and 55 other values |
| path | 56 | “/football/europe/champions-league/” and 55 other values |
| results_path | 56 | “/football/europe/champions-league/results/” and 55 other values |
| fixtures_path | 56 | “/football/europe/champions-league/fixtures/” and 55 other values |
| winner | 55 | “PSG” and 20 other values |
| winner_path | 55 | “/team/psg/CjhkPw0k/” and 20 other values |
| winners | 55 | median 1 entry |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| path | string | Yes | Relative Flashscore competition archive path ending in /archive/ | /football/europe/champions-league/archive/ | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/flashscore/tournament-seasons?path=%2Ffootball%2Feurope%2Fchampions-league%2Farchive%2F" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"source_url": "https://www.flashscore.com/football/europe/champions-league/archive/",
"path": "/football/europe/champions-league/archive/",
"seasons": [
{
"name": "Champions League 2026/2027",
"season": "2026/2027",
"path": "/football/europe/champions-league/",
"results_path": "/football/europe/champions-league/results/",
"fixtures_path": "/football/europe/champions-league/fixtures/"
},
{
"name": "Champions League 2025/2026",
"season": "2025/2026",
"path": "/football/europe/champions-league-2025-2026/",
"results_path": "/football/europe/champions-league-2025-2026/results/",
"fixtures_path": "/football/europe/champions-league-2025-2026/fixtures/",
"winner": "PSG",
"winner_path": "/team/psg/CjhkPw0k/",
"winners": [
{
"name": "PSG",
"path": "/team/psg/CjhkPw0k/"
}
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/flashscore.tournamentSeasonsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | flashscore.tournamentSeasonsDataDoc | No | ||||
| data.path | string | No | /football/europe/champions-league/archive/ | |||
| data.seasons | array | No | ||||
| data.seasons[].fixtures_path | string | No | /football/europe/champions-league-2025-2026/fixtures/ | |||
| data.seasons[].name | string | No | Champions League 2025/2026 | |||
| data.seasons[].path | string | No | /football/europe/champions-league-2025-2026/ | |||
| data.seasons[].results_path | string | No | /football/europe/champions-league-2025-2026/results/ | |||
| data.seasons[].season | string | No | 2025/2026 | |||
| data.seasons[].winner | string | No | PSG | Winner joins every winner's name with " / "; WinnerPath is set only for a single winner. | ||
| data.seasons[].winner_path | string | No | /team/psg/CjhkPw0k/ | |||
| data.seasons[].winners | array | No | ||||
| data.seasons[].winners[].name | string | No | PSG | |||
| data.seasons[].winners[].path | string | No | /team/psg/CjhkPw0k/ | |||
| data.source_url | string | No | https://www.flashscore.com/football/europe/champions-league/archive/ | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/flashscore/tournament-seasons?path=%2Ffootball%2Feurope%2Fchampions-league%2Farchive%2F" \
-H "x-api-key: $CRAWLORA_API_KEY"