Flashscore API endpoint
Searches the same public entity index used by Flashscore's search box. Results can include teams, players, and tournament templates across supported sports.
/flashscore/searchParameters:
q (required): a search phrase from 2 to 80 characters.Notable response behavior: searches Flashscore's public search index and can return teams, players, and tournament templates across sports. Result entity types and fields are source-defined. Empty results are returned as an empty array; the endpoint does not require login or an API key at the upstream.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| url | 20 | “arsenal” and 10 other values |
| name | 20 | “Arsenal” and 19 other values |
| gender | 20 | |
| type | 20 | |
| sport | 20 | |
| participantTypes | 20 | median 1 entry |
| defaultCountry | 20 | |
| images | 19 | median 3 entries |
| teams | 0 | |
| defaultTournament | 0 | |
| superTemplate | 0 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Search phrase (2 to 80 characters) | Champions League | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/flashscore/search?q=Champions+League" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"query": "LeBron James",
"results": [
{
"id": "1",
"url": "/player/lebron-james/1",
"name": "LeBron James",
"type": {
"id": 2,
"name": "Player"
},
"sport": {
"id": 3,
"name": "Basketball"
}
}
]
}
}Request schema
No body schema
Response schema
#/definitions/flashscore.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | flashscore.searchDataDoc | No | ||||
| data.query | string | No | Arsenal | |||
| data.results | array | No | ||||
| data.results[].defaultCountry | object | No | ||||
| data.results[].defaultTournament | object | No | ||||
| data.results[].gender | flashscore.searchNamedIDDoc | No | ||||
| data.results[].gender.id | integer | No | 2 | |||
| data.results[].gender.name | string | No | Team | |||
| data.results[].id | string | No | hA1Zm19f | |||
| data.results[].images | array | No | ||||
| data.results[].images[].path | string | No | fwtiqyQt-vcNAdtF9.png | |||
| data.results[].images[].usageId | integer | No | 2 | |||
| data.results[].images[].variantTypeId | integer | No | 2 | |||
| data.results[].name | string | No | Arsenal | |||
| data.results[].participantTypes | array | No | ||||
| data.results[].participantTypes[].id | integer | No | 2 | |||
| data.results[].participantTypes[].name | string | No | Team | |||
| data.results[].sport | flashscore.searchNamedIDDoc | No | ||||
| data.results[].sport.id | integer | No | 2 | |||
| data.results[].sport.name | string | No | Team | |||
| data.results[].superTemplate | object | No | ||||
| data.results[].teams | array | No | ||||
| data.results[].type | flashscore.searchNamedIDDoc | No | ||||
| data.results[].type.id | integer | No | 2 | |||
| data.results[].type.name | string | No | Team | |||
| data.results[].url | string | No | arsenal | |||
| data.source_url | string | No | https://s.livesport.services/api/v2/search/?q=Arsenal | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/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/flashscore/search?q=Champions+League" \
-H "x-api-key: $CRAWLORA_API_KEY"