Docs menu

Flashscore API endpoint

Flashscore Competitions API

Discovers competitions present in a selected sport's score feed, including the provider competition id, label, region, canonical path, and event count. This is the active feed-date inventory, not an archive of inactive or historical seasons.

GETapiKey1 credit/requestFlashscoreflashscore.competitionsResponseDoc/flashscore/competitions

Endpoint facts

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

Flashscore scraping API Try Flashscore Competitions API in Playground Flashscore API documentation

How this endpoint behaves

Parameters:

sport (required): one of football, tennis, basketball, hockey, golf, formula-1, baseball, snooker, american-football, aussie-rules, badminton, bandy, beach-soccer, beach-volleyball, boxing, cricket, cycling, darts, esports, field-hockey, floorball, futsal, handball, horse-racing, kabaddi, mma, motorsport, netball, pesapallo, rugby-league, rugby-union, table-tennis, volleyball, water-polo, winter-sports, moto-racing, ski-jumping, alpine-skiing, cross-country-skiing, biathlon.
day_offset (optional): integer from -7 to 7, relative to today. Defaults to 0.

Notable response behavior: this is the set of competitions with events in the selected date's score feed. It is not a catalog of inactive competitions or historical seasons. Each row includes event count and any observed region and canonical path. To discover the wider current country/category/competition navigation, use /api/v1/flashscore/navigation and follow its returned paths.

Live monitoring

Monitored request: GET /flashscore/competitions?day_offset=0&sport=football
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.03 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /flashscore/competitions?day_offset=0&sport=football
Items in competitions: 101
Fields filled in every checked item: 5

Field	Filled in, of 101 checked	Values in the sample
id	101
name	101	“AFRICA: Olympic Games Women - Qualification” and 100 other values
region	101	“Africa” and 63 other values
path	101	“/football/world/olympic-games-women/” and 100 other values
event_count	101	1 to 20, median 2

Request parameters

Parameter	Type	Required	Default	Description	Example
sport	string	Yes		Sport key Allowed values: football, tennis, basketball, hockey, golf, formula-1, baseball, snooker, american-football, aussie-rules, badminton, bandy, beach-soccer, beach-volleyball, boxing, cricket, cycling, darts, esports, field-hockey, floorball, futsal, handball, horse-racing, kabaddi, mma, motorsport, netball, pesapallo, rugby-league, rugby-union, table-tennis, volleyball, water-polo, winter-sports, moto-racing, ski-jumping, alpine-skiing, cross-country-skiing, biathlon.	football
day_offset	integer	No	0	Days from today; -7 to 7; defaults to 0 Minimum: -7. Maximum: 7.	0
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/flashscore/competitions?sport=football" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "sport": "football",
    "day_offset": 0,
    "competitions": [
      {
        "id": "eng.1",
        "name": "Premier League",
        "region": "England",
        "path": "/football/england/premier-league/",
        "event_count": 10
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/flashscore.competitionsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	flashscore.competitionsDataDoc	No
data.competitions	array	No
data.competitions[].event_count	integer	No	10
data.competitions[].id	string	No	8bP2bXmH
data.competitions[].name	string	No	AFRICA: Africa Cup of Nations - Qualification
data.competitions[].path	string	No	/football/africa/africa-cup-of-nations/
data.competitions[].region	string	No	Africa
data.day_offset	integer	No	0
data.source_url	string	No	https://global.flashscore.ninja/2/x/feed/f_1_0_8_en_1
data.sport	string	No	football
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/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/competitions?sport=football" \
  -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 Entity News API documentation Flashscore match box score API documentation Flashscore match darts API documentation Flashscore match head-to-head API documentation

Open in Playground Back to group

Docs menu

Flashscore API endpoint

Flashscore Competitions API

GETapiKey1 credit/requestFlashscoreflashscore.competitionsResponseDoc/flashscore/competitions

Endpoint facts

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

Flashscore scraping API Try Flashscore Competitions API in Playground Flashscore API documentation

How this endpoint behaves

Parameters:

sport (required): one of football, tennis, basketball, hockey, golf, formula-1, baseball, snooker, american-football, aussie-rules, badminton, bandy, beach-soccer, beach-volleyball, boxing, cricket, cycling, darts, esports, field-hockey, floorball, futsal, handball, horse-racing, kabaddi, mma, motorsport, netball, pesapallo, rugby-league, rugby-union, table-tennis, volleyball, water-polo, winter-sports, moto-racing, ski-jumping, alpine-skiing, cross-country-skiing, biathlon.
day_offset (optional): integer from -7 to 7, relative to today. Defaults to 0.

Live monitoring

Monitored request: GET /flashscore/competitions?day_offset=0&sport=football
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.03 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /flashscore/competitions?day_offset=0&sport=football
Items in competitions: 101
Fields filled in every checked item: 5

Field	Filled in, of 101 checked	Values in the sample
id	101
name	101	“AFRICA: Olympic Games Women - Qualification” and 100 other values
region	101	“Africa” and 63 other values
path	101	“/football/world/olympic-games-women/” and 100 other values
event_count	101	1 to 20, median 2

Request parameters

Parameter	Type	Required	Default	Description	Example
sport	string	Yes		Sport key Allowed values: football, tennis, basketball, hockey, golf, formula-1, baseball, snooker, american-football, aussie-rules, badminton, bandy, beach-soccer, beach-volleyball, boxing, cricket, cycling, darts, esports, field-hockey, floorball, futsal, handball, horse-racing, kabaddi, mma, motorsport, netball, pesapallo, rugby-league, rugby-union, table-tennis, volleyball, water-polo, winter-sports, moto-racing, ski-jumping, alpine-skiing, cross-country-skiing, biathlon.	football
day_offset	integer	No	0	Days from today; -7 to 7; defaults to 0 Minimum: -7. Maximum: 7.	0
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/flashscore/competitions?sport=football" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "sport": "football",
    "day_offset": 0,
    "competitions": [
      {
        "id": "eng.1",
        "name": "Premier League",
        "region": "England",
        "path": "/football/england/premier-league/",
        "event_count": 10
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/flashscore.competitionsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	flashscore.competitionsDataDoc	No
data.competitions	array	No
data.competitions[].event_count	integer	No	10
data.competitions[].id	string	No	8bP2bXmH
data.competitions[].name	string	No	AFRICA: Africa Cup of Nations - Qualification
data.competitions[].path	string	No	/football/africa/africa-cup-of-nations/
data.competitions[].region	string	No	Africa
data.day_offset	integer	No	0
data.source_url	string	No	https://global.flashscore.ninja/2/x/feed/f_1_0_8_en_1
data.sport	string	No	football
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/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/competitions?sport=football" \
  -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 Competitions 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 Competitions 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