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

Статистика матча приходит в двух местах ответа 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 приходит для всех видов спорта, но набор показателей и количество периодов различаются (тайм/четверть/период/партия).

Ключи хоккея

В хоккее часть ключей командной статистики записана с заглавной буквы (Shots, Hits, Blocked, Takeaways, Giveaways, SuspensionMinutes, PowerPlayPercentage, FaceOffWinPercentage) — сопоставляйте ключи точно, с учётом регистра.

Служебные поля статистики игрока

В объекте player.statistics помимо числовых показателей может присутствовать служебное поле statisticsType — это метаинформация, а не показатель; в словарь она не входит.

Эндпоинт

Тот же словарь доступен как статический файл — https://api.api-sport.ru/v2/StatisticsDict.json (не требует авторизации). Удобно подгрузить его один раз и кэшировать на стороне клиента:

curl https://api.api-sport.ru/v2/StatisticsDict.json

Справочник показателей

Выберите вид спорта. В таблицах — машинный ключ (key), англоязычное название и переводы на русский и испанский; для командной статистики дополнительно указана группа.

Статистика матча (команды)

42 / 42

key	EN	RU	ES	Группа
accurateCross	Crosses	Кроссы	Centros	Passes
accurateLongBalls	Long balls	Длинные мячи	Balones largos	Passes
accuratePasses	Accurate passes	Точные пасы	Pases precisos	Passes
aerialDuelsPercentage	Aerial duels	Воздушные дуэли	Duelos aéreos	Duels
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
blockedScoringAttempt	Blocked shots	Блокирование ударов	Tiros bloqueados	Shots
cornerKicks	Corner kicks	Угловые	Córners	Match overview
dispossessed	Dispossessed	Отбор мяча без контакта	Posesiones perdidas	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
expectedGoals	Expected goals (xG)	Ожидаемые голы (xG)	Goles esperados (xG)	Match overview
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
offsides	Offsides	Офсайды	Fueras de juego	Attack
passes	Passes	Пасы	Pases	Match overview
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

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

57 / 57

key	EN	RU	ES
accurateCross	Accurate crosses	Точные навесы	Centros precisos
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
dispossessed	Dispossessed	Отбор мяча без контакта	Posesiones perdidas
duelLost	Duels lost	Единоборства (проигр.)	Duelos perdidos
duelWon	Duels won	Победы в единоборствах	Duelos ganados
errorLeadToAGoal	Error leading to goal	Ошибка, приведшая к голу	Error que provoca gol
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
lastManTackle	Last man tackle	Фол последней надежды	Entrada de último hombre
minutesPlayed	Minutes played	Сыграно минут	Minutos jugados
onTargetScoringAttempt	Shots on target	Удары в створ ворот	Tiros a puerta
outfielderBlock	Blocks	Блокировки ударов	Bloqueos
possessionLostCtrl	Possession lost	Потери владения	Posesiones perdidas
progressiveBallCarriesCount	Progressive carries	Прогрессивные проходы	Conducciones progresivas
rating	Rating	Рейтинг	Valoración
saves	Saves	Сэйвы	Paradas
shotOffTarget	Shots off target	Удары мимо ворот	Tiros fuera
totalBallCarriesDistance	Carries distance	Дистанция с мячом	Distancia de conducciones
totalClearance	Clearances	Всего выносов	Despejes
totalContest	Total dribbles	Обводки (всего)	Regates totales
totalCross	Total crosses	Навесы (всего)	Centros totales
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