Добро пожаловать в нашу систему API! Следуя этим простым шагам, вы сможете быстро начать работу с нашим API и интегрировать спортивные данные в свою систему.
Получите ключ API, чтобы вы смогли интегрировать данные
Напишите в техническую поддержку и Вам будет выдан уникальный API-ключ и адрес домена для последующих обращений. Этот ключ необходим для авторизации всех запросов к нашему API.
Ознакомьтесь с документацией
После того, как вы получили ключ - Вы можете приступать к Документации API и изучить доступные методы, примеры запросов и ответы. Это поможет вам понять, как интегрировать спортивные данные в вашу систему.
Сделайте первый запрос
Используя свой API-ключ, выполните первый запрос к API. В разделе документации вы найдете примеры запросов и ответов для разных видов спортивных данных.
Начните интеграцию
После успешного выполнения тестового запроса, вы можете приступить к интеграции данных в свой проект. Наше API предоставляет гибкие инструменты для работы с разными видами спорта, событиями.
Получите поддержку
Если у вас возникли вопросы, вы всегда можете обратиться в нашу техническую поддержку или воспользоваться разделом FAQ для решения типичных проблем.
API для спортивной линии предоставляет ограниченный набор методов, которые позволяют получать различные спортивные данные. Ниже приведен список всех доступных методов, каждый из которых возвращает конкретный набор информации для выполнения определенных задач. Вы можете выбрать нужный метод в зависимости от ваших требований. В дополнение к каждому методу можно использовать параметры, которые помогут удобно фильтровать и настраивать получаемые данные. Подробное описание параметров представлено ниже.
menu
Метод возвращает структуру меню спортивных событий, включая виды спорта, страны и чемпионаты.events
Метод возвращает список матчей с кратким набором коэффициентов, доступных для ставок.event
Метод возвращает подробную информацию о конкретном спортивном событии по его идентификатору и полный вариант ставок, шансов и исходов по этому матчу.topmatches
Метод возвращает список топовых матчей, которые наиболее популярны среди пользователей или имеют высокую активность ставок.search
Метод позволяет искать спортивные события по ключевым словам, таким как названия команд.Для работы с нашим API вы можете использовать различные параметры, которые помогут настроить запросы и получить точные данные, соответствующие вашим требованиям. Параметры позволяют фильтровать данные по виду спорта, стране, турнирам, а также настраивать формат возвращаемых событий. Ниже приведен список доступных параметров и их описание, которые помогут вам гибко управлять запросами к нашему API.
API-URL-LINE
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
Ид игрока, который делает подачу (для видов спорта где есть подающие).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, чтобы создать эффективные решения для вашего бизнеса.
Мы предлагаем другие разделы документации для интеграции спортивных решений. Ознакомтесь со списком решений, которые вы можете уже сейчас подключить в свою систему:
Посмотрите цены на услуги спортивной линии, чтобы получить данные по апи всех матчей и коэффициентов
Нужны результаты на матчи? Нажмите на заголовок, чтобы перейти в нужжный раздел.
Мы предоставляем уже готовое решение, которое дает статусы на расчитаные спортивные ставки.