Docs menu

Flashscore API endpoint

Flashscore season calendar API

Returns public tournament calendar entries for the current season, sorted by start date, with date ranges, UTC start and end times, host country, winners and winner paths when decided, and competition paths.

GETapiKey1 credit/requestFlashscoreflashscore.calendarResponseDoc/flashscore/calendar

Endpoint facts

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

Flashscore scraping API Try Flashscore season calendar API in Playground Flashscore API documentation

How this endpoint behaves

Query parameters:

category (required): one of tennis-atp, tennis-wta, golf-pga, golf-dp-world, badminton-bwf, or motorsport-f1. These values are also returned by /api/v1/flashscore/calendar-categories.

Returns the events on the current public season calendar, sorted by start date. Each event has a month label (January 2026), a date range label (24.05. - 07.06.), UTC start_time and end_time, the event name, the host country, the winner and winner_path once the event is decided, and the competition path. Calendars do not expose a year selector; year is the year most events start in. A calendar can open in the previous December.

Live monitoring

Monitored request: GET /flashscore/calendar?category=tennis-atp
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.12 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /flashscore/calendar?category=tennis-atp
Items in events: 59
Fields filled in every checked item: 7
Fields empty in some or all items: 2

Field	Filled in, of 59 checked	Values in the sample
month	59	“January 2026” and 10 other values
date	59	“04.01. - 11.01.” and 43 other values
start_time	59	2026-01-04 to 2026-11-15
end_time	59	2026-01-11 to 2026-11-20
name	59	“Brisbane ATP, hard” and 58 other values
country	59	“Australia” and 29 other values
winner	50	“Medvedev Daniil” and 32 other values
winner_path	50	“/player/medvedev-daniil/O8qG0Nhb/” and 32 other values
path	59	“/tennis/atp-singles/brisbane/” and 58 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
category	string	Yes		Calendar category from flashscore-calendar-categories Allowed values: tennis-atp, tennis-wta, golf-pga, golf-dp-world, badminton-bwf, motorsport-f1.	tennis-atp
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/flashscore/calendar?category=tennis-atp" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "category": {
      "key": "tennis-atp",
      "name": "ATP Tour Calendar",
      "sport": "tennis",
      "path": "/tennis/calendar/atp/"
    },
    "year": 2026,
    "events": [
      {
        "month": "May 2026",
        "date": "24.05. - 07.06.",
        "start_time": "2026-05-24T09:00:00Z",
        "end_time": "2026-06-07T13:00:00Z",
        "name": "French Open ATP, clay",
        "country": "France",
        "winner": "Zverev Alexander",
        "winner_path": "/player/zverev-alexander/dGbUhw9m/",
        "path": "/tennis/atp-singles/french-open/"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/flashscore.calendarResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	flashscore.calendarDataDoc	No
data.category	flashscore.calendarCategoryDoc	No
data.category.key	string	No	tennis-atp
data.category.name	string	No	ATP Tour Calendar
data.category.path	string	No	/tennis/calendar/atp/
data.category.sport	string	No	tennis
data.events	array	No
data.events[].country	string	No	France
data.events[].date	string	No	24.05. - 07.06.
data.events[].end_time	string	No	2026-06-07T13:00:00Z
data.events[].month	string	No	May 2026
data.events[].name	string	No	French Open ATP, clay
data.events[].path	string	No	/tennis/atp-singles/french-open/
data.events[].start_time	string	No	2026-05-24T09:00:00Z
data.events[].winner	string	No	Zverev Alexander
data.events[].winner_path	string	No	/player/zverev-alexander/dGbUhw9m/
data.source_url	string	No	https://2.ds.lsapp.eu/pq_graphql?_hash=scs&projectId=2&sportId=2
data.year	integer	No	2026
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/calendar?category=tennis-atp" \
  -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 Competitions 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 season calendar API

GETapiKey1 credit/requestFlashscoreflashscore.calendarResponseDoc/flashscore/calendar

Endpoint facts

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

Flashscore scraping API Try Flashscore season calendar API in Playground Flashscore API documentation

How this endpoint behaves

Query parameters:

category (required): one of tennis-atp, tennis-wta, golf-pga, golf-dp-world, badminton-bwf, or motorsport-f1. These values are also returned by /api/v1/flashscore/calendar-categories.

Live monitoring

Monitored request: GET /flashscore/calendar?category=tennis-atp
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.12 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /flashscore/calendar?category=tennis-atp
Items in events: 59
Fields filled in every checked item: 7
Fields empty in some or all items: 2

Field	Filled in, of 59 checked	Values in the sample
month	59	“January 2026” and 10 other values
date	59	“04.01. - 11.01.” and 43 other values
start_time	59	2026-01-04 to 2026-11-15
end_time	59	2026-01-11 to 2026-11-20
name	59	“Brisbane ATP, hard” and 58 other values
country	59	“Australia” and 29 other values
winner	50	“Medvedev Daniil” and 32 other values
winner_path	50	“/player/medvedev-daniil/O8qG0Nhb/” and 32 other values
path	59	“/tennis/atp-singles/brisbane/” and 58 other values

Request parameters

Parameter	Type	Required	Default	Description	Example
category	string	Yes		Calendar category from flashscore-calendar-categories Allowed values: tennis-atp, tennis-wta, golf-pga, golf-dp-world, badminton-bwf, motorsport-f1.	tennis-atp
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/flashscore/calendar?category=tennis-atp" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "category": {
      "key": "tennis-atp",
      "name": "ATP Tour Calendar",
      "sport": "tennis",
      "path": "/tennis/calendar/atp/"
    },
    "year": 2026,
    "events": [
      {
        "month": "May 2026",
        "date": "24.05. - 07.06.",
        "start_time": "2026-05-24T09:00:00Z",
        "end_time": "2026-06-07T13:00:00Z",
        "name": "French Open ATP, clay",
        "country": "France",
        "winner": "Zverev Alexander",
        "winner_path": "/player/zverev-alexander/dGbUhw9m/",
        "path": "/tennis/atp-singles/french-open/"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/flashscore.calendarResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	flashscore.calendarDataDoc	No
data.category	flashscore.calendarCategoryDoc	No
data.category.key	string	No	tennis-atp
data.category.name	string	No	ATP Tour Calendar
data.category.path	string	No	/tennis/calendar/atp/
data.category.sport	string	No	tennis
data.events	array	No
data.events[].country	string	No	France
data.events[].date	string	No	24.05. - 07.06.
data.events[].end_time	string	No	2026-06-07T13:00:00Z
data.events[].month	string	No	May 2026
data.events[].name	string	No	French Open ATP, clay
data.events[].path	string	No	/tennis/atp-singles/french-open/
data.events[].start_time	string	No	2026-05-24T09:00:00Z
data.events[].winner	string	No	Zverev Alexander
data.events[].winner_path	string	No	/player/zverev-alexander/dGbUhw9m/
data.source_url	string	No	https://2.ds.lsapp.eu/pq_graphql?_hash=scs&projectId=2&sportId=2
data.year	integer	No	2026
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/calendar?category=tennis-atp" \
  -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 season calendar 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 season calendar 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