Sport-specific данные

REST API использует единую базовую структуру Match, общую для всех 7 видов спорта. Каждый вид добавляет к ней свои специфичные поля и интерпретирует общие поля по-своему — например, что именно лежит в homeScore.period1 или какие группы появляются в matchStatistics[].

Чтобы корректно распарсить ответ для своего вида спорта, держите рядом две вещи:

• Базовая Match-структура — Concepts → Matches.
• Эта секция — расхождения и расширения для конкретного спорта.

Ниже — интерактивное дерево: переключайте вид спорта, чтобы увидеть, какие поля Match и SeasonDetails появляются, приглушаются или меняют смысл. Это канонический список полей (синхронизирован со спекой); таблица и правила под ним объясняют детали и интерпретацию.

⌗Sport Schema Explorer

Выберите вид спорта — поля, специфичные для него, подсветятся и раскроются; неприменимые приглушатся. Поля без бейджей — общие для всех видов спорта.

Прятать неприменимые

idinteger

Уникальный идентификатор матча

statusstring

Статус матча

enum: notstartedinprogressfinishedcanceledpostponedinterruptedsuspendeddelayedwillcontinue

statusDescriptionstringnullable

Человекочитаемое описание статуса матча

dateEventstring

Дата события

startTimestampinteger

Время начала матча в миллисекундах

currentMatchMinuteinteger

Текущая минута матча

currentMatchSecondinteger

Текущая секунда матча (в пределах минуты)

overtimeLengthinteger

Добавленное время в секундах. Присутствует только когда оно есть.

tournamentTournamentBrief

idinteger

ID турнира

namestring

Название турнира

translationsobject

imagestring

URL изображения турнира

categoryCategoryBrief

idinteger

ID категории

namestring

Название категории

translationsobject

imagestring

URL изображения

roundInfoRoundInfo

namestring

Название раунда

roundinteger

Номер раунда

seasonSeasonBrief

idinteger

namestring

yearstring

venueVenue

idintegernullable

ID стадиона

namestringnullable

Название стадиона

translationsobject

capacityintegernullable

Вместимость

cityobject

countryobject

refereeReferee⚽Футбол

idintegernullable

ID арбитра

namestring

Имя арбитра

yellowCardsinteger

Количество жёлтых карточек показанных арбитром (статистика)

redCardsinteger

Количество красных карточек показанных арбитром (статистика)

yellowRedCardsinteger

Количество вторых жёлтых карточек показанных арбитром (статистика)

gamesinteger

Количество игр проведённых арбитром (статистика)

countryobject

translationsobject

homeTeamTeamWithLineup

idintegernullable

Уникальный идентификатор команды

namestringnullable

Название команды

fullNamestringnullable

Полное название команды

translationsobject

genderstringnullable

Пол команды

enum: MF

countrystringnullable

Название страны

managerManagernullable

Тренер команды; null, если не задан.

imagestring

URL изображения команды

lineupLineupnullable⚽Футбол🏒Хоккей🏀Баскетбол🏐Волейбол

Состав команды на матч; null, если состав недоступен.

awayTeamTeamWithLineup

idintegernullable

Уникальный идентификатор команды

namestringnullable

Название команды

fullNamestringnullable

Полное название команды

translationsobject

genderstringnullable

Пол команды

enum: MF

countrystringnullable

Название страны

managerManagernullable

Тренер команды; null, если не задан.

imagestring

URL изображения команды

lineupLineupnullable⚽Футбол🏒Хоккей🏀Баскетбол🏐Волейбол

Состав команды на матч; null, если состав недоступен.

homeScoreScore

currentinteger

Текущий счет

period1integer

Счет в первом тайме

✦ Значение зависит от вида спорта: тайм (футбол), период (хоккей), четверть (баскетбол), геймы в сете (теннис, наст. теннис), очки в партии (волейбол), счёт в карте (киберспорт)

period2integer

Счет во втором тайме / геймы во 2-м сете (теннис)

period3integernullable

