Flashscore API endpoint
Returns a team's public profile: name, country, sport, logo, the stadium and capacity shown on its summary page, and the competitions of its recent and upcoming fixtures. Use a team id from flashscore-search, a Flashscore team URL, a match endpoint's team ids, or flashscore-team-squad and flashscore-player. A player id returns not found.
/flashscore/teamQuery parameters:
id (required): eight-character Flashscore team id, the last path segment of a team URL (/team/<slug>/<id>/). Find ids with /api/v1/flashscore/search, the home.id / away.id fields of /api/v1/flashscore/team-results, or the player endpoints. A player id returns not found.Notable response behavior: team carries the id, display name, official full_name when it differs, country, sport (sport_id and the matching sport key from /api/v1/flashscore/sports), slug, page path and logo. venue (stadium, city, capacity) is read from the team's public summary page and is omitted when the page lists none. competitions lists the competitions referenced by the team's recent and upcoming fixtures; it is not a complete season history and is empty for a team with none. National teams, youth teams and women's teams are teams like any other and have their own ids.
| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| name | 2 | “Premier League” and 1 other value |
| country | 2 | “England” and 1 other value |
| full_name | 2 | |
| path | 2 | “/football/england/premier-league/” and 1 other value |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | Yes | Eight-character Flashscore team id | Wtn9Stg0 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/flashscore/team?id=Wtn9Stg0" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://global.flashscore.ninja/2/x/feed/pl_1_Wtn9Stg0_0",
"page_url": "https://www.flashscore.com/team/manchester-city/Wtn9Stg0/",
"team": {
"id": "Wtn9Stg0",
"name": "Manchester City",
"full_name": "Manchester City FC",
"country": "England",
"country_id": 198,
"sport_id": 1,
"sport": "football",
"slug": "manchester-city",
"path": "/team/manchester-city/Wtn9Stg0/",
"url": "https://www.flashscore.com/team/manchester-city/Wtn9Stg0/",
"logo_url": "https://static.flashscore.com/res/image/data/UXcqj7HG-lQuhqN8N.png"
},
"venue": {
"stadium": "Etihad Stadium",
"city": "Manchester",
"capacity": 61038
},
"competitions": [
{
"name": "Premier League",
"country": "England",
"full_name": "ENGLAND: Premier League",
"path": "/football/england/premier-league/"
}
]
}
}Request schema
No body schema
Response schema
Inline response schema
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | flashscore.TeamResponse | No | ||||
| data.competitions | array | No | ||||
| data.competitions[].country | string | No | ||||
| data.competitions[].full_name | string | No | ||||
| data.competitions[].name | string | No | ||||
| data.competitions[].path | string | No | ||||
| data.page_url | string | No | ||||
| data.source_url | string | No | ||||
| data.team | flashscore.TeamProfile | No | ||||
| data.team.country | string | No | ||||
| data.team.country_id | integer | No | ||||
| data.team.full_name | string | No | ||||
| data.team.id | string | No | ||||
| data.team.logo_url | string | No | ||||
| data.team.name | string | No | ||||
| data.team.path | string | No | ||||
| data.team.slug | string | No | ||||
| data.team.sport | string | No | ||||
| data.team.sport_id | integer | No | ||||
| data.team.url | string | No | ||||
| data.venue | flashscore.TeamVenue | No | ||||
| data.venue.capacity | integer | No | ||||
| data.venue.city | string | No | ||||
| data.venue.stadium | string | No | ||||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| 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/flashscore/team?id=Wtn9Stg0" \
-H "x-api-key: $CRAWLORA_API_KEY"