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. |
