Flashscore API endpoint
Returns the article ids of Flashscore's own news layout for one entity: the featured article plus the 25 most recent ones, grouped in the sections Flashscore shows. The layout has no pagination. Resolve the ids with flashscore-news-article (metadata) or flashscore-news-article-body (full text). Teams and players share one layout type. A tournament is a tournament template id (the competition id in event lists); a sport is one of the SPORT entity ids listed by flashscore-news-categories. An id with no news layout returns not found.
/flashscore/entity-newsReturns the article ids in Flashscore's own news layout for one entity, as shown on the entity's News tab: the featured article plus the 25 most recent ones, grouped in the sections Flashscore shows. The layout has no pagination parameters. Resolve the ids with /api/v1/flashscore/news-article (metadata) or /api/v1/flashscore/news-article-body (full text). The editorial sections of the News home are covered by /api/v1/flashscore/news instead, and publisher headlines about a team or player by /api/v1/flashscore/team-news and /api/v1/flashscore/player-news.
Query parameters:
type (required): one of team, player, tournament, sport. team and player use the same participant layout, so a player id works with either.id (required): eight-character entity id. For team and player a team or player id; for tournament a tournament template id (the id of the competition block in team, player and score feeds, for example dYlOSQOD for the Premier League); for sport one of the SPORT entity ids listed by /api/v1/flashscore/news-categories (entity_type SPORT): football = SW9D1eZo, tennis = Mg9H0Flh, darts = naYhNOaA, snooker = 4K05MrFG, golf = EkWXj6U9, road-cycling = 8nQ2VTTL, badminton = txYPhSac, handball = EcZwBi3N, hockey = IL2QbgJ4, basketball = zcDLaZ3b, cricket = QTNHA4p4, rugby-union = SrC4LDIT, athletics = 0QIlt8pi, baseball = 8bP2bXmH, rugby-league = f3GcHO7j, motorsport = nypUMTq3, aussie-rules = GCHgI4hp.Invalid type values and sport ids outside that list return 400 before any upstream request. An id with no news layout, or an id used with the wrong type, returns 404.
Response fields: type, id, entity (entity_id, entity_type PARTICIPANT, TOURNAMENT_TEMPLATE or SPORT, label, slug), title (the page title), article_count (distinct article ids) and sections. Each section has title, section_type (MOST_RECENT, or TOPPED for sections Flashscore pins by hand, which can be empty), article_count and article_ids. Football, basketball and other sport layouts also list pinned sections such as Football Tracker; a tournament or team layout usually has a one-article lead section and a More ... News section with 25 articles.
Example response (shortened):
{"code":200,"msg":"OK","data":{"source_url":"https://2.ds.lsapp.eu/pq_graphql?_hash=nl&projectId=2&tagId=Wtn9Stg0nZdPEiqF","type":"team","id":"Wtn9Stg0","entity":{"entity_id":"Wtn9Stg0","entity_type":"PARTICIPANT","label":"Manchester City","slug":"manchester-city"},"title":"Manchester City News | Football - Flashscore News","article_count":26,"sections":[{"title":"Manchester City","section_type":"MOST_RECENT","article_count":1,"article_ids":["rTwubODj"]},{"title":"More Manchester City News","section_type":"MOST_RECENT","article_count":25,"article_ids":["O2suL0oL","2uHhypv3"]}]}}
| Field | Filled in, of 1 checked | Values in the sample |
|---|---|---|
| title | 1 | median 14 characters |
| section_type | 1 | “MOST_RECENT” |
| article_count | 1 | 25 |
| article_ids | 1 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| type | string | Yes | Entity type Allowed values: team, player, tournament, sport. | player | |
| id | string | Yes | Eight-character entity id: team or player id, tournament template id, or a SPORT entity id from flashscore-news-categories | UmV9iQmE | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/flashscore/entity-news?type=player&id=UmV9iQmE" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://2.ds.lsapp.eu/pq_graphql?_hash=nl&projectId=2&tagId=Wtn9Stg0nZdPEiqF",
"type": "team",
"id": "Wtn9Stg0",
"entity": {
"entity_id": "Wtn9Stg0",
"entity_type": "PARTICIPANT",
"label": "Manchester City",
"slug": "manchester-city"
},
"title": "Manchester City News | Football - Flashscore News",
"article_count": 26,
"sections": [
{
"title": "Manchester City",
"section_type": "MOST_RECENT",
"article_count": 1,
"article_ids": [
"rTwubODj"
]
},
{
"title": "More Manchester City News",
"section_type": "MOST_RECENT",
"article_count": 25,
"article_ids": [
"O2suL0oL",
"2uHhypv3"
]
}
]
}
}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.EntityNewsResponse | No | ||||
| data.article_count | integer | No | ||||
| data.entity | flashscore.EntityNewsTag | No | ||||
| data.entity.entity_id | string | No | ||||
| data.entity.entity_type | string | No | PARTICIPANT, TOURNAMENT_TEMPLATE, SPORT | |||
| data.entity.label | string | No | ||||
| data.entity.slug | string | No | ||||
| data.id | string | No | ||||
| data.sections | array | No | ||||
| data.sections[].article_count | integer | No | ||||
| data.sections[].article_ids | array | No | ||||
| data.sections[].section_type | string | No | MOST_RECENT, TOPPED | |||
| data.sections[].title | string | No | ||||
| data.source_url | string | No | ||||
| data.title | string | No | ||||
| data.type | string | No | team, player, tournament, sport | |||
| 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/entity-news?type=player&id=UmV9iQmE" \
-H "x-api-key: $CRAWLORA_API_KEY"