Docs menu

Flashscore API endpoint

Flashscore match report API

Returns Flashscore's written match report: title, author, publication time, the full text as ordered paragraphs and inline images (with links to teams, players and competitions kept as structured data), and the credited photos. Only matches with editorial coverage have a report; every other match returns not found.

GETapiKey1 credit/requestFlashscoreflashscore.matchReportResponseDoc/flashscore/match-report

Endpoint facts

Method: GET
API path: /flashscore/match-report
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Flashscore
Response schema: #/definitions/flashscore.matchReportResponseDoc

Flashscore scraping API Try Flashscore match report API in Playground Flashscore API documentation

How this endpoint behaves

Query parameters:

id (required): eight-character match id from a Flashscore match URL, for example j52jHsN8.

Returns Flashscore's written match report for a match that has editorial coverage (mostly top competitions and finished matches).

report.id, title, author (the byline), published_at and edited_at (RFC 3339, UTC).
report.text: the full report text, paragraphs separated by a blank line.
report.content: the body in reading order. Each block has a type of paragraph or image. A paragraph has text, bold (true when the whole paragraph is bold, as for the lead and the man-of-the-match line) and links. An image block (an inline chart such as the match momentum graphic) has alt, credit, url, width and height.
A link has text, an absolute url, a type of team, player, competition or page, and the Flashscore id for team and player links, which can be passed to the other Flashscore endpoints.
report.images: the credited photos. The provider's size and format variants are collapsed into one entry with url (the 1200 px JPEG), thumbnail_url (the smallest JPEG at least 300 px wide, or the largest smaller one), alt and credit.

Unknown formatting tags are dropped and their text kept. Matches without a published report, every non-editorial match, and unknown ids return 404 (Flashscore answers an HTML 404 page for them).

Example response (shortened):

{"code":200,"msg":"OK","data":{"source_url":"https://global.flashscore.ninja/2/x/feed/df_rr_j52jHsN8/","match_id":"j52jHsN8","report":{"id":"ALRieYFJ","title":"Seagulls soar as Arsenal gunned down","author":"Adam Clancy","published_at":"2026-09-19T15:55:23Z","edited_at":"2026-09-19T15:55:26Z","text":"Brighton & Hove Albion shocked Premier League (PL) champions Arsenal with a 3-0 win at the Amex Stadium...","content":[{"type":"paragraph","text":"Brighton & Hove Albion shocked Premier League (PL) champions Arsenal with a 3-0 win at the Amex Stadium...","bold":true,"links":[{"text":"Brighton & Hove Albion","url":"https://www.flashscore.com/team/brighton/2XrRecc3/","type":"team","id":"2XrRecc3"},{"text":"Arsenal","url":"https://www.flashscore.com/team/arsenal/hA1Zm19f/","type":"team","id":"hA1Zm19f"}]},{"type":"image","alt":"Momentum","credit":"Flashscore","url":"https://livesport-ott-images.ssl.cdn.cra.cz/r1200x675q60/3ffbc3f1-4348-410b-85ce-5afaee840f9a.jpeg","width":3840,"height":2160}],"images":[{"url":"https://livesport-ott-images.ssl.cdn.cra.cz/r1200x675q60/d83bd59f-fc17-463e-adba-c3856a6f48ec.jpeg","thumbnail_url":"https://livesport-ott-images.ssl.cdn.cra.cz/r300x168q60/d83bd59f-fc17-463e-adba-c3856a6f48ec.jpeg","alt":"Seagulls soar as Arsenal gunned down","credit":"GLYN KIRK / AFP"}]}}}

Live monitoring

Monitored request: GET /flashscore/match-report?id=j52jHsN8
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.79 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /flashscore/match-report?id=j52jHsN8
Items in report.content: 8
Fields filled in every checked item: 1
Fields empty in some or all items: 8

Field	Filled in, of 8 checked	Values in the sample
type	8	paragraph (7), image (1)
text	7	median 453 characters
bold	2	true in 2 of 2
links	4	median 2 entries
alt	1	“Momentum”
credit	1	“Flashscore”
url	1	livesport-ott-images.ssl.cdn.cra.cz
width	1
height	1

