Ласкаво просимо в нашу систему API! Виконуючи ці прості кроки, ви зможете швидко розпочати роботу з нашим API та інтегрувати спортивні дані у вашу систему.
Отримайте ключ API, щоб ви могли інтегрувати дані
Напишіть у технічну підтримку, і вам буде виданий унікальний API-ключ та адреса домену для подальших запитів. Цей ключ необхідний для авторизації всіх запитів до нашого API.
Ознайомтесь із документацією
Після того, як ви отримали ключ - ви можете приступати до Документації API і вивчити доступні методи, приклади запитів і відповіді. Це допоможе вам зрозуміти, як інтегрувати спортивні дані у вашу систему.
Зробіть перший запит
Використовуючи свій API-ключ, виконайте перший запит до API. У розділі документації ви знайдете приклади запитів та відповідей для різних видів спортивних даних.
Розпочніть інтеграцію
Після успішного виконання тестового запиту ви можете розпочати інтеграцію даних у свій проект. Наше API надає гнучкі інструменти для роботи з різними видами спорту та подіями.
Отримайте підтримку
Якщо у вас виникли питання, ви завжди можете звернутися до нашої технічної підтримки або скористатися розділом FAQ для вирішення типових проблем.
API для спортивної лінії надає обмежений набір методів, які дозволяють отримувати різні спортивні дані. Нижче наведено список всіх доступних методів, кожен з яких повертає конкретний набір інформації для виконання певних завдань. Ви можете вибрати потрібний метод залежно від ваших вимог. У доповнення до кожного методу можна використовувати параметри, які допоможуть зручно фільтрувати та налаштовувати отримані дані. Детальний опис параметрів наведено нижче.
menu Метод повертає структуру меню спортивних подій, включаючи види спорту, країни та чемпіонати.events Метод повертає список матчів із коротким набором коефіцієнтів, доступних для ставок.event Метод повертає докладну інформацію про конкретну спортивну подію за її ідентифікатором і повний варіант ставок, шансів та результатів на цей матч.topmatches Метод повертає список топових матчів, які найпопулярніші серед користувачів або мають високу активність ставок.search Метод дозволяє шукати спортивні події за ключовими словами, такими як назви команд.Для роботи з нашим API ви можете використовувати різні параметри, які допоможуть налаштувати запити та отримати точні дані, що відповідають вашим вимогам. Параметри дозволяють фільтрувати дані за видом спорту, країною, турнірами, а також налаштовувати формат повернутих подій. Нижче наведено список доступних параметрів і їх опис, які допоможуть вам гнучко керувати запитами до нашого API.
API-URL-LINE URL-адреса хоста, звідки запитуються дані спортивної лінії. Іншими словами - це URL, куди ви будете звертатися, щоб отримати спортивні дані.API-KEY Персональний ключ доступу PersonalKey, який визначає ваш пакет послуг. Цей ключ передається у заголовках запиту headers при кожному запиті.METHODS-API Назви методів для отримання даних. Усі методи описані у попередньому пункті.TYPE Тип даних спортивної лінії. Може приймати значення live (для даних у режимі реального часу) або line (для передматчевої лінії).LANG Мова, на якій будуть надані дані із спортивної лінії. Підтримувані мови залежать від вашого пакету.SPORT-ID Ідентифікатор виду спорту.COUNTRY-ID Ідентифікатор країни.CHAMPIONSHIP-ID Ідентифікатор турніру.MATCH-ID Ідентифікатор гри.KG Спосіб відображення подій і коефіцієнтів. Доступні два варіанти: sub - матчі групуються за чемпіонатами, list - матчі відображаються звичайним списком без групування.У конкретному матчі групування спрацьовує не матчі, а результати та ставки. Таким чином ви отримуєте список коефіцієнтів, які можуть бути відображені просто списком або зручно згруповані за логічними групами результатів.
У цьому розділі наведено приклад запиту до нашого API для отримання спортивних даних. Приклад демонструє, як можна використовувати один з методів API з вашими унікальними параметрами, такими як API-ключ. Це допоможе вам краще зрозуміти, як правильно формувати запити та отримувати потрібну інформацію.
Дані в прикладі неіснуючі. Заміни їх реальними даними, які отримали від технічної підтримки
GETСхема : [API-URL-LINE] /v1/ [METHODS-API] / [TYPE] / [LANG]
Запит: HTTPS://example-domain-demo.com/v1/menu/live/en
Headers: 'Package': '0145-3455-1298-2978-1100'
import requests
url = "https://example-domain-demo.com/v1/menu/live/en"
payload = {}
headers = {
'Package': '0145-3455-1298-2978-1100'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://example-domain-demo.com/v1/menu/live/en',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => array(
'Package: 0145-3455-1298-2978-1100'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
const myHeaders = new Headers();
myHeaders.append("Package", "0145-3455-1298-2978-1100");
const requestOptions = {
method: "GET",
headers: myHeaders,
redirect: "follow"
};
fetch("https://example-domain-demo.com/v1/menu/live/en", requestOptions)
.then((response) => response.text())
.then((result) => console.log(result))
.catch((error) => console.error(error));
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
.url("https://example-domain-demo.com/v1/menu/live/en")
.method("GET", body)
.addHeader("Package", "0145-3455-1298-2978-1100")
.build();
Response response = client.newCall(request).execute();
Щоб спростити інтеграцію нашого API, ми підготували колекцію запитів для Postman. Ви можете завантажити файл, імпортувати його в Postman і почати роботу з нашим API відразу ж, без необхідності вручну налаштовувати запити.
Кроки для запуску в Postman:
Завантажте колекцію Postman:
Завантажити колекцію для Postman
Імпортуйте файл у Postman:
Налаштуйте змінні:
Після імпорту колекції вам потрібно додати свої API-ключі та інші параметри. Це можна зробити у розділі Variables у колекції або додати їх вручну до кожного запиту.
Запустіть запити:
Тепер ви можете одразу почати відправляти запити та отримувати дані від нашого API.
Відправте цей запит, щоб отримати меню, у якому є всі необхідні дані для подальшого отримання матчів та результатів:
Запити для лінії рекомендується відправляти з інтервалом не менше 40 секунд. Запити для лайву — не менше 20 секунд. Дані оновлюються не дуже часто, тому цього інтервалу буде достатньо для актуальної інформації.
GETСхема : [API-URL-LINE] /v1/ [METHODS-API] / [TYPE] / [LANG]
Запит: HTTPS://example-domain-demo.com/v1/menu/live/en
Headers: 'Package': '0145-3455-1298-2978-1100'
{
"status":1,
"body":[
{
"id":1,
"name":"Football",
"counter":126,
"sub":[
{
"id":12,
"name":"Europe",
"sport_id":1,
"counter":10,
"sub":[
{
"id":118587,
"name":"UEFA Champions League",
"sport_id":1,
"country_id":12,
"counter":3
},
{
"id":218103,
"name":"UEFA Champions League. Winner",
"sport_id":1,
"country_id":12,
"counter":1
},
{
"id":16,
"name":"Italy",
"sport_id":1,
"counter":1,
"sub":[
{
"id":6356,
"name":"Italy. Serie C. Group A",
"sport_id":1,
"country_id":16,
"counter":1
}
]
}
]
}
]
},
{
"id":2,
"name":"Tennis",
"counter":40,
"sub":[
{
"id":14,
"name":"Portugal",
"sport_id":2,
"counter":1,
"sub":[
{
"id":8031,
"name":"Challenger. Braga",
"sport_id":2,
"country_id":14,
"counter":1
}
]
}
]
}
]
}
id Унікальний ідентифікатор елемента (наприклад, вид спорту, країна або чемпіонат).name Назва елемента (наприклад, Football для виду спорту, Europe для країни або UEFA Champions League для чемпіонату).counter Кількість доступних подій або матчів для цього елемента.sub Масив, що містить вкладені елементи, такі як країни або чемпіонати для вибраного виду спорту. Це дозволяє отримати ієрархію даних — від виду спорту до конкретних турнірів.У цьому прикладі:
Ви можете отримати дані про список матчів. Важливо зазначити, що обов'язково потрібно вказати ID виду спорту — можливості отримати всі матчі для всіх видів спорту немає. Ви також можете вибрати, чи потрібні вам матчі в режимі лайв або майбутні події, і вказати додаткові параметри для фільтрації.
У відповіді ви отримаєте всю необхідну інформацію про матчі по виду спорту, який ви вказали.
Усі дані згруповані в зручний об'єкт, який легко інтегрується у вашу систему і дозволяє відображати інформацію в будь-якому форматі.
Щоб отримати список матчів, необхідно надіслати запит на метод events і вказати наступні параметри:
Ці параметри обов'язкові для відправлення. Не забудьте також передати ваш API-ключ у заголовку запиту (Headers).
Відправте цей запит, щоб отримати меню, у якому є всі необхідні дані для подальшого отримання матчів і результатів:
Запити для лінії рекомендується відправляти з інтервалом не менше 20 секунд. Запити для лайву — не менше 5 секунд. Цього інтервалу буде достатньо для актуальної інформації.
GETСхема : [API-URL-LINE] /v1/ events / [SPORT-ID] / [CHAMPIONSHIP-ID] / [KG] / 50 / [TYPE] / [LANG]
Запит: HTTPS://example-domain-demo.com/v1/events/1/0/list/50/live/en
Headers: 'Package': '0145-3455-1298-2978-1100'
Відповідь містить дані про матчі, включаючи інформацію про команди, турніри та коефіцієнти. Нижче описані ключові поля, які повертаються в об'єкті відповіді. Зверніть увагу на різницю даних, що повертаються залежно від типу [KG]
{
"status": 1,
"body": [
{
"sgame_id": "66f8a2d60d8c0bfbf1af3f93",
"stat_id": "66c914530d8c0bfbf15f5682",
"game_id": 562898620,
"game_mid": 562898620,
"game_dop_name": "Extra-Time",
"game_start": 1707807400,
"game_oc_counter": 38,
"country_id": 231,
"country_name": "England",
"tournament_id": 108319,
"tournament_name": "England. FA Cup",
"opp_1_name": "King's Lynn Town",
"opp_2_name": "Worksop Town",
"opp_1_id": 40547,
"opp_2_id": 40549,
"opp_1_icon": "400098.png",
"opp_2_icon": "1201c9f.png",
"sport_name": "Football",
"sport_id": 1,
"score_full": "0:0",
"score_extra": "0:0",
"score_period": "0:0",
"period_name": "3 Half",
"timer": 6511,
"finale": false,
"pitch": null,
"game_oc_list": [
{
"oc_group_name": "Double Chance",
"oc_name": "1X",
"oc_rate": 1.136,
"oc_pointer": "562898620|8|4|0",
"oc_block": false
}
]
}
]
}
{
"status": 1,
"body": [
{
"tournament_id": 8147,
"tournament_name": "Thailand. League Cup",
"events_list": [
{
"sgame_id": 66f8a2d60d8c0bfbf1af3f93,
"stat_id": 3788a2d60d8c0bfbf1af3f93,
"game_id": 562987092,
"game_mid": 562987092,
"game_dop_name": "",
"game_start": 1707856000,
"game_oc_counter": 183,
"country_id": 180,
"country_name": "Thailand",
"tournament_id": 8147,
"tournament_name": "Thailand. League Cup",
"opp_1_name": "ACDC",
"opp_2_name": "Pattaya United",
"opp_1_id": 505873,
"opp_2_id": 4978,
"opp_1_icon": "729aadb95ad1df.png",
"opp_2_icon": "4978.png",
"sport_name": "Football",
"sport_id": 1,
"score_full": "1:1",
"score_extra": "0:0",
"score_period": "1:1;0:0",
"period_name": "2 Half",
"timer": 4451,
"pitch": null,
"finale": false,
"game_oc_list": [
{
"oc_group_name": "1X2",
"oc_name": "W1",
"oc_rate": 8.19,
"oc_pointer": "562987092|1|1|0",
"oc_block": false
},
{
"oc_group_name": "1X2",
"oc_name": "X",
"oc_rate": 1.82,
"oc_pointer": "562987092|1|2|0",
"oc_block": false
}
]
}
]
}
]
}
status Статус запиту. Якщо 1, запит виконано успішно.sgame_id Унікальний ідентифікатор матчу в системі.stat_id Ідентифікатор статистики для матчу.game_id Внутрішній ідентифікатор матчу.game_mid Ідентифікатор субматчу.game_dop_name Додаткова інформація про матч (наприклад, "Extra-Time").game_start Час початку матчу у форматі Unix Timestamp.game_oc_counter Кількість доступних ринків для ставок на цей матч.country_id Ідентифікатор країни, де проводиться матч.country_name Назва країни.tournament_id Ідентифікатор турніру.tournament_name Назва турніру.opp_1_name Назва першої команди.opp_2_name Назва другої команди.opp_1_id Ідентифікатор першої команди.opp_2_id Ідентифікатор другої команди.opp_1_icon Іконка першої команди.opp_2_icon Іконка другої команди.sport_name Назва виду спорту (наприклад, "Football").sport_id Ідентифікатор виду спорту.score_full Повний рахунок матчу.score_extra Рахунок геймів у тенісі.score_period Рахунок за конкретний період.period_name Назва періоду матчу (наприклад, "2 Half").timer Таймер поточного часу матчу в секундах.pitch ID гравця, який робить подачу (для видів спорту, де є подаючі).finale Логічне значення, яке вказує, чи завершено матч.oc_group_name Назва групи ринків (наприклад, "Double Chance").oc_name Назва конкретного результату (наприклад, "1X").oc_rate Коефіцієнт на цей результат.oc_pointer Унікальний ідентифікатор результату.oc_block Логічне значення, яке вказує, чи заблокований результат (якщо true — результат заблокований і недоступний для ставок).Метод для отримання детальної інформації про конкретний матч. Цей метод дозволяє запросити інформацію про конкретний матч, включаючи команди, результати, поточний стан матчу та доступні ставки. Використовується для отримання актуальних даних по конкретній грі.
Запити для лінії рекомендується відправляти з інтервалом не менше 20 секунд. Запити для лайву — не менше 5 секунд. Цього інтервалу буде достатньо для актуальної інформації.
GETСхема : [API-URL-LINE] /v1/ event / [GAME-ID] / [KG] / [TYPE] / [LANG]
Запит: HTTPS://example-domain-demo.com/v1/event/45566556/sub/live/en
Headers: 'Package': '0145-3455-1298-2978-1100'
Відповідь містить дані про один конкретний матч, включаючи інформацію про повне відображення результатів і шансів на цей матч. У конкретному матчі ви можете отримати абсолютно всі шанси і коефіцієнти на матч. Нижче описані ключові поля, які повертаються в об'єкті відповіді. Зверніть увагу на різницю даних, які повертаються залежно від типу [KG]. Вони впливають тепер на групування ставок і шансів для ставок.
"Відповідь включає тільки ті поля, які відрізняються від запиту списку матчів. Ось їх опис:
stat_list Массив, що містить інформацію по лайв-статистиці, такій як кутові, атаки, картки, небезпечні атаки та інші показники.
sub_games Список ідентифікаторів, за якими можна отримати додаткові ринки ставок. Наприклад, ви можете запросити шанси і результати ставок тільки для 2-го тайму або кутових ударів.
game_oc_list Цей список може містити або всі результати і шанси в одному масиві, або бути згрупованим за категоріями для зручної інтеграції у вашу систему."
{
"status": 1,
"body": {
"game_oc_list": [
{
"group_id": 1,
"group_name": "1X2",
"columns": 3,
"oc_list": [
{
"oc_group_name": "1X2",
"oc_name": "W1",
"oc_rate": 1.245,
"oc_size": 0,
"oc_pointer": "563034215|1|1|0",
"oc_block": false
},
{
"oc_group_name": "1X2",
"oc_name": "X",
"oc_rate": 5.48,
"oc_size": 0,
"oc_pointer": "563034215|1|2|0",
"oc_block": false
},
{
"oc_group_name": "1X2",
"oc_name": "W2",
"oc_rate": 7.97,
"oc_size": 0,
"oc_pointer": "563034215|1|3|0",
"oc_block": false
}
]
},
{
"group_id": 2,
"group_name": "Handicap",
"columns": 2,
"oc_list": [
{
"oc_group_name": "Handicap",
"oc_name": "1 (-1.5)",
"oc_rate": 1.904,
"oc_size": -1.5,
"oc_pointer": "563034215|2|7|-1.5",
"oc_block": false
},
{
"oc_group_name": "Handicap",
"oc_name": "1 (0)",
"oc_rate": 1.06,
"oc_size": 0,
"oc_pointer": "563034215|2|7|0",
"oc_block": false
},
{
"oc_group_name": "Handicap",
"oc_name": "2 (0)",
"oc_rate": 6.02,
"oc_size": 0,
"oc_pointer": "563034215|2|8|0",
"oc_block": false
},
{
"oc_group_name": "Handicap",
"oc_name": "2 (+1.5)",
"oc_rate": 1.76,
"oc_size": 1.5,
"oc_pointer": "563034215|2|8|1.5",
"oc_block": false
}
]
}
],
"stat_list": [
{
"id": 45,
"name": "Attacks",
"opp1": "22",
"opp2": "28"
},
{
"id": 58,
"name": "Dangerous attacks",
"opp1": "13",
"opp2": "25"
},
{
"id": 29,
"name": "Possession %",
"opp1": "45",
"opp2": "55"
},
{
"id": 59,
"name": "Shots on target",
"opp1": "3",
"opp2": "2"
},
{
"id": 60,
"name": "Shots off target",
"opp1": "2",
"opp2": "2"
},
{
"id": 26,
"name": "Yellow cards",
"opp1": "0",
"opp2": "0"
},
{
"id": 70,
"name": "Corner",
"opp1": "0",
"opp2": "3"
},
{
"id": 71,
"name": "Red card",
"opp1": "0",
"opp2": "0"
},
{
"id": 72,
"name": "Penalty",
"opp1": "0",
"opp2": "0"
}
],
"sub_games": [
{
"game_id": 563034216,
"game_num": 48560,
"game_name": "1st half"
},
{
"game_id": 563034217,
"game_num": 48561,
"game_name": "2nd half"
},
{
"game_id": 563034286,
"game_num": 42676,
"game_name": "Result + Total"
}
]
}
}
Відправте цей запит, щоб отримати топові матчі. Запит повертає список всіх топових матчів по всіх видах спорту.
Запити для лінії рекомендується відправляти з інтервалом не менше 20 секунд. Запити для лайву — не менше 5 секунд. Цього інтервалу буде достатньо для актуальної інформації.
GETСхема : [API-URL-LINE] /v1/ topmatches / [TYPE] / [LANG]
Запит: HTTPS://example-domain-demo.com/v1/topmatches/live/en
Headers: 'Package': '0145-3455-1298-2978-1100'
Якщо вам потрібно здійснити пошук на сайті за командами, ви можете скористатися запитом на пошук.
Схема : [API-URL-LINE] /v1/ search / [TYPE] / [LANG] / [COMAND-NAME]
Запит: HTTPS://example-domain-demo.com/v1/search/live/en/realmadrid
Headers: 'Package': '0145-3455-1298-2978-1100'
{
"status": 1,
"page": "/v1/events",
"body": [
{
"game_id": 563038643,
"dtype": "live",
"opp1": "Real Madrid (Kimmich_8143)",
"opp2": "Bayern Munich (Mata_8254)",
"champname": "FIFA 24. Cyber League",
"sportname": "Football",
"gamestart": 1707871900
},
{
"game_id": 563043348,
"dtype": "live",
"opp1": "Lille OSC U19",
"opp2": "Real Madrid U19",
"champname": "UEFA Youth League",
"sportname": "Football",
"gamestart": 1707874000
},
{
"game_id": 563046811,
"dtype": "live",
"opp1": "Real Madrid (Mevis)",
"opp2": "Chelsea (Mick)",
"champname": "FIFA 23. Volta daily league",
"sportname": "Football",
"gamestart": 1707874485
},
{
"game_id": 563043227,
"dtype": "live",
"opp1": "Real Madrid",
"opp2": "Bayern",
"champname": "FIFA18. Penalty",
"sportname": "FIFA",
"gamestart": 1707874900
}
]
}
Інтеграція з нашим API спортивної лінії надає доступ до актуальної інформації про види спорту, матчі, турніри та шанси. Ми намагаємось зробити процес інтеграції максимально простим і зручним, надаючи детальну документацію та приклади запитів. Якщо у вас виникнуть питання або знадобиться допомога, наша команда технічної підтримки завжди готова вам допомогти. Скористайтеся можливостями API, щоб створити ефективні рішення для вашого бізнесу.
Ми пропонуємо інші розділи документації для інтеграції спортивних рішень. Ознайомтеся зі списком рішень, які ви вже зараз можете підключити у свою систему:
Перегляньте ціни на послуги спортивної лінії, щоб отримати дані за апі всіх матчів і коефіцієнтів.
Потрібні результати на матчі? Натисніть на заголовок, щоб перейти до потрібного розділу.
Ми надаємо вже готове рішення, яке дає статуси на розраховані спортивні ставки.
