Docs menu
Flashscore API endpoint
Flashscore match head-to-head API
Returns Flashscore's public head-to-head and recent-results 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-h2hEndpoint facts
- Method
- GET
- API path
- /flashscore/match-h2h
- 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 head-to-head and recent-results feed as text under data. It may contain previous match IDs, teams, competitions, dates, scores, and result metadata; available fields depend on the match.
Live monitoring
- Monitored request
- GET /flashscore/match-h2h?id=xtmHKGT0
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 1.60 s
Sampled response
- Request, 14 Oct 2026
- GET /flashscore/match-h2h?id=xtmHKGT0
- Fields returned with a value
- 1
| Field | In the sample | Value in the sample |
|---|---|---|
| data | Has a value | 75,233 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-h2h?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_hh_2_xtmHKGT0",
"data": "SA÷1¬~KA÷Overall¬IS÷¬~KB÷Last matches: Arsenal¬~KC÷1789826400¬KP÷j52jHsN8¬KF÷Premier League¬AC÷3¬KG÷198¬KH÷England¬KI÷PL¬~"
}
}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-h2h?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