Request parameters

Parameter	Type	Required	Default	Description	Example
id	string	Yes		Eight-character Flashscore match id	j52jHsN8
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-report?id=j52jHsN8" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://global.flashscore.ninja/2/x/feed/df_rr_j52jHsN8/",
    "match_id": "j52jHsN8",
    "report": {
      "id": "ALRieYFJ",
      "title": "Seagulls soar as Arsenal gunned down",
      "author": "Adam Clancy",
      "published_at": "2026-09-19T15:55:23Z",
      "edited_at": "2026-09-19T15:55:26Z",
      "text": "Brighton & Hove Albion shocked Premier League (PL) champions Arsenal with a 3-0 win at the Amex Stadium...",
      "content": [
        {
          "type": "paragraph",
          "text": "Brighton & Hove Albion shocked Premier League (PL) champions Arsenal with a 3-0 win at the Amex Stadium...",
          "bold": true,
          "links": [
            {
              "text": "Brighton & Hove Albion",
              "url": "https://www.flashscore.com/team/brighton/2XrRecc3/",
              "type": "team",
              "id": "2XrRecc3"
            },
            {
              "text": "Arsenal",
              "url": "https://www.flashscore.com/team/arsenal/hA1Zm19f/",
              "type": "team",
              "id": "hA1Zm19f"
            }
          ]
        },
        {
          "type": "image",
          "alt": "Momentum",
          "credit": "Flashscore",
          "url": "https://livesport-ott-images.ssl.cdn.cra.cz/r1200x675q60/3ffbc3f1-4348-410b-85ce-5afaee840f9a.jpeg",
          "width": 3840,
          "height": 2160
        }
      ],
      "images": [
        {
          "url": "https://livesport-ott-images.ssl.cdn.cra.cz/r1200x675q60/d83bd59f-fc17-463e-adba-c3856a6f48ec.jpeg",
          "thumbnail_url": "https://livesport-ott-images.ssl.cdn.cra.cz/r300x168q60/d83bd59f-fc17-463e-adba-c3856a6f48ec.jpeg",
          "alt": "Seagulls soar as Arsenal gunned down",
          "credit": "GLYN KIRK / AFP"
        }
      ]
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/flashscore.matchReportResponseDoc

Field	Type	Required	Enum	Example
code	integer	No		200
data	flashscore.matchReportDataDoc	No
data.match_id	string	No		j52jHsN8
data.report	flashscore.matchReportDoc	No
data.report.author	string	No		Adam Clancy
data.report.content	array	No
data.report.content[].alt	string	No		Momentum
data.report.content[].bold	boolean	No		true
data.report.content[].credit	string	No		Flashscore
data.report.content[].height	integer	No		2160
data.report.content[].links	array	No
data.report.content[].links[].id	string	No		hA1Zm19f
data.report.content[].links[].text	string	No		Arsenal
data.report.content[].links[].type	string	No	team, player, competition, page	team
data.report.content[].links[].url	string	No		https://www.flashscore.com/team/arsenal/hA1Zm19f/
data.report.content[].text	string	No
data.report.content[].type	string	No	paragraph, image	paragraph
data.report.content[].url	string	No
data.report.content[].width	integer	No		3840
data.report.edited_at	string	No		2026-09-19T15:55:26Z
data.report.id	string	No		ALRieYFJ
data.report.images	array	No
data.report.images[].alt	string	No
data.report.images[].credit	string	No		GLYN KIRK / AFP
data.report.images[].thumbnail_url	string	No
data.report.images[].url	string	No
data.report.published_at	string	No		2026-09-19T15:55:23Z
data.report.text	string	No
data.report.title	string	No		Seagulls soar as Arsenal gunned down
data.source_url	string	No		https://global.flashscore.ninja/2/x/feed/df_rr_j52jHsN8/
msg	string	No		OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-report?id=j52jHsN8" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Flashscore endpoint docs Flashscore scraping API Flashscore calendar categories API documentation Flashscore season calendar API documentation Flashscore Competitions API documentation Flashscore Entity News API documentation Flashscore match box score API documentation Flashscore match darts API documentation

Open in Playground Back to group

Docs menu

Flashscore API endpoint

Flashscore match report API

GETapiKey1 credit/requestFlashscoreflashscore.matchReportResponseDoc/flashscore/match-report

Endpoint facts

Method: GET
API path: /flashscore/match-report
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Flashscore
Response schema: #/definitions/flashscore.matchReportResponseDoc

Flashscore scraping API Try Flashscore match report API in Playground Flashscore API documentation

How this endpoint behaves

Query parameters:

id (required): eight-character match id from a Flashscore match URL, for example j52jHsN8.

Returns Flashscore's written match report for a match that has editorial coverage (mostly top competitions and finished matches).

report.id, title, author (the byline), published_at and edited_at (RFC 3339, UTC).
report.text: the full report text, paragraphs separated by a blank line.
report.content: the body in reading order. Each block has a type of paragraph or image. A paragraph has text, bold (true when the whole paragraph is bold, as for the lead and the man-of-the-match line) and links. An image block (an inline chart such as the match momentum graphic) has alt, credit, url, width and height.
A link has text, an absolute url, a type of team, player, competition or page, and the Flashscore id for team and player links, which can be passed to the other Flashscore endpoints.
report.images: the credited photos. The provider's size and format variants are collapsed into one entry with url (the 1200 px JPEG), thumbnail_url (the smallest JPEG at least 300 px wide, or the largest smaller one), alt and credit.

Unknown formatting tags are dropped and their text kept. Matches without a published report, every non-editorial match, and unknown ids return 404 (Flashscore answers an HTML 404 page for them).

Example response (shortened):

{"code":200,"msg":"OK","data":{"source_url":"https://global.flashscore.ninja/2/x/feed/df_rr_j52jHsN8/","match_id":"j52jHsN8","report":{"id":"ALRieYFJ","title":"Seagulls soar as Arsenal gunned down","author":"Adam Clancy","published_at":"2026-09-19T15:55:23Z","edited_at":"2026-09-19T15:55:26Z","text":"Brighton & Hove Albion shocked Premier League (PL) champions Arsenal with a 3-0 win at the Amex Stadium...","content":[{"type":"paragraph","text":"Brighton & Hove Albion shocked Premier League (PL) champions Arsenal with a 3-0 win at the Amex Stadium...","bold":true,"links":[{"text":"Brighton & Hove Albion","url":"https://www.flashscore.com/team/brighton/2XrRecc3/","type":"team","id":"2XrRecc3"},{"text":"Arsenal","url":"https://www.flashscore.com/team/arsenal/hA1Zm19f/","type":"team","id":"hA1Zm19f"}]},{"type":"image","alt":"Momentum","credit":"Flashscore","url":"https://livesport-ott-images.ssl.cdn.cra.cz/r1200x675q60/3ffbc3f1-4348-410b-85ce-5afaee840f9a.jpeg","width":3840,"height":2160}],"images":[{"url":"https://livesport-ott-images.ssl.cdn.cra.cz/r1200x675q60/d83bd59f-fc17-463e-adba-c3856a6f48ec.jpeg","thumbnail_url":"https://livesport-ott-images.ssl.cdn.cra.cz/r300x168q60/d83bd59f-fc17-463e-adba-c3856a6f48ec.jpeg","alt":"Seagulls soar as Arsenal gunned down","credit":"GLYN KIRK / AFP"}]}}}

Live monitoring

Monitored request: GET /flashscore/match-report?id=j52jHsN8
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.79 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /flashscore/match-report?id=j52jHsN8
Items in report.content: 8
Fields filled in every checked item: 1
Fields empty in some or all items: 8

Field	Filled in, of 8 checked	Values in the sample
type	8	paragraph (7), image (1)
text	7	median 453 characters
bold	2	true in 2 of 2
links	4	median 2 entries
alt	1	“Momentum”
credit	1	“Flashscore”
url	1	livesport-ott-images.ssl.cdn.cra.cz
width	1
height	1

Request parameters

Parameter	Type	Required	Default	Description	Example
id	string	Yes		Eight-character Flashscore match id	j52jHsN8
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-report?id=j52jHsN8" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://global.flashscore.ninja/2/x/feed/df_rr_j52jHsN8/",
    "match_id": "j52jHsN8",
    "report": {
      "id": "ALRieYFJ",
      "title": "Seagulls soar as Arsenal gunned down",
      "author": "Adam Clancy",
      "published_at": "2026-09-19T15:55:23Z",
      "edited_at": "2026-09-19T15:55:26Z",
      "text": "Brighton & Hove Albion shocked Premier League (PL) champions Arsenal with a 3-0 win at the Amex Stadium...",
      "content": [
        {
          "type": "paragraph",
          "text": "Brighton & Hove Albion shocked Premier League (PL) champions Arsenal with a 3-0 win at the Amex Stadium...",
          "bold": true,
          "links": [
            {
              "text": "Brighton & Hove Albion",
              "url": "https://www.flashscore.com/team/brighton/2XrRecc3/",
              "type": "team",
              "id": "2XrRecc3"
            },
            {
              "text": "Arsenal",
              "url": "https://www.flashscore.com/team/arsenal/hA1Zm19f/",
              "type": "team",
              "id": "hA1Zm19f"
            }
          ]
        },
        {
          "type": "image",
          "alt": "Momentum",
          "credit": "Flashscore",
          "url": "https://livesport-ott-images.ssl.cdn.cra.cz/r1200x675q60/3ffbc3f1-4348-410b-85ce-5afaee840f9a.jpeg",
          "width": 3840,
          "height": 2160
        }
      ],
      "images": [
        {
          "url": "https://livesport-ott-images.ssl.cdn.cra.cz/r1200x675q60/d83bd59f-fc17-463e-adba-c3856a6f48ec.jpeg",
          "thumbnail_url": "https://livesport-ott-images.ssl.cdn.cra.cz/r300x168q60/d83bd59f-fc17-463e-adba-c3856a6f48ec.jpeg",
          "alt": "Seagulls soar as Arsenal gunned down",
          "credit": "GLYN KIRK / AFP"
        }
      ]
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/flashscore.matchReportResponseDoc

Field	Type	Required	Enum	Example
code	integer	No		200
data	flashscore.matchReportDataDoc	No
data.match_id	string	No		j52jHsN8
data.report	flashscore.matchReportDoc	No
data.report.author	string	No		Adam Clancy
data.report.content	array	No
data.report.content[].alt	string	No		Momentum
data.report.content[].bold	boolean	No		true
data.report.content[].credit	string	No		Flashscore
data.report.content[].height	integer	No		2160
data.report.content[].links	array	No
data.report.content[].links[].id	string	No		hA1Zm19f
data.report.content[].links[].text	string	No		Arsenal
data.report.content[].links[].type	string	No	team, player, competition, page	team
data.report.content[].links[].url	string	No		https://www.flashscore.com/team/arsenal/hA1Zm19f/
data.report.content[].text	string	No
data.report.content[].type	string	No	paragraph, image	paragraph
data.report.content[].url	string	No
data.report.content[].width	integer	No		3840
data.report.edited_at	string	No		2026-09-19T15:55:26Z
data.report.id	string	No		ALRieYFJ
data.report.images	array	No
data.report.images[].alt	string	No
data.report.images[].credit	string	No		GLYN KIRK / AFP
data.report.images[].thumbnail_url	string	No
data.report.images[].url	string	No
data.report.published_at	string	No		2026-09-19T15:55:23Z
data.report.text	string	No
data.report.title	string	No		Seagulls soar as Arsenal gunned down
data.source_url	string	No		https://global.flashscore.ninja/2/x/feed/df_rr_j52jHsN8/
msg	string	No		OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/flashscore/match-report?id=j52jHsN8" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Flashscore match report API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Flashscore match report API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related