LiveScore API endpoint
Searches the public LiveScore index for a free-text term, or browse its current team, competition-stage, and region-category sections with an empty query. Results are dynamic, limited per section, and are not a complete historical competition directory. Use /livescore/sports to discover all supported sport tokens.
/livescore/searchQuery parameters:
sport (required): soccer, hockey, basketball, tennis, or cricket. These are the complete values returned by /api/v1/livescore/sports.query (optional): free-text team, competition, or region name, up to 100 characters. Omit it or pass an empty value to browse the current search-index sections for the selected sport.limit (optional): result limit per section, from 1 to 100. Defaults to 10 for a non-empty query and 50 for browse mode.Notable response behavior:
results. Depending on the sport and query, the source may return Teams, Stages (competition stages), and Categories (region or competition groups); a section can be absent when that sport has no corresponding result group.results.Sorting contains a subset of Teams, Stages, and Categories, in the source's preferred display order.limit=50 returned 19/28/28/15/24 categories for soccer/hockey/basketball/tennis/cricket respectively on 2026-09-27. These are dynamic search-index results, not a complete historical competition directory; use /api/v1/livescore/competitions for the public English competition sitemap paths it covers.limit is validated from 1 to 100; the caller can raise it above the upstream UI's observed 20 value, but the source may still return fewer records.| Field | Filled in, of 24 checked | Values in the sample |
|---|---|---|
| Cid | 24 | |
| Cnm | 24 | “England” and 23 other values |
| CnmT | 24 | “england” and 23 other values |
| Ccd | 24 | “england” and 23 other values |
| Spid | 24 | 73 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| sport | string | Yes | LiveScore sport token Allowed values: soccer, hockey, basketball, tennis, cricket. | soccer | |
| query | string | No | Optional free-text team, competition, or region term (up to 100 characters). Omit or leave empty to browse current results. | Manchester City | |
| limit | integer | No | 10 for a text query or 50 when query is empty | Optional results per section (1 to 100). Defaults to 10 for a text query or 50 when query is empty. Minimum: 1. Maximum: 100. | 50 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/livescore/search?sport=soccer&query=coffee&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://prod-cdn-search-api.lsmedia1.com/api/v2/search/cricket?categories=true&limit=50&locale=en&query=&stages=true&teams=true",
"sport": "cricket",
"query": "",
"results": {
"Sorting": [
"Stages",
"Categories"
],
"Stages": [
{
"Sid": "19609",
"Snm": "The Ashes"
}
],
"Categories": [
{
"Cid": "23",
"Cnm": "England"
}
]
}
}
}Request schema
No body schema
Response schema
#/definitions/livescore.livescoreSearchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | object | No | ||||
| data.query | string | No | Manchester City | |||
| data.results | object | No | ||||
| data.source_url | string | No | https://prod-cdn-search-api.lsmedia1.com/api/v2/search/soccer?categories=true&locale=en&query=Manchester+City&stages=true&teams=true&limit=10 | |||
| data.sport | string | No | soccer | |||
| 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/search?sport=soccer&query=coffee&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"