Get started

API Endpoint

https://apiv3.esports-data-provider.com/
            

The EDP V3 API provides programmatic access to read Esport Data Provider data. Retrieve matches schedules and results, events and more, with filters and many others options.

To use this API, you need an API key. Please follow this link to get your own API key.

Token Usage


curl --location --request GET 'https://apiv3.esports-data-provider.com/matches' \
--header 'token: your_api_key'
                

To get access to EDP V3 API you need to set your API Key as a new header value in your request, with key token :
If you don't have any API Key, please follow this link to get one.



            

HEADER PARAMETERS

Key Value Description
token your_api_key (required) Your API Key must be set to get access to our data

GET Videogames


curl --location --request GET 'https://apiv3.esports-data-provider.com/videogames' \
--header 'token: your_api_key'
                

To get the full list of our supported videogames (LOL, Dota, CSGO ...), with many query parameters to find what you need exactly, use this endpoint :
https://apiv3.esports-data-provider.com/videogames



            

HEADER PARAMETERS

Key Value Description
token your_api_key (required) Your API Key must be set to get access to our data

SEARCH QUERY PARAMETERS

Field Type Description Exemple
id String (optional) Search by unique identifier of a videogame. 6203a721359ca603926185e7
name String (optional) A search parameter to find videogames by name. Counter Strike : Global Offensive
short_name String (optional) A search parameter to find videogames by short name. CS:GO
slug String (optional) A search parameter to find videogames by slug. csgo

PAGINATION AND SORT QUERY PARAMETERS

Field Type Description Exemple
limit String (optional) The maximum number of records (default: 30). 10
skip String (optional) Number of records to skip (useful for pagination). 10
sort String (optional) Sort option to sort by a specific value. name DESC

GET Matches


curl --location --request GET 'https://apiv3.esports-data-provider.com/matches' \
--header 'token: your_api_key'
                

To get the full list of matches, with many query parameters to find what you need exactly, use this endpoint :
https://apiv3.esports-data-provider.com/matches



            

HEADER PARAMETERS

Key Value Description
token your_api_key (required) Your API Key must be set to get access to our data

SEARCH QUERY PARAMETERS

Field Type Description Exemple
id String (optional) Search by unique identifier of a match. 6203a721359ca603926185e7
videogame String (optional) Search parameter to find matches by videogame. 5e28df6ce2d7486852aba9df
date_start String (optional) Search parameter to find matches by date. 2022-02-15T10:00
bo String (optional) Search parameter to find matches by BO. 3
state String (optional) Search parameter to find matches by state (allowed value : planned / cancelled / reported / delayed / starting_soon / started / finished). planned
event String (optional) Search parameter to find matches by event. 5e30781bd14c7036edb20c29

PAGINATION AND SORT QUERY PARAMETERS

Field Type Description Exemple
limit String (optional) The maximum number of records (default: 30). 10
skip String (optional) Number of records to skip (useful for pagination). 10
sort String (optional) Sort option to sort by a specific value. bo DESC

GET Events


curl --location --request GET 'https://apiv3.esports-data-provider.com/events' \
--header 'token: your_api_key'
                

To get the full list of events, with many query parameters to find what you need exactly, use this endpoint :
https://apiv3.esports-data-provider.com/events



            

HEADER PARAMETERS

Key Value Description
token your_api_key (required) Your API Key must be set to get access to our data

QUERY PARAMETERS

Field Type Description Exemple
id String (optional) Search by unique identifier of an event. 6203a721359ca603926185e7
name String (optional) Search parameter to find an event by name. World championship
videogame String (optional) Search parameter to find events by videogame. 5e28df6ce2d7486852aba9df
date_start String (optional) A search date to find events by date. 2022-02-15T10:00
tier String (optional) A search word to find events by tier. 1
state String (optional) A search word to find events by state (allowed value : planned / cancelled / reported / delayed / starting_soon / started / finished). planned

PAGINATION AND SORT QUERY PARAMETERS

Field Type Description Exemple
limit String (optional) The maximum number of records (default: 30). 10
skip String (optional) Number of records to skip (useful for pagination). 10
sort String (optional) Sort option to sort by a specific value. name DESC

GET Teams


curl --location --request GET 'https://apiv3.esports-data-provider.com/teams' \
--header 'token: your_api_key'
                

To get the full list of teams, with many query parameters to find what you need exactly, use this endpoint :
https://apiv3.esports-data-provider.com/teams



            

QUERY PARAMETERS

Field Type Description Exemple
id String (optional) Search by unique identifier of a team. 6203a721359ca603926185e7
name String (optional) Search parameter to find teams by name. Cloud9
short_name String (optional) Search parameter to find teams by short name. C9
slug String (optional) A search parameter to find teams by slug. cloud9
videogame String (optional) Search parameter to find teams by videogame. 5e28df6ce2d7486852aba9df

GET CSGO Result Sample


curl --location --request GET 'https://apiv3.esports-data-provider.com/matches?state=planned&videogame=5e28df8ee2d7486852aba9e0&limit=10' \
--header 'token: your_api_key';
                

A sample to get all League Of Legend schedules.

SAMPLE QUERY PARAMETERS

Field Type Description Exemple
limit String (optional) The maximum number of records (default: 30). 10
skip String (optional) Number of records to skip (useful for pagination). 10
sort String (optional) Sort option to sort by a specific value. name DESC

GET CSGO Result Sample


curl --location --request GET 'https://apiv3.esports-data-provider.com/matches?date_start=2022-02-15T10:00&state=finished&videogame=5e28df6ce2d7486852aba9df&limit=10' \
--header 'token: your_api_key';
                

A sample to get Counter-Strike : Global Offensive results by a specific date.

SAMPLE QUERY PARAMETERS

Field Value
date_start 2022-02-15T10:00
state finished
videogame 5e28df6ce2d7486852aba9df
limit 10

Errors

The EDP V3 API uses the following error names and codes:

Error Error Code Meaning
Bad Request 400 Improper request sended.
Forbidden 403 Your API Key is invalid or expired.