Flashscore API endpoint
Returns the TV channels and streaming services listed for a match in one viewer market, with provider ids, names and website links. Listings are country specific, so pick geo from flashscore-odds-geos; an empty list means no broadcaster is listed for that market. Bookmaker promotions are not included.
/flashscore/match-tvQuery parameters:
id (required): eight-character match id from a Flashscore match URL, for example p0aFxkkn.geo (optional, default GB): viewer market country code. One of AE, AL, AM, AO, AR, AT, AU, AZ, BA, BD, BE, BG, BO, BR, BY, CA, CH, CI, CL, CM, CN, CO, CR, CY, CZ, DE, DK, DO, DZ, EC, EE, EG, ES, ET, FI, FR, GB, GE, GH, GR, GT, HK, HN, HR, HU, ID, IE, IL, IN, IQ, IR, IS, IT, JO, JP, KE, KG, KH, KR, KW, KZ, LA, LB, LK, LT, LU, LV, LY, MA, MD, ME, MK, MM, MN, MT, MX, MY, NG, NI, NL, NO, NP, NZ, PA, PE, PH, PK, PL, PT, PY, QA, RO, RS, RU, SA, SD, SE, SG, SI, SK, SN, SV, TH, TN, TR, TW, TZ, UA, UG, US, UY, UZ, VE, VN, XK, ZA, ZM, ZW. These are the same codes returned by /api/v1/flashscore/odds-geos; letter case is ignored.Returns the TV channels and streaming services Flashscore lists for the match in the chosen market as broadcasters, each with the provider id, name (usually carrying a country suffix such as (Gbr)) and website url when one is given. Listings are country specific, so the market is always sent explicitly rather than inferred. An empty broadcasters list means none is listed for that market; this is a valid answer. Entries the provider flags as affiliate links are returned with affiliate set to true and no url (the tracking link is dropped). Bookmaker promotions that share the same source are not returned. For the global, unstructured broadcaster text see /api/v1/flashscore/match-info. An unknown match id returns 404.
| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| id | 2 | |
| name | 2 | “HBO Max (Gbr)” and 1 other value |
| url | 2 | hbomax.com and 1 other host |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | Yes | Eight-character Flashscore match id | p0aFxkkn | |
| geo | string | No | GB | Viewer market country code from flashscore-odds-geos; defaults to GB Allowed values: AE, AL, AM, AO, AR, AT, AU, AZ, BA, BD, BE, BG, BO, BR, BY, CA, CH, CI, CL, CM, CN, CO, CR, CY, CZ, DE, DK, DO, DZ, EC, EE, EG, ES, ET, FI, FR, GB, GE, GH, GR, GT, HK, HN, HR, HU, ID, IE, IL, IN, IQ, IR, IS, IT, JO, JP, KE, KG, KH, KR, KW, KZ, LA, LB, LK, LT, LU, LV, LY, MA, MD, ME, MK, MM, MN, MT, MX, MY, NG, NI, NL, NO, NP, NZ, PA, PE, PH, PK, PL, PT, PY, QA, RO, RS, RU, SA, SD, SE, SG, SI, SK, SN, SV, TH, TN, TR, TW, TZ, UA, UG, US, UY, UZ, VE, VN, XK, ZA, ZM, ZW. | GB |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-tv?id=p0aFxkkn&geo=AE" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://global.flashscore.ninja/2/x/feed/df_dos_1_p0aFxkkn_",
"match_id": "p0aFxkkn",
"geo": "GB",
"broadcasters": [
{
"id": 6901,
"name": "NOW TV (Gbr)",
"url": "https://www.nowtv.com/"
},
{
"id": 680,
"name": "Sky Sports Premier League (Gbr)",
"url": "http://www.skysports.com/"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/flashscore.matchTVResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | flashscore.matchTVDataDoc | No | ||||
| data.broadcasters | array | No | ||||
| data.broadcasters[].affiliate | boolean | No | false | Affiliate marks entries the provider flags as affiliate links; their tracking URL is omitted. | ||
| data.broadcasters[].id | integer | No | 680 | |||
| data.broadcasters[].name | string | No | Sky Sports Premier League (Gbr) | |||
| data.broadcasters[].url | string | No | http://www.skysports.com/ | |||
| data.geo | string | No | GB | |||
| data.match_id | string | No | p0aFxkkn | |||
| data.source_url | string | No | https://global.flashscore.ninja/2/x/feed/df_dos_1_p0aFxkkn_ | |||
| 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/match-tv?id=p0aFxkkn&geo=AE" \
-H "x-api-key: $CRAWLORA_API_KEY"