Docs menu
Flashscore API endpoint
Flashscore ranking categories API
Lists the Flashscore ranking categories currently available, including the tennis live-rankings pages. Each category has its `key`, name, sport, page path and a `live` flag. Use a `key` with the Flashscore rankings endpoint. It takes no parameters.
GETapiKey1 credit/requestFlashscoreflashscore.rankingCategoriesResponseDoc
Flashscore/flashscore/ranking-categoriesEndpoint facts
- Method
- GET
- API path
- /flashscore/ranking-categories
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Flashscore
- Response schema
- #/definitions/flashscore.rankingCategoriesResponseDoc
How this endpoint behaves
Query parameters: none.
Returns the exact currently verified public rankings catalog, including standard rankings and the eight tennis live-rankings pages. Each record includes its key, display name, sport, and upstream page path. Use the key with /api/v1/flashscore/rankings.
Live monitoring
- Monitored request
- GET /flashscore/ranking-categories
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 0.07 s
Sampled response
- Request, 14 Oct 2026
- GET /flashscore/ranking-categories
- Items in categories
- 35
- Fields filled in every checked item
- 4
- Fields empty in some or all items
- 1
| Field | Filled in, of 35 checked | Values in the sample |
|---|---|---|
| key | 35 | |
| name | 35 | “FIFA World Ranking” and 34 other values |
| sport | 35 | tennis (16), golf (11), badminton (5) and 3 more |
| path | 35 | “/football/rankings/fifa/” and 34 other values |
| live | 8 | true in 8 of 8 |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/flashscore/ranking-categories" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://www.flashscore.com/",
"categories": [
{
"key": "tennis-atp",
"name": "ATP Singles",
"sport": "tennis",
"path": "/tennis/rankings/atp/"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/flashscore.rankingCategoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | flashscore.rankingCategoriesDataDoc | No | ||||
| data.categories | array | No | rankingCategoryDoc record, 5 fields: key, live, name, path, sport. Described under Flashscore rankings API. | |||
| data.source_url | string | No | https://www.flashscore.com/ | |||
| msg | string | No | OK |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 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/ranking-categories" \
-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