Статистика матча и игроков — словарь
Статистика матча приходит в двух местах ответа Match:
matchStatistics— командная статистика матча, сгруппированная по периодам ([{ period, groups: [{ groupName, statisticsItems: [...] }] }]). Каждый показатель (statisticsItems[]) содержит машинный ключkey, англоязычноеname, отображаемые строкиhome/away, числовыеhomeValue/awayValueи, для метрик вида «выполнено/попыток»,homeTotal/awayTotal.homeTeam.lineup.players[].statisticsиawayTeam.lineup.players[].statistics— индивидуальная статистика игрока в матче: плоский объектключ → число.
Значения отдаются «как есть» (raw). Чтобы показать их пользователю на нужном языке, сопоставьте
key (для командной статистики) или имя поля (для статистики игрока) со словарём ниже — значения
ключей в словаре совпадают буква-в-букву с тем, что приходит в ответе API.
Какие виды спорта что отдают
- Статистика игроков (
lineup.players[].statistics) приходит только для football, ice-hockey, basketball. В волейболе у игроков индивидуальной статистики нет, а в теннисе и настольном теннисе составов нет вовсе (игрок = команда), поэтому для них есть только команднаяmatchStatistics. - Командная
matchStatisticsприходит для всех видов спорта, кроме киберспорта, но набор показателей и количество периодов различаются (тайм/четверть/период/партия) — и зависят не только от вида спорта, но и от лиги, см. Покрытие зависит от лиги. - Киберспорт (CS2, Dota 2, LoL):
matchStatistics— пустой массив. Статистика игроков приходит по каждой игре (карте) серии — вesports.games[].homeTeamPlayers[]иesports.games[].awayTeamPlayers[]; показатели — поля самого объекта игрока (kills,deaths,assists, …), а не вложенный объектstatistics. Командные счётчики игры — вesports.games[].statistics. Подробнее — Sport-specific → Esports.
В хоккее часть ключей командной статистики записана с заглавной буквы (Shots, Hits, Blocked,
Takeaways, Giveaways, SuspensionMinutes, PowerPlayPercentage, FaceOffWinPercentage,
FaceOffsWon, GoalsInPowerplayScored, GoalsShortHandedScored, PenaltiesAccuracy,
PenaltiesTotal, MaxGoals) — сопоставляйте ключи точно, с учётом регистра.
В объекте player.statistics помимо числовых показателей может присутствовать служебное поле
statisticsType — это метаинформация, а не показатель; в словарь она не входит.
Покрытие зависит от лиги
Словарь ниже — объединение всех ключей, которые встречались у вида спорта в разных матчах, лигах и сезонах, а не гарантированный набор для каждого матча: в конкретном матче приходит только часть этих ключей. Какие ключи придут, по каким периодам и насколько полными будут значения, зависит от лиги: у каждой лиги свой поставщик статистики. Значения отдаются как есть: API их не пересчитывает и не дополняет, поэтому неполные данные остаются неполными и в ответе. Часть лиг дорабатывает статистику уже после матча, поэтому завершённые матчи всех видов спорта (вместе со статистикой матча и статистикой игроков в составах) повторно запрашиваются у источника через несколько часов после окончания и ещё раз через двое суток — в ответ попадают уточнённые значения.
Кроме того, источник не передаёт строку показателя, если у обеих команд он равен 0. Например, если
в матче никого не удалили, строки redCards в matchStatistics не будет. Поэтому отсутствие ключа
в ответе означает либо ноль у обеих команд, либо то, что по этой лиге показатель не передаётся.
Ниже — фактическое покрытие завершённых матчей по состоянию на октябрь 2026 года. В скобках
после названия лиги — её tournament.id в ответе API.
Хоккей
| Лига | Командная статистика (matchStatistics) | Периоды | Статистика игроков | Вбрасывания | Shots (броски в створ) |
|---|---|---|---|---|---|
| NHL (234) | Полный набор, 30+ ключей: Shots, Hits, Blocked, Takeaways, Giveaways, FaceOffWinPercentage, PowerPlayPercentage, corsiPct, fenwickPct, голы по типам бросков и др. | ALL, 1ST, 2ND, 3RD (+ OT1, OT2 при овертаймах) | Есть, 36 ключей: faceOffWins/faceOffTaken, hits, blocked, saves, secondsPlayed и др. | Есть | Надёжные |
| КХЛ (268) | Сезон 2026/27: Shots, puckPossession, suspensions, SuspensionMinutes, PowerPlayPercentage, иногда saves. Сезон 2025/26: Shots, SuspensionMinutes, MaxGoals, GoalsInPowerplayScored, GoalsShortHandedScored, PenaltiesAccuracy | 2026/27 — только ALL; 2025/26 — ALL + 1ST/2ND/3RD | Только goals, assists, shots, points, plusMinus, penaltyMinutes, penaltyCount; в лайве shots часто равен числу голов | Нет | Итоговые после уточнения; в лайве неполные |
| ВХЛ (1141), МХЛ (1159) | Сезон 2026/27: Shots, SuspensionMinutes | Только ALL | Нет (составы не передаются) | Нет | Правдоподобные |
| Liiga (134), Экстралига Чехии (237) | Как в КХЛ 2026/27: Shots, puckPossession, suspensions, SuspensionMinutes, PowerPlayPercentage, иногда saves | Только ALL | Как в КХЛ | Нет | Как в КХЛ: у новых матчей уточняются после завершения; история не перечитывалась |
| Остальные лиги | Обычно только SuspensionMinutes или статистики нет | Не гарантируются | Как правило, нет | Как правило, нет | — |
Набор периодов и ключей может меняться между сезонами вместе с поставщиком статистики лиги: у КХЛ, ВХЛ
и МХЛ в сезоне 2025/26 статистика приходила за весь матч и по периодам (ALL + 1ST/2ND/3RD) с
другим набором ключей, а в 2026/27 — только за весь матч (ALL).
В лайве и на финальной сирене статистика КХЛ неполная: у одной из команд бывает меньше 15 бросков в
створ (Shots), иногда столько же, сколько голов; то же касается shots в статистике игроков.
Итоговые значения источник публикует позже, поэтому статистика матча и статистика игроков в составах
уточняются в течение нескольких часов после завершения и повторно через двое суток — уточнения
приходят в REST и дельтами WebSocket. API
передаёт значения источника как есть и не пересчитывает их. Показателей вбрасываний
(FaceOffWinPercentage, FaceOffsWon, faceOffWins, faceOffTaken) для КХЛ по-прежнему нет — ни в
сезоне 2026/27, ни в 2025/26.
Футбол
В топ-лигах (АПЛ, Ла Лига, Серия A, Бундеслига, Лига 1, РПЛ, Лига чемпионов УЕФА, Чемпионшип, MLS,
Серия A Бразилии, Эредивизи, Лига Португалии, Суперлига Турции, Про-лига Саудовской Аравии, Лига MX
и др.) командная статистика есть практически у всех завершённых матчей — около 45–50 ключей,
включая throwIns, offsides, fouls, totalShotsOnGoal, shotsOnGoal, shotsOffGoal,
blockedScoringAttempt, goalKicks, cornerKicks, freeKicks, ballPossession,
expectedGoals, goalkeeperSaves, passes, totalTackle. Статистика игроков в составах — тоже
практически у всех матчей. В Лиге Европы и Лиге конференций УЕФА статистика игроков и xG
(expectedGoals) есть примерно у 40–70% матчей. В любительских и низших лигах статистики часто нет
совсем.
Замены — не показатель статистики: они приходят событиями матча в liveEvents (тип
substitution). Данных о выходе медиков на поле источник не передаёт.
throwIns— ауты (в словаре — «Вбрасывания», это название источника);totalShotsOnGoal— все удары;shotsOnGoal— удары в створ;shotsOffGoal— удары мимо;goalKicks— удары от ворот.
Киберспорт
Командной matchStatistics нет, статистика игроков — по каждой игре (карте) серии в
esports.games[].homeTeamPlayers[] / awayTeamPlayers[]. В CS2 это kills, deaths, assists,
headshots, adr, kast, flashAssists, firstKillsDiff, kdDiff; в Dota 2 и LoL — свой набор
полей (goldPerMin, lastHits, minionsKilled и др., см. Sport-specific → Esports).
Разбивки убийств по оружию и гранатам (AWP, молотов, HE) источник не передаёт.
Эндпоинт
Тот же словарь доступен как статический файл — https://api.api-sport.ru/v2/StatisticsDict.json (не требует авторизации). Удобно подгрузить его один раз и кэшировать на стороне клиента:
curl https://api.api-sport.ru/v2/StatisticsDict.json
Справочник показателей
Выберите вид спорта. В таблицах — машинный ключ (key), англоязычное название и переводы на
русский и испанский; для командной статистики дополнительно указана группа. Справочник объединяет
ключи всех лиг: какие из них приходят в конкретной лиге — см. Покрытие зависит от лиги.
Статистика матча (команды)
51 / 51| key | EN | RU | ES | Группа |
|---|---|---|---|---|
accurateCross | Crosses | Кроссы | Centros | Passes |
accurateLongBalls | Long balls | Длинные мячи | Balones largos | Passes |
accuratePasses | Accurate passes | Точные пасы | Pases precisos | Passes |
accurateThroughBall | Through balls | Проникающие передачи | Pases en profundidad | Attack |
aerialDuelsPercentage | Aerial duels | Воздушные дуэли | Duelos aéreos | Duels |
avgRating | Average rating | Средний рейтинг | Valoración media | Match overview |
ballPossession | Ball possession | Владение мячом | Posesión del balón | Match overview |
ballRecovery | Recoveries | Возвраты | Recuperaciones | Defending |
bigChanceCreated | Big chances | Голевые моменты | Ocasiones claras | Match overview |
bigChanceMissed | Big chances missed | Упущенные голевые моменты | Ocasiones claras falladas | Attack |
bigChanceScored | Big chances scored | Реализованные голевые моменты | Ocasiones claras convertidas | Attack |
blockedScoringAttempt | Blocked shots | Блокирование ударов | Tiros bloqueados | Shots |
cornerKicks | Corner kicks | Угловые | Córners | Match overview |
dispossessed | Dispossessed | Потери мяча (отбор соперником) | Pérdidas de balón | Duels |
diveSaves | Big saves | Большие сэйвы | Paradas de mérito | Goalkeeping |
dribblesPercentage | Dribbles | Дриблинг | Regates | Duels |
duelWonPercent | Duels | Единоборства | Duelos | Duels |
errorsLeadToGoal | Errors leading to goal | Ошибки, приведшие к голу | Errores que provocan gol | Defending |
errorsLeadToShot | Errors leading to shot | Ошибки, приведшие к удару | Errores que provocan tiro | Defending |
expectedGoals | Expected goals (xG) | Ожидаемые голы (xG) | Goles esperados (xG) | Match overview |
expectedGoalsOnTarget | Expected goals on target (xGOT) | Ожидаемые голы в створ (xGOT) | Goles esperados a puerta (xGOT) | Shots |
finalThirdEntries | Final third entries | Входы на чужую треть | Entradas al último tercio | Passes |
finalThirdPhaseStatistic | Final third phase | Пасы в финальной трети | Fase de último tercio | Passes |
fouledFinalThird | Fouled in final third | Фол в финальной трети | Faltas recibidas en el último tercio | Attack |
fouls | Fouls | Фолы | Faltas | Match overview |
freeKicks | Free kicks | Свободные удары | Tiros libres | Match overview |
goalkeeperSaves | Goalkeeper saves | Отбито вратарем | Paradas del portero | Match overview |
goalKicks | Goal kicks | Удары от ворот | Saques de puerta | Goalkeeping |
goalsPrevented | Goals prevented | Предотвращённые голы | Goles evitados | Goalkeeping |
groundDuelsPercentage | Ground duels | Борьба за позицию | Duelos en el suelo | Duels |
highClaims | High claims | Перехват навесов | Despejes de balones aéreos | Goalkeeping |
hitWoodwork | Hit woodwork | Удары в штангу | Tiros al palo | Shots |
interceptionWon | Interceptions | Перехваты | Intercepciones | Defending |
kilometersCovered | Distance covered | Пройденная дистанция | Distancia recorrida | Match overview |
numberOfSprints | Number of sprints | Количество спринтов | Número de sprints | Match overview |
offsides | Offsides | Офсайды | Fueras de juego | Attack |
passes | Passes | Пасы | Pases | Match overview |
penaltySaves | Penalty saves | Отбитые пенальти | Penaltis parados | Goalkeeping |
punches | Punches | Отбито кулаками | Despejes de puños | Goalkeeping |
redCards | Red cards | Красные карточки | Tarjetas rojas | Match overview |
shotsOffGoal | Shots off target | Удары мимо ворот | Tiros fuera | Shots |
shotsOnGoal | Shots on target | Удары в створ | Tiros a puerta | Shots |
throwIns | Throw-ins | Вбрасывания | Saques de banda | Passes |
totalClearance | Clearances | Выносы мяча | Despejes | Defending |
totalShotsInsideBox | Shots inside box | Удары из штрафной площади | Tiros dentro del área | Shots |
totalShotsOnGoal | Total shots | Удары по воротам | Tiros totales | Match overview |
totalShotsOutsideBox | Shots outside box | Удары из-за штрафной площади | Tiros fuera del área | Shots |
totalTackle | Tackles | Отбор мяча | Entradas | Match overview |
touchesInOppBox | Touches in penalty area | Касания в штрафной соперника | Toques en el área rival | Attack |
wonTacklePercent | Tackles won | Отбор мяча (выигранные) | Entradas ganadas | Defending |
yellowCards | Yellow cards | Желтые карточки | Tarjetas amarillas | Match overview |
Статистика игроков в матче
79 / 79| key | EN | RU | ES |
|---|---|---|---|
accurateCross | Accurate crosses | Точные навесы | Centros precisos |
accurateKeeperSweeper | Accurate sweeper actions | Игра на выходах (успешные) | Salidas del portero exitosas |
accurateLongBalls | Accurate long balls | Точность длинных передач | Balones largos precisos |
accurateOppositionHalfPasses | Accurate passes (opposition half) | Точность пасов на чужой половине поля | Pases precisos (campo rival) |
accurateOwnHalfPasses | Accurate passes (own half) | Точность пасов на своей половине поля | Pases precisos (campo propio) |
accuratePass | Accurate passes | Точные пасы | Pases precisos |
aerialLost | Aerial duels lost | Воздушные единоборства (проигр.) | Duelos aéreos perdidos |
aerialWon | Aerial duels won | Воздушные единоборства (выигр.) | Duelos aéreos ganados |
ballCarriesCount | Carries | Проходы с мячом | Conducciones |
ballRecovery | Recoveries | Возвраты мяча | Recuperaciones |
bestBallCarryProgression | Best carry progression | Лучший проход с мячом | Mejor conducción progresiva |
bigChanceCreated | Big chances created | Созданные голевые моменты | Ocasiones claras creadas |
bigChanceMissed | Big chances missed | Упущенные голевые моменты | Ocasiones claras falladas |
blockedScoringAttempt | Blocked shots | Заблокированные удары | Tiros bloqueados |
challengeLost | Dribbled past | Обыгран в обводке | Regateado |
clearanceOffLine | Clearance off line | Вынос с линии ворот | Despeje bajo palos |
crossNotClaimed | Cross not claimed | Неудачный выход на навес | Centro no atrapado |
dispossessed | Dispossessed | Потери мяча (отбор соперником) | Pérdidas de balón |
duelLost | Duels lost | Единоборства (проигр.) | Duelos perdidos |
duelWon | Duels won | Победы в единоборствах | Duelos ganados |
errorLeadToAGoal | Error leading to goal | Ошибка, приведшая к голу | Error que provoca gol |
errorLeadToAShot | Error leading to shot | Ошибка, приведшая к удару | Error que provoca tiro |
expectedAssists | Expected assists (xA) | Ожидаемые передачи (xA) | Asistencias esperadas (xA) |
expectedGoals | Expected goals (xG) | Ожидаемые голы (xG) | Goles esperados (xG) |
expectedGoalsOnTarget | Expected goals on target (xGOT) | Ожидаемые голы в створ (xGOT) | Goles esperados a puerta (xGOT) |
fouls | Fouls | Фолы | Faltas |
goalAssist | Assists | Голевые передачи | Asistencias |
goals | Goals | Голы | Goles |
goalsPrevented | Goals prevented | Предотвращённые голы | Goles evitados |
goodHighClaim | Good high claims | Перехваты навесов | Despejes de balones aéreos |
hitWoodwork | Hit woodwork | Удары в штангу | Tiros al palo |
interceptionWon | Interceptions | Перехваты | Intercepciones |
keeperSaveValue | Goalkeeper save value | Ценность сэйвов вратаря | Valor de paradas |
keyPass | Key passes | Ключевые пасы | Pases clave |
kilometersCovered | Distance covered (km) | Пройденная дистанция (км) | Distancia recorrida (km) |
lastManTackle | Last man tackle | Фол последней надежды | Entrada de último hombre |
metersCoveredHighSpeedRunningKm | Distance high-speed running (km) | Дистанция: быстрый бег (км) | Distancia: carrera a alta velocidad (km) |
metersCoveredRunningKm | Distance running (km) | Дистанция: бег (км) | Distancia: carrera (km) |
metersCoveredSprintingKm | Distance sprinting (km) | Дистанция: спринт (км) | Distancia: sprint (km) |
minutesPlayed | Minutes played | Сыграно минут | Minutos jugados |
numberOfSprints | Number of sprints | Количество спринтов | Número de sprints |
onTargetScoringAttempt | Shots on target | Удары в створ ворот | Tiros a puerta |
outfielderBlock | Blocks | Блокировки ударов | Bloqueos |
ownGoals | Own goals | Автоголы | Goles en propia puerta |
penaltyConceded | Penalty conceded | Нарушение, повлёкшее пенальти | Penalti cometido |
penaltyFaced | Penalties faced | Пенальти в ворота (вратарь) | Penaltis recibidos |
penaltyMiss | Penalty missed | Незабитый пенальти | Penalti fallado |
penaltySave | Penalty saved | Отбитый пенальти | Penalti parado |
penaltyShootoutGoal | Penalty shootout goal | Гол в послематчевой серии | Gol en la tanda de penaltis |
penaltyShootoutMiss | Penalty shootout miss | Незабитый пенальти в послематчевой серии | Penalti fallado en la tanda |
penaltyShootoutSave | Penalty shootout save | Отбитый пенальти в послематчевой серии | Penalti parado en la tanda |
penaltyWon | Penalty won | Заработанный пенальти | Penalti provocado |
possessionLostCtrl | Possession lost | Потери владения | Posesiones perdidas |
progressiveBallCarriesCount | Progressive carries | Прогрессивные проходы | Conducciones progresivas |
punches | Punches | Отбито кулаками | Despejes de puños |
rating | Rating | Рейтинг | Valoración |
savedShotsFromInsideTheBox | Saves from inside the box | Сэйвы после ударов из штрафной | Paradas de tiros dentro del área |
saves | Saves | Сэйвы | Paradas |
shotOffTarget | Shots off target | Удары мимо ворот | Tiros fuera |
topSpeed | Top speed | Максимальная скорость | Velocidad máxima |
totalBallCarriesDistance | Carries distance | Дистанция с мячом | Distancia de conducciones |
totalClearance | Clearances | Всего выносов | Despejes |
totalContest | Total dribbles | Обводки (всего) | Regates totales |
totalCross | Total crosses | Навесы (всего) | Centros totales |
totalKeeperSweeper | Total sweeper actions | Игра на выходах (всего) | Salidas del portero (total) |
totalLongBalls | Total long balls | Длинные передачи (всего) | Balones largos (total) |
totalOffside | Offsides | Офсайды | Fueras de juego |
totalOppositionHalfPasses | Total passes (opposition half) | Передачи на чужой половине (всего) | Pases totales (campo rival) |
totalOwnHalfPasses | Total passes (own half) | Передачи на своей половине (всего) | Pases totales (campo propio) |
totalPass | Total passes | Передачи (всего) | Pases totales |
totalProgression | Total progression | Общий прогресс | Progresión total |
totalProgressiveBallCarriesDistance | Progressive carries distance | Дистанция прогрессивных проходов | Distancia de conducciones progresivas |
totalShots | Total shots | Удары по воротам | Tiros totales |
totalTackle | Total tackles | Всего тэклов | Entradas totales |
touches | Touches | Касания | Toques |
unsuccessfulTouch | Unsuccessful touches | Неудачные касания | Toques fallidos |
wasFouled | Was fouled | Заработано фолов | Faltas recibidas |
wonContest | Successful dribbles | Усп. дрибблинг | Regates exitosos |
wonTackle | Tackles won | Отбор мяча (выигранные) | Entradas ganadas |