Docs menu
LiveScore API endpoint
LiveScore competition directory API
Returns English competition pages listed in LiveScore's public competition sitemaps plus competition-shaped pages listed in the English cricket sport sitemap. The sitemap index has dedicated competition sitemaps for soccer, hockey, basketball, and tennis; cricket discovery remains partial and dynamic.
GETapiKey3 credits/requestLiveScorelivescore.responseDoc
LiveScore/livescore/competitionsEndpoint facts
- Method
- GET
- API path
- /livescore/competitions
- Auth
- apiKey
- Credits
- 3 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- LiveScore
- Execution
- Managed browser rendering where the target needs it
- Response schema
- #/definitions/livescore.responseDoc
How this endpoint behaves
No parameters.
Returns English competition page paths from LiveScore's public competition sitemaps plus competition-shaped pages listed in the English cricket sport sitemap. Pass a returned path to /api/v1/livescore/competition. The index has dedicated competition sitemaps for soccer (site slug football), hockey, basketball, and tennis. The cricket sport sitemap currently contributes The Ashes stage page; this is partial coverage, not a complete cricket competition or historical directory. The list changes over time.
Sampled response
- Request, 14 Oct 2026
- GET /livescore/competitions
- Items in data.competitions
- 671
- Fields filled in every checked item
- 0
- Fields empty in some or all items
- 3
| Field | Filled in, of 671 checked | Values in the sample |
|---|---|---|
| sport | 500 | soccer (499), cricket (1) |
| path | 500 | “cricket/test-series/the-ashes-2025” and 499 other values |
| url | 500 | livescore.com |
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/livescore/competitions" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"data": {
"source_url": "https://www.livescore.com/sitemap.xml",
"data": {
"count": 3,
"competitions": [
{
"sport": "soccer",
"path": "football/england/premier-league",
"url": "https://www.livescore.com/en/football/england/premier-league/",
"last_modified": "2026-09-26"
},
{
"sport": "tennis",
"path": "tennis/wimbledon/wimbledon-2026",
"url": "https://www.livescore.com/en/tennis/wimbledon/wimbledon-2026/"
},
{
"sport": "cricket",
"path": "cricket/test-series/the-ashes-2025",
"url": "https://www.livescore.com/en/cricket/test-series/the-ashes-2025/"
}
]
}
}
}Request schema
No body schema
Response schema
#/definitions/livescore.responseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | livescore.sourceDataDoc | No | ||||
| data.data | object | No | ||||
| data.source_url | string | No | https://www.livescore.com/en/football/uefa-nations-league/league-b-group-3/austria-vs-israel/1738267/ | |||
| 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/livescore/competitions" \
-H "x-api-key: $CRAWLORA_API_KEY"Shared guides
Related
More LiveScore endpoint docsLiveScore Scraper APILiveScore Competition API documentationLiveScore live scores by sport API documentationLiveScore match statistics API documentationLiveScore match details API documentationLiveScore news article API documentationLiveScore news categories API documentation