Счет в третьем периоде / геймы в 3-м сете (теннис)

period4integernullable

Счет в четвертом периоде / геймы в 4-м сете (теннис, Grand Slam)

period5integernullable

Счет в пятом периоде / геймы в 5-м сете (теннис, Grand Slam)

period6integernullable🏀Баскетбол🏓Настольный теннис

Счёт в 6-м периоде: 2-й овертайм (баскетбол) или геймы в 6-м сете (наст. теннис, best-of-7). При множественных овертаймах возможны и дальнейшие периоды (period7+) — редко.

period7integernullable🏀Баскетбол🏓Настольный теннис

Счёт в 7-м периоде: 3-й овертайм (баскетбол) или геймы в 7-м сете (наст. теннис, best-of-7).

period1TieBreakintegernullable🎾Теннис

Очки в тайбрейке 1-го сета (только теннис, только если был тайбрейк)

period2TieBreakintegernullable🎾Теннис

Очки в тайбрейке 2-го сета (только теннис, только если был тайбрейк)

period3TieBreakintegernullable🎾Теннис

Очки в тайбрейке 3-го сета (только теннис, только если был тайбрейк)

period4TieBreakintegernullable🎾Теннис

Очки в тайбрейке 4-го сета (только теннис, только если был тайбрейк)

period5TieBreakintegernullable🎾Теннис

Очки в тайбрейке 5-го сета (только теннис, только если был тайбрейк)

penaltiesintegernullable⚽Футбол🏒Хоккей

Счёт по послематчевым пенальти. Присутствует только если была серия пенальти.

displaystringnullable

Текстовое представление счёта, как отдаёт источник (например, "2-2 (5-4 pen.)" в футболе или "3 (6-4, 4-6, 7-6)" в теннисе).

pointstringnullable🎾Теннис

Текущее очко в теннисном гейме (для live-матчей). Значения: "0", "15", "30", "40", "A" (advantage) для обычных геймов, или числа "0"-"7"+ для тайбрейков

awayScoreScore

currentinteger

Текущий счет

period1integer

Счет в первом тайме

✦ Значение зависит от вида спорта: тайм (футбол), период (хоккей), четверть (баскетбол), геймы в сете (теннис, наст. теннис), очки в партии (волейбол), счёт в карте (киберспорт)

period2integer

Счет во втором тайме / геймы во 2-м сете (теннис)

period3integernullable

Счет в третьем периоде / геймы в 3-м сете (теннис)

period4integernullable

Счет в четвертом периоде / геймы в 4-м сете (теннис, Grand Slam)

period5integernullable

Счет в пятом периоде / геймы в 5-м сете (теннис, Grand Slam)

period6integernullable🏀Баскетбол🏓Настольный теннис

Счёт в 6-м периоде: 2-й овертайм (баскетбол) или геймы в 6-м сете (наст. теннис, best-of-7). При множественных овертаймах возможны и дальнейшие периоды (period7+) — редко.

period7integernullable🏀Баскетбол🏓Настольный теннис

Счёт в 7-м периоде: 3-й овертайм (баскетбол) или геймы в 7-м сете (наст. теннис, best-of-7).

period1TieBreakintegernullable🎾Теннис

Очки в тайбрейке 1-го сета (только теннис, только если был тайбрейк)

period2TieBreakintegernullable🎾Теннис

Очки в тайбрейке 2-го сета (только теннис, только если был тайбрейк)

period3TieBreakintegernullable🎾Теннис

Очки в тайбрейке 3-го сета (только теннис, только если был тайбрейк)

period4TieBreakintegernullable🎾Теннис

Очки в тайбрейке 4-го сета (только теннис, только если был тайбрейк)

period5TieBreakintegernullable🎾Теннис

Очки в тайбрейке 5-го сета (только теннис, только если был тайбрейк)

penaltiesintegernullable⚽Футбол🏒Хоккей

Счёт по послематчевым пенальти. Присутствует только если была серия пенальти.

displaystringnullable

Текстовое представление счёта, как отдаёт источник (например, "2-2 (5-4 pen.)" в футболе или "3 (6-4, 4-6, 7-6)" в теннисе).

pointstringnullable🎾Теннис

Текущее очко в теннисном гейме (для live-матчей). Значения: "0", "15", "30", "40", "A" (advantage) для обычных геймов, или числа "0"-"7"+ для тайбрейков

liveEventsLiveEvent[]⚽Футбол🏒Хоккей🏀Баскетбол🏐Волейбол🏓Настольный теннис

timeinteger

Время события в минутах

timeSecondsinteger

Время события в секундах

typestring

Тип события

enum: cardgoalsubstitutioninGamePenaltypenaltyShootoutvarDecisioninjuryTimeperiod

classstring

Класс события

teamstring

Команда события

enum: homeaway

playerobject

playerInobject

Игрок входящий (для замен)

playerOutobject

Игрок выходящий (для замен)

reasonstring

Причина события

fromstring

Откуда (например, penalty для гола)

homeScoreinteger

Счет хозяев после события

awayScoreinteger

Счет гостей после события

periodintegernullable

Номер периода/тайма, к которому относится событие

descriptionstring

Текстовое описание события (если есть)

playerNamestring

Имя игрока, связанного с событием (дублирует player.name для удобства)

assist1Namestring

Имя игрока, сделавшего первый ассист (голы)

assist2Namestring

Имя игрока, сделавшего второй ассист (голы)

managerobject

Тренер/официальное лицо — для карточки, показанной не игроку (type=card)

rescindedboolean

Карточка отменена (type=card)

playerInNamestring

Имя вышедшего на замену игрока (type=substitution)

playerOutNamestring

Имя заменённого игрока (type=substitution)

injuryboolean

Замена из-за травмы (type=substitution)

sequenceintegernullable

Порядковый номер удара в серии пенальти (type=penaltyShootout)

confirmedbooleannullable

Подтверждено ли решение VAR (type=varDecision)

addedTimeinteger

Добавленное время в минутах (type=injuryTime / varDecision)

lengthintegernullable

Длительность добавленного времени (type=injuryTime)

textstring

Текст метки периода, напр. начало/конец тайма (type=period)

isLiveboolean

Идёт ли период в данный момент (type=period)

matchStatisticsobject[]

Статистика матча

oddsBaseOddsMarket[]

Доступные коэффициенты для матча

namestring

Название рынка ставок

groupstring

Группа ставки

periodstring

Период матча для ставки

isLiveboolean

Доступна ли ставка в live режиме

suspendedboolean

Приостановлена ли ставка

choicesOddsChoice[]

Варианты ставок с коэффициентами

highlightsHighlight[]

Видео / хайлайты матча

titlestring

Название видео/хайлайта

urlstring

URL видео (обычно YouTube)

imagestring

URL изображения превью видео

esportsEsportsDatanullable🎮Киберспорт

Детальные данные по киберспортивному матчу. Присутствует только для матчей с sportSlug=esports (CS2, Dota 2, League of Legends). Содержит информацию о каждой игре серии, индивидуальную статистику игроков, раунды (CS2), баны героев/чемпионов (Dota 2, LoL) и командную статистику.

bestOfintegernullable

Формат серии — максимальное количество игр (например, 1, 3 или 5). Best of 3 означает, что для победы нужно выиграть 2 игры из 3.

gamesEsportsGame[]

Список отдельных игр (карт) в серии. Каждая игра содержит счёт, статистику игроков, раунды (CS2) или баны (Dota 2/LoL).

tennisTennisDatanullable🎾Теннис

Детальные данные по теннисному матчу. Присутствует только для матчей с sportSlug=tennis. Содержит информацию о сетах (геймы, тайбрейки, длительность, победитель), подаче, посеве игроков, типе покрытия и momentum-графике. При запросе одного матча (/matches/{matchId}) также включает point-by-point данные с детализацией каждого очка.

bestOfintegernullable

Формат матча — максимальное количество сетов (3 или 5). Best of 3 — для WTA и большинства ATP турниров, Best of 5 — для мужских Grand Slam.

groundTypestringnullable

Тип покрытия корта

enum: Hardcourt outdoorHardcourt indoorClayGrass

firstToServestringnullable

Кто подаёт первым в матче

enum: homeaway

homePlayerSeedstringnullable

Посев (seed) домашнего игрока в турнире. Посев определяет рейтинг игрока в сетке турнира.

awayPlayerSeedstringnullable

Посев (seed) гостевого игрока в турнире

setsTennisSet[]nullable

Детализация по сыгранным сетам. Каждый элемент содержит количество геймов, победителя, длительность и данные тайбрейка (если был).

momentumTennisMomentumItem[]nullable

График импульса (momentum) матча. Показывает доминирование одного из игроков в каждом гейме. Положительные значения — доминирование домашнего игрока, отрицательные — гостевого.

pointByPointTennisPointByPointSet[]nullable

Подробные данные по каждому очку матча, сгруппированные по сетам и геймам. Доступно только при запросе одного матча (/matches/{matchId}). Содержит тип каждого розыгрыша (эйс, двойная ошибка, виннер) и текущий счёт.

hasBkOddsobject

Наличие букмекерских коэффициентов по каждому букмекеру. Всегда присутствует в ответе

melbetboolean

Есть ли коэффициенты букмекера Melbet для данного матча

oddsBkBookmakerOddsnullable

Букмекерские коэффициенты. Присутствует только при with_bk_odds=true. Ключи объекта — идентификаторы букмекеров (например 'melbet'). Если with_bk_odds не указан, поле отсутствует

melbetBookmakerOddsData

Коэффициенты букмекера Melbet

required обязательноеnullable может быть null без бейджа спорта — поле общее для всех 7 видов

Кратко по всем спортам

Спорт	Доп. объект в Match	Score periods	Live-события	Особое
Football	—	period1, period2, period3 (OT), penalties	Голы, карточки, замены, пенальти, VAR	referee, насыщенный matchStatistics
Ice Hockey	—	period1–period3, OT, shootout	Голы, штрафы, замены	—
Basketball	—	period1–period4, OT (period5+)	Броски, фолы, тайм-ауты	По-четвертная разбивка статистики
Tennis	tennis: TennisData	period1–period5 (сеты), point, tiebreak в periodNTieBreak	—	pointByPoint только в single-match endpoint
Table Tennis	—	period1–period5+ (сеты до 11)	—	Минимальная структура
Volleyball	—	period1–period5 (сеты)	—	Sport-specific поля в разработке
Esports	esports: EsportsData	На уровне games (CS2: раунды → period1/period2; Dota 2/LoL: kills)	Нет массива liveEvents — live-данные в esports.games[*]	CS2 / Dota 2 / LoL — разная структура EsportsGame

Когда поля отсутствуют

Чтобы не «накручивать» обработку с try/except, держите следующие правила:

• Match.tennis — присутствует только у tennis-матчей; размечено x-sports: ["tennis"]. В API Reference поле видно всегда (единый бандл), а Sport Schema Explorer приглушает его для остальных видов.
• Match.esports — присутствует только у esports-матчей; размечено x-sports: ["esports"]. Механика та же.
• Match.referee — заполняется у football. Для остальных может быть пустым / отсутствовать.
• Match.liveEvents — приходит только в детальном эндпоинте /v2/{sportSlug}/matches/{matchId}. В списке матчей поле пустое или отсутствует.
• tennis.pointByPoint — приходит только в /v2/tennis/matches/{matchId} (детальный матч). В списке GET /v2/tennis/matches поле опускается.

Связанные концепции

• Concepts → Matches — общая структура Match.
• Concepts → Bookmaker Odds — oddsBase vs oddsBk.
• WebSocket → Snapshot vs Delta — какие sport-specific поля приходят в match_delta.