LiveScore API endpoint
Returns current live sections for a supported sport. Empty Sctns is a valid result when there are no live events. Use Nav and the final section Id for cursor paging.
/livescore/live-scoresQuery parameters:
sport (required): one of soccer, hockey, basketball, tennis, or cricket. Obtain the complete set from /api/v1/livescore/sports.timezone_offset (optional): UTC offset in whole hours from -12 through 14; defaults to 0.paging (optional): true requests a UI-style page; defaults to false.cursor (optional): section ID from the previous paged response, formatted as s- followed by digits. Supplying a cursor enables paged mode.direction (optional, paged mode): one of down or up; defaults to down. Direction requires paging=true or a cursor.Returns the upstream live feed under data. An empty, null, or omitted Sctns value is valid when there are no live events. In paged mode, use the last returned section's Id as the next cursor when Nav.Hn is true.
| Field | Filled in, of 15 checked | Values in the sample |
|---|---|---|
| Id | 15 | |
| Tp | 15 | 1 |
| Ts | 15 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| sport | string | Yes | LiveScore sport id Allowed values: soccer, hockey, basketball, tennis, cricket. | soccer | |
| timezone_offset | integer | No | 0 | UTC offset in hours from -12 through 14; defaults to 0 Minimum: -12. Maximum: 14. | |
| paging | boolean | No | false | Request a paged live feed; defaults to false | |
| cursor | string | No | Section Id from the prior paged response, e.g. s-26031 | s-26031 | |
| direction | string | No | Page direction in paged mode Allowed values: down, up. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/livescore/live-scores?sport=soccer&paging=true&direction=down" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://prod-cdn-mev-api.lsmedia1.com/api/v2/live/soccer/0?direction=up&locale=en&paging=false",
"data": {
"Ts": 1790382940,
"Nav": {
"Hn": false
},
"Sctns": []
}
}
}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 |
| 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/livescore/live-scores?sport=soccer&paging=true&direction=down" \
-H "x-api-key: $CRAWLORA_API_KEY"