Docs menu
Flashscore API endpoint
Flashscore rankings API
Returns the first-party ranking feed pages for a supported ranking category. When page one is full, page two is included to cover the remaining rows.
GETapiKey1 credit/requestFlashscoreflashscore.rankingResponseDoc
Flashscore/flashscore/rankingsEndpoint facts
- Method
- GET
- API path
- /flashscore/rankings
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- Flashscore
- Response schema
- #/definitions/flashscore.rankingResponseDoc
How this endpoint behaves
Query parameters:
category(required): one offifa,tennis-atp,tennis-wta,tennis-atp-race,tennis-wta-race,tennis-atp-doubles,tennis-wta-doubles,tennis-atp-doubles-race,tennis-wta-doubles-race,badminton-bwf-singles-men,badminton-bwf-singles-women,badminton-bwf-doubles-men,badminton-bwf-doubles-women,badminton-bwf-mixed-doubles,golf-owgr,golf-wwgr,golf-pga-fedexcup,golf-pga-money,golf-dp-world-tour,golf-lpga,golf-asian-tour,golf-japan-tour,golf-sunshine-tour,golf-korn-ferry,golf-champions-tour,darts-world-ranking,snooker-world-ranking,tennis-atp-live,tennis-wta-live,tennis-atp-race-live,tennis-wta-race-live,tennis-atp-doubles-live,tennis-wta-doubles-live,tennis-atp-doubles-race-live, ortennis-wta-doubles-race-live. These values are also returned by/api/v1/flashscore/ranking-categories.
The response preserves Flashscore's delimited feed text in pages. Page two is included when page one has 100 ranking rows; each page includes its row count and source URL.
Live monitoring
- Monitored request
- GET /flashscore/rankings?category=tennis-atp
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 4.00 s
Sampled response
- Request, 14 Oct 2026
- GET /flashscore/rankings?category=tennis-atp
- Items in pages
- 2
- Fields filled in every checked item
- 4
| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| page | 2 | |
| rows | 2 | 100 to 2,208, median 100 |
| feed_url | 2 | global.flashscore.ninja |
| data | 2 | median 20,487 characters |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| category | string | Yes | Ranking category from flashscore-ranking-categories Allowed values: fifa, tennis-atp, tennis-wta, tennis-atp-race, tennis-wta-race, tennis-atp-doubles, tennis-wta-doubles, tennis-atp-doubles-race, tennis-wta-doubles-race, badminton-bwf-singles-men, badminton-bwf-singles-women, badminton-bwf-doubles-men, badminton-bwf-doubles-women, badminton-bwf-mixed-doubles, golf-owgr, golf-wwgr, golf-pga-fedexcup, golf-pga-money, golf-dp-world-tour, golf-lpga, golf-asian-tour, golf-japan-tour, golf-sunshine-tour, golf-korn-ferry, golf-champions-tour, darts-world-ranking, snooker-world-ranking, tennis-atp-live, tennis-wta-live, tennis-atp-race-live, tennis-wta-race-live, tennis-atp-doubles-live, tennis-wta-doubles-live, tennis-atp-doubles-race-live, tennis-wta-doubles-race-live. | tennis-atp | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/flashscore/rankings?category=tennis-atp" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"category": {
"key": "tennis-atp",
"name": "ATP Singles",
"sport": "tennis",
"path": "/tennis/rankings/atp/"
},
"pages": [
{
"page": 1,
"rows": 100,
"feed_url": "https://global.flashscore.ninja/2/x/feed/ran_dSJr14Y8_1",
"data": "TS÷ME¬..."
}
]
}
}Request schema
No body schema
Response schema
#/definitions/flashscore.rankingResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | flashscore.rankingDataDoc | No | ||||
| data.category | flashscore.rankingCategoryDoc | No | ||||
| data.category.key | string | No | tennis-atp | |||
| data.category.live | boolean | No | false | |||
| data.category.name | string | No | ATP Singles | |||
| data.category.path | string | No | /tennis/rankings/atp/ | |||
| data.category.sport | string | No | tennis | |||
| data.pages | array | No | ||||
| data.pages[].data | string | No | TS÷ME¬TS÷TAB¬TE÷RW¬... | |||
| data.pages[].feed_url | string | No | https://global.flashscore.ninja/2/x/feed/ran_dSJr14Y8_1 | |||
| data.pages[].page | integer | No | 1 | |||
| data.pages[].rows | integer | No | 100 | |||
| data.source_url | string | No | https://www.flashscore.com/tennis/rankings/atp/ | |||
| 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/rankings?category=tennis-atp" \
-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