Перейти к основному содержимому

Статистика матча и игроков — словарь

Статистика матча приходит в двух местах ответа 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, PenaltiesAccuracy2026/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
keyENRUESГруппа
accurateCrossCrossesКроссыCentrosPasses
accurateLongBallsLong ballsДлинные мячиBalones largosPasses
accuratePassesAccurate passesТочные пасыPases precisosPasses
accurateThroughBallThrough ballsПроникающие передачиPases en profundidadAttack
aerialDuelsPercentageAerial duelsВоздушные дуэлиDuelos aéreosDuels
avgRatingAverage ratingСредний рейтингValoración mediaMatch overview
ballPossessionBall possessionВладение мячомPosesión del balónMatch overview
ballRecoveryRecoveriesВозвратыRecuperacionesDefending
bigChanceCreatedBig chancesГолевые моментыOcasiones clarasMatch overview
bigChanceMissedBig chances missedУпущенные голевые моментыOcasiones claras falladasAttack
bigChanceScoredBig chances scoredРеализованные голевые моментыOcasiones claras convertidasAttack
blockedScoringAttemptBlocked shotsБлокирование ударовTiros bloqueadosShots
cornerKicksCorner kicksУгловыеCórnersMatch overview
dispossessedDispossessedПотери мяча (отбор соперником)Pérdidas de balónDuels
diveSavesBig savesБольшие сэйвыParadas de méritoGoalkeeping
dribblesPercentageDribblesДриблингRegatesDuels
duelWonPercentDuelsЕдиноборстваDuelosDuels
errorsLeadToGoalErrors leading to goalОшибки, приведшие к голуErrores que provocan golDefending
errorsLeadToShotErrors leading to shotОшибки, приведшие к ударуErrores que provocan tiroDefending
expectedGoalsExpected goals (xG)Ожидаемые голы (xG)Goles esperados (xG)Match overview
expectedGoalsOnTargetExpected goals on target (xGOT)Ожидаемые голы в створ (xGOT)Goles esperados a puerta (xGOT)Shots
finalThirdEntriesFinal third entriesВходы на чужую третьEntradas al último tercioPasses
finalThirdPhaseStatisticFinal third phaseПасы в финальной третиFase de último tercioPasses
fouledFinalThirdFouled in final thirdФол в финальной третиFaltas recibidas en el último tercioAttack
foulsFoulsФолыFaltasMatch overview
freeKicksFree kicksСвободные ударыTiros libresMatch overview
goalkeeperSavesGoalkeeper savesОтбито вратаремParadas del porteroMatch overview
goalKicksGoal kicksУдары от воротSaques de puertaGoalkeeping
goalsPreventedGoals preventedПредотвращённые голыGoles evitadosGoalkeeping
groundDuelsPercentageGround duelsБорьба за позициюDuelos en el sueloDuels
highClaimsHigh claimsПерехват навесовDespejes de balones aéreosGoalkeeping
hitWoodworkHit woodworkУдары в штангуTiros al paloShots
interceptionWonInterceptionsПерехватыIntercepcionesDefending
kilometersCoveredDistance coveredПройденная дистанцияDistancia recorridaMatch overview
numberOfSprintsNumber of sprintsКоличество спринтовNúmero de sprintsMatch overview
offsidesOffsidesОфсайдыFueras de juegoAttack
passesPassesПасыPasesMatch overview
penaltySavesPenalty savesОтбитые пенальтиPenaltis paradosGoalkeeping
punchesPunchesОтбито кулакамиDespejes de puñosGoalkeeping
redCardsRed cardsКрасные карточкиTarjetas rojasMatch overview
shotsOffGoalShots off targetУдары мимо воротTiros fueraShots
shotsOnGoalShots on targetУдары в створTiros a puertaShots
throwInsThrow-insВбрасыванияSaques de bandaPasses
totalClearanceClearancesВыносы мячаDespejesDefending
totalShotsInsideBoxShots inside boxУдары из штрафной площадиTiros dentro del áreaShots
totalShotsOnGoalTotal shotsУдары по воротамTiros totalesMatch overview
totalShotsOutsideBoxShots outside boxУдары из-за штрафной площадиTiros fuera del áreaShots
totalTackleTacklesОтбор мячаEntradasMatch overview
touchesInOppBoxTouches in penalty areaКасания в штрафной соперникаToques en el área rivalAttack
wonTacklePercentTackles wonОтбор мяча (выигранные)Entradas ganadasDefending
yellowCardsYellow cardsЖелтые карточкиTarjetas amarillasMatch overview

Статистика игроков в матче

79 / 79
keyENRUES
accurateCrossAccurate crossesТочные навесыCentros precisos
accurateKeeperSweeperAccurate sweeper actionsИгра на выходах (успешные)Salidas del portero exitosas
accurateLongBallsAccurate long ballsТочность длинных передачBalones largos precisos
accurateOppositionHalfPassesAccurate passes (opposition half)Точность пасов на чужой половине поляPases precisos (campo rival)
accurateOwnHalfPassesAccurate passes (own half)Точность пасов на своей половине поляPases precisos (campo propio)
accuratePassAccurate passesТочные пасыPases precisos
aerialLostAerial duels lostВоздушные единоборства (проигр.)Duelos aéreos perdidos
aerialWonAerial duels wonВоздушные единоборства (выигр.)Duelos aéreos ganados
ballCarriesCountCarriesПроходы с мячомConducciones
ballRecoveryRecoveriesВозвраты мячаRecuperaciones
bestBallCarryProgressionBest carry progressionЛучший проход с мячомMejor conducción progresiva
bigChanceCreatedBig chances createdСозданные голевые моментыOcasiones claras creadas
bigChanceMissedBig chances missedУпущенные голевые моментыOcasiones claras falladas
blockedScoringAttemptBlocked shotsЗаблокированные ударыTiros bloqueados
challengeLostDribbled pastОбыгран в обводкеRegateado
clearanceOffLineClearance off lineВынос с линии воротDespeje bajo palos
crossNotClaimedCross not claimedНеудачный выход на навесCentro no atrapado
dispossessedDispossessedПотери мяча (отбор соперником)Pérdidas de balón
duelLostDuels lostЕдиноборства (проигр.)Duelos perdidos
duelWonDuels wonПобеды в единоборствахDuelos ganados
errorLeadToAGoalError leading to goalОшибка, приведшая к голуError que provoca gol
errorLeadToAShotError leading to shotОшибка, приведшая к ударуError que provoca tiro
expectedAssistsExpected assists (xA)Ожидаемые передачи (xA)Asistencias esperadas (xA)
expectedGoalsExpected goals (xG)Ожидаемые голы (xG)Goles esperados (xG)
expectedGoalsOnTargetExpected goals on target (xGOT)Ожидаемые голы в створ (xGOT)Goles esperados a puerta (xGOT)
foulsFoulsФолыFaltas
goalAssistAssistsГолевые передачиAsistencias
goalsGoalsГолыGoles
goalsPreventedGoals preventedПредотвращённые голыGoles evitados
goodHighClaimGood high claimsПерехваты навесовDespejes de balones aéreos
hitWoodworkHit woodworkУдары в штангуTiros al palo
interceptionWonInterceptionsПерехватыIntercepciones
keeperSaveValueGoalkeeper save valueЦенность сэйвов вратаряValor de paradas
keyPassKey passesКлючевые пасыPases clave
kilometersCoveredDistance covered (km)Пройденная дистанция (км)Distancia recorrida (km)
lastManTackleLast man tackleФол последней надеждыEntrada de último hombre
metersCoveredHighSpeedRunningKmDistance high-speed running (km)Дистанция: быстрый бег (км)Distancia: carrera a alta velocidad (km)
metersCoveredRunningKmDistance running (km)Дистанция: бег (км)Distancia: carrera (km)
metersCoveredSprintingKmDistance sprinting (km)Дистанция: спринт (км)Distancia: sprint (km)
minutesPlayedMinutes playedСыграно минутMinutos jugados
numberOfSprintsNumber of sprintsКоличество спринтовNúmero de sprints
onTargetScoringAttemptShots on targetУдары в створ воротTiros a puerta
outfielderBlockBlocksБлокировки ударовBloqueos
ownGoalsOwn goalsАвтоголыGoles en propia puerta
penaltyConcededPenalty concededНарушение, повлёкшее пенальтиPenalti cometido
penaltyFacedPenalties facedПенальти в ворота (вратарь)Penaltis recibidos
penaltyMissPenalty missedНезабитый пенальтиPenalti fallado
penaltySavePenalty savedОтбитый пенальтиPenalti parado
penaltyShootoutGoalPenalty shootout goalГол в послематчевой серииGol en la tanda de penaltis
penaltyShootoutMissPenalty shootout missНезабитый пенальти в послематчевой серииPenalti fallado en la tanda
penaltyShootoutSavePenalty shootout saveОтбитый пенальти в послематчевой серииPenalti parado en la tanda
penaltyWonPenalty wonЗаработанный пенальтиPenalti provocado
possessionLostCtrlPossession lostПотери владенияPosesiones perdidas
progressiveBallCarriesCountProgressive carriesПрогрессивные проходыConducciones progresivas
punchesPunchesОтбито кулакамиDespejes de puños
ratingRatingРейтингValoración
savedShotsFromInsideTheBoxSaves from inside the boxСэйвы после ударов из штрафнойParadas de tiros dentro del área
savesSavesСэйвыParadas
shotOffTargetShots off targetУдары мимо воротTiros fuera
topSpeedTop speedМаксимальная скоростьVelocidad máxima
totalBallCarriesDistanceCarries distanceДистанция с мячомDistancia de conducciones
totalClearanceClearancesВсего выносовDespejes
totalContestTotal dribblesОбводки (всего)Regates totales
totalCrossTotal crossesНавесы (всего)Centros totales
totalKeeperSweeperTotal sweeper actionsИгра на выходах (всего)Salidas del portero (total)
totalLongBallsTotal long ballsДлинные передачи (всего)Balones largos (total)
totalOffsideOffsidesОфсайдыFueras de juego
totalOppositionHalfPassesTotal passes (opposition half)Передачи на чужой половине (всего)Pases totales (campo rival)
totalOwnHalfPassesTotal passes (own half)Передачи на своей половине (всего)Pases totales (campo propio)
totalPassTotal passesПередачи (всего)Pases totales
totalProgressionTotal progressionОбщий прогрессProgresión total
totalProgressiveBallCarriesDistanceProgressive carries distanceДистанция прогрессивных проходовDistancia de conducciones progresivas
totalShotsTotal shotsУдары по воротамTiros totales
totalTackleTotal tacklesВсего тэкловEntradas totales
touchesTouchesКасанияToques
unsuccessfulTouchUnsuccessful touchesНеудачные касанияToques fallidos
wasFouledWas fouledЗаработано фоловFaltas recibidas
wonContestSuccessful dribblesУсп. дрибблингRegates exitosos
wonTackleTackles wonОтбор мяча (выигранные)Entradas ganadas