Docs menu

Flashscore API endpoint

Flashscore Navigation API

Returns the first-party category hierarchy and competition links for a public Flashscore sport or category page. Start with / or a sport path from flashscore-sports, then follow returned paths to enumerate region, country, category, and competition pages. Country/category lists reflect the current upstream navigation.

GETapiKey1 credit/requestFlashscoreflashscore.navigationResponseDoc/flashscore/navigation

Endpoint facts

Method: GET
API path: /flashscore/navigation
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Flashscore
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/flashscore.navigationResponseDoc

Flashscore scraping API Try Flashscore Navigation API in Playground Flashscore API documentation

How this endpoint behaves

Query parameters:

path (optional): Relative Flashscore sport/category/country page path. Defaults to / (football). Begin with a path from flashscore-sports, then follow the path values returned here.

The response exposes first-party navigation groups for supported sports, regions, countries, categories, and competition links. The lists reflect the current public site and can change. On sport roots, the site embeds country/category groups; country pages expose their league and cup links; category pages may also expose currently active tournaments. This is a directory/discovery endpoint, not a historical league catalog. Use flashscore-tournament-seasons and flashscore-tournament-events for a specific competition's seasons and matches.

Paths must remain under a supported Flashscore sport root or a linked auto/moto-racing category root. Absolute URLs, query strings, fragments, and unsupported roots are rejected. The service fetches public HTML through the shared proxied browser request profile and returns an upstream error for challenge pages, malformed navigation data, or pages with no recognized links.

Example request:

GET /api/v1/flashscore/navigation?path=%2Fbasketball%2Fusa%2F

Live monitoring

Monitored request: GET /flashscore/navigation?path=%2Fbasketball%2Fusa%2F
Checks passed, 7 days to 14 Oct 2026: 98.4%
Median response time: 2.37 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /flashscore/navigation?path=%2Fbasketball%2Fusa%2F
Items in groups: 3
Fields filled in every checked item: 2

Field	Filled in, of 3 checked	Values in the sample
name	3	“Countries” and 2 other values
items	3	median 16 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
path	string	No	/	Relative Flashscore navigation path; defaults to /. Use a path returned by flashscore-sports or flashscore-navigation.	/basketball/usa/
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/flashscore/navigation" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.flashscore.com/basketball/usa/",
    "path": "/basketball/usa/",
    "title": "Basketball USA - NBA, NCAA, live scores and livescore",
    "groups": [
      {
        "name": "Countries",
        "items": [
          {
            "id": 17,
            "sport_id": 3,
            "name": "Albania",
            "path": "/basketball/albania/"
          }
        ]
      },
      {
        "name": "USA",
        "items": [
          {
            "name": "NBA",
            "path": "/basketball/usa/nba/"
          },
          {
            "name": "NCAA",
            "path": "/basketball/usa/ncaa/"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/flashscore.navigationResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	flashscore.navigationDataDoc	No
data.groups	array	No
data.groups[].items	array	No
data.groups[].items[].id	integer	No	1234
data.groups[].items[].name	string	No	NBA
data.groups[].items[].path	string	No	/basketball/usa/nba/
data.groups[].items[].sport_id	integer	No	3
data.groups[].name	string	No	USA
data.path	string	No	/basketball/usa/
data.source_url	string	No	https://www.flashscore.com/basketball/usa/
data.title	string	No	Basketball USA - NBA, NCAA, live scores and livescore
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/navigation" \
  -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 Navigation API

GETapiKey1 credit/requestFlashscoreflashscore.navigationResponseDoc/flashscore/navigation

Endpoint facts

Method: GET
API path: /flashscore/navigation
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Flashscore
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/flashscore.navigationResponseDoc

Flashscore scraping API Try Flashscore Navigation API in Playground Flashscore API documentation

How this endpoint behaves

Query parameters:

path (optional): Relative Flashscore sport/category/country page path. Defaults to / (football). Begin with a path from flashscore-sports, then follow the path values returned here.

Example request:

GET /api/v1/flashscore/navigation?path=%2Fbasketball%2Fusa%2F

Live monitoring

Monitored request: GET /flashscore/navigation?path=%2Fbasketball%2Fusa%2F
Checks passed, 7 days to 14 Oct 2026: 98.4%
Median response time: 2.37 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /flashscore/navigation?path=%2Fbasketball%2Fusa%2F
Items in groups: 3
Fields filled in every checked item: 2

Field	Filled in, of 3 checked	Values in the sample
name	3	“Countries” and 2 other values
items	3	median 16 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
path	string	No	/	Relative Flashscore navigation path; defaults to /. Use a path returned by flashscore-sports or flashscore-navigation.	/basketball/usa/
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/flashscore/navigation" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.flashscore.com/basketball/usa/",
    "path": "/basketball/usa/",
    "title": "Basketball USA - NBA, NCAA, live scores and livescore",
    "groups": [
      {
        "name": "Countries",
        "items": [
          {
            "id": 17,
            "sport_id": 3,
            "name": "Albania",
            "path": "/basketball/albania/"
          }
        ]
      },
      {
        "name": "USA",
        "items": [
          {
            "name": "NBA",
            "path": "/basketball/usa/nba/"
          },
          {
            "name": "NCAA",
            "path": "/basketball/usa/ncaa/"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/flashscore.navigationResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	flashscore.navigationDataDoc	No
data.groups	array	No
data.groups[].items	array	No
data.groups[].items[].id	integer	No	1234
data.groups[].items[].name	string	No	NBA
data.groups[].items[].path	string	No	/basketball/usa/nba/
data.groups[].items[].sport_id	integer	No	3
data.groups[].name	string	No	USA
data.path	string	No	/basketball/usa/
data.source_url	string	No	https://www.flashscore.com/basketball/usa/
data.title	string	No	Basketball USA - NBA, NCAA, live scores and livescore
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/navigation" \
  -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 Navigation 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 Navigation 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