Basketball — особенности данных

Баскетбол использует базовую структуру Match без отдельного sport-specific объекта. Все особенности — внутри стандартных полей.

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

⌗Sport Schema Explorer

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

16 спорт-специфичных полей в MatchПрятать неприменимые

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

isCurrentboolean

Признак текущего (актуального) сезона турнира. true ровно у одного сезона в списке.

startDateTimestampinteger

Unix-время (в миллисекундах) начала текущего сезона. Присутствует только у текущего сезона (isCurrent=true).

endDateTimestampinteger

Unix-время (в миллисекундах) окончания текущего сезона. Присутствует только у текущего сезона (isCurrent=true).

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)

matchStatisticsMatchStatisticsPeriod[]

Статистика матча по командам, сгруппированная по периодам. Машинные ключи (key) и их переводы (RU/ES) — в [словаре статистики](https://docs.api-sport.ru/concepts/statistics-dictionary).

periodstring

Период: ALL — за весь матч; либо часть матча в зависимости от вида спорта: тайм (1ST/2ND), четверть (1Q–4Q), период (1ST–3RD), сет/партия (1ST–5TH).

groupsMatchStatisticsGroup[]

Группы статистических показателей.

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 для данного матча

pariboolean

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

marathonboolean

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

betboomboolean

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

oddsBkBookmakerOddsnullable

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

melbetBookmakerOddsData

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

pariBookmakerOddsData

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

marathonBookmakerOddsData

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

betboomBookmakerOddsData

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

attendanceintegernullable

Посещаемость матча (число зрителей), если известна

winnerstringnullable

Исход матча: home — победа хозяев, away — победа гостей, draw — ничья; null — исход ещё не определён

enum: homeawaydraw

winnerCodeintegernullable

Числовой код исхода: 1 — победа хозяев, 2 — победа гостей, 3 — ничья; null — исход ещё не определён

pregamePregameBlocknullable

Предматчевый контекст: очные встречи (h2h), серии команд (teamStreaks) и форма (form). Всегда присутствует в ответе матча по ID; в списках матчей — при параметре `with_pregame=true` или когда `fields` включает `pregame`. null — данных нет

h2hobjectnullable

Дуэли по очным встречам. null — данных нет

teamStreaksobjectnullable

Активные серии команд. null — данных нет

formobjectnullable

Форма команд перед матчем. null — данных нет

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

Лучшие игроки матча (появляются по ходу/по завершении матча). Присутствует в ответе матча по ID; в списках — когда `fields` включает `bestPlayers`. null — данных нет

playerOfTheMatchBestPlayerItemnullable

Игрок матча

homeBestPlayerItem[]

Лучшие игроки хозяев

awayBestPlayerItem[]

Лучшие игроки гостей

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

Score

homeScore: {
  current: 118,
  period1: 28,     // первая четверть
  period2: 26,     // вторая
  period3: 30,
  period4: 26,     // четвёртая
  period5: 8,      // первый овертайм (если был)
  period6: null,   // второй овертайм
  display: "118-115 (OT)"
}

• NBA: 4 четверти × 12 мин + 5-минутные овертаймы.
• FIBA / Euroleague / большинство европейских лиг: 4 четверти × 10 мин + 5-минутные овертаймы.
• period5, period6, period7 — это overtimes (последовательные доп. периоды). API не различает их явно; обычно они идут после четырёх обычных period'ов.

Match.matchStatistics

В баскетболе статистика разбита по периодам: ALL (весь матч) и по четвертям 1Q–4Q (плюс овертайм, если был). Каждый показатель (statisticsItems[]) содержит машинный ключ key, англоязычное name, отображаемые home/away и числовые значения.

Полный список ключей matchStatistics, а также статистики игроков (lineup.players[].statistics) с переводами на русский и испанский — в Словаре статистики.

Match.liveEvents

Только в /v2/basketball/matches/{matchId}. Типы событий:

• field_goal (2 / 3-pt; класс — 2pt / 3pt)
• free_throw
• foul (personal / technical / unsportsmanlike / offensive)
• substitution
• timeout
• period (start, end)

homeTeam.lineup / awayTeam.lineup

Стартовая пятёрка + скамейка. Позиции (поле Player.position / Lineup.players[N].position) различаются от футбольного G/D/M/F:

Слаг	Значение
PG	Point Guard (разыгрывающий)
SG	Shooting Guard (атакующий защитник)
SF	Small Forward (лёгкий форвард)
PF	Power Forward (тяжёлый форвард)
C	Center (центровой)

Базовая схема Player.position декларирует футбольный enum G/D/M/F. Для баскетбола фактические значения отличаются (PG/SG/SF/PF/C). При типизации на клиенте лучше принимать position как string.

Букмекерские коэффициенты

Melbet поддерживает основные баскетбольные рынки: 1×2 без ничьей (ML), тотал очков, гандикап по очкам, чёт/нечёт, тоталы по командам, тоталы по четвертям.

Pari (slug pari) предоставляет базовый набор: исход (ML), фора, тотал.

Marathon (slug marathon) предоставляет: исход, фора, тотал, индивидуальные тоталы команд, тотал чёт/нечёт.

Betboom (slug betboom) предоставляет: исход, фора, тотал.

Связанные ссылки

• API Reference — выберите sportSlug=basketball в каждой operation
• Concepts → Matches