Docs menu
Flashscore API endpoint
Flashscore match statistics API
Returns Flashscore's public delimited statistics feed for a match id copied from a Flashscore match URL. The raw upstream feed is preserved as text because its format is not JSON.
GETapiKey1 credit/requestFlashscoreflashscore.responseDoc
Flashscore/flashscore/match-statsEndpoint facts
- Method
- GET
- API path
- /flashscore/match-stats
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Flashscore
- Response schema
- #/definitions/flashscore.responseDoc
How this endpoint behaves
Query parameters:
id(required): eight-character match id from a Flashscore match URL, for examplextmHKGT0.
Returns the raw delimited feed as text under data. Fields are separated by ¬, key/value pairs by ÷, and records by ~. The available statistics depend on the match and sport.
Errors:
404: Flashscore has no statistics for this match. It answers with an empty feed for a match that has not started or has no statistics coverage. This is not an outage and is not billed; do not retry in a tight loop, ask again later (statistics typically appear after kickoff).503: Flashscore could not be reached, or returned a response that is not a statistics feed (for example a challenge page). These are worth retrying with backoff.
Live monitoring
- Monitored request
- GET /flashscore/match-stats?id=xtmHKGT0
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 1.23 s
Sampled response
- Request, 14 Oct 2026
- GET /flashscore/match-stats?id=xtmHKGT0
- Fields returned with a value
- 1
| Field | In the sample | Value in the sample |
|---|---|---|
| data | Has a value | 5,039 characters |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | Yes | Eight-character Flashscore match id | xtmHKGT0 | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-stats?id=xtmHKGT0" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://global.flashscore.ninja/2/x/feed/df_st_2_xtmHKGT0",
"data": "SE÷Match¬~SF÷Top stats¬~SD÷432¬SG÷Expected goals (xG)¬SH÷0.00¬SI÷0.00¬~"
}
}Request schema
No body schema
Response schema
#/definitions/flashscore.responseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | flashscore.sourceDataDoc | No | ||||
| data.data | string | No | SE÷Match¬~SF÷Top stats¬~SD÷432¬SG÷Expected goals (xG)¬SH÷0.00¬SI÷0.00¬~ | |||
| data.source_url | string | No | https://global.flashscore.ninja/2/x/feed/df_st_2_xtmHKGT0 | |||
| msg | string | No | OK |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-stats?id=xtmHKGT0" \
-H "x-api-key: $CRAWLORA_API_KEY"Shared guides
Related
More Flashscore endpoint docsFlashscore scraping APIFlashscore calendar categories API documentationFlashscore season calendar API documentationFlashscore Competitions API documentationFlashscore Entity News API documentationFlashscore match box score API documentationFlashscore match darts API documentation