SportAPI
Интеграция API

Статистика тенниса в JSON: эйсы, двойные ошибки и брейк-пойнты из live API

Что отдаёт live API по теннису в JSON: счёт по сетам, геймам и очкам, восемь показателей подачи на каждого игрока и подсобытия по эйсам, двойным ошибкам и брейкам, с кодом для разбора.

Окно JSON со статистикой теннисного матча, карточки эйсов, двойных ошибок и брейк-пойнтов, мяч и ракетка на корте

Live API по теннису отдаёт сразу три уровня счёта — сеты, геймы и очки — и короткий блок статистики подачи на каждого игрока: эйсы, двойные ошибки, процент первой подачи, очки на первой и второй подаче, реализация брейк-пойнтов, брейки. Всё это приходит в JSON в том же объекте матча, что и коэффициенты, так что один запрос кормит и табло, и панель статистики, и купон.

Мы проверили это 4 ноября 2026 на тестовом ключе во время матча ATP Paris Александр Зверев — Лоренцо Музетти. Список events по теннису вернул 54 live-матча, а в объекте матча были score_full: "0:0" для сетов, score_period: "1:1" для геймов, score_extra: "40:0" для очков, period_name: "1st set" и stat_list из восьми показателей. У того же матча были подсобытия «Эйсы», «Двойные ошибки» и «Брейки» со своими рынками. Ниже — что означает каждое поле, как читать его в коде и чего в линии нет.

Данные идут из Sport Line API — линии и live-данных SportAPI; теннис в ней — вид спорта 4. Страница продукта по этому виду спорта — API коэффициентов на теннис.

Почему теннис показывать сложнее, чем счёт в футболе

У футбольного матча один счёт и часы. У теннисного — счёт внутри счёта внутри счёта, а часов нет вовсе:

УровеньКак часто меняетсяПоле в APIПример
СетыРаз в 30–60 минутscore_full"1:0"
Геймы в текущем сетеКаждые несколько минутscore_period"5:1"
Очки в текущем геймеКаждый розыгрышscore_extra"40:0"
Какой сет идётВ конце сетаperiod_name"2nd set"

Поле timer у тенниса равно 0: матчевых часов нет, и интерфейс с «сыграно минут» ошибается по построению. Подача переходит каждый гейм, сет может закончиться тай-брейком, матчи бывают до двух и до трёх выигранных сетов, игрок может сняться посреди сета. Линия, которая отдаёт только «1:0», бесполезна для live-страницы; линия, которая отдаёт все три уровня, но без устойчивой структуры, превращает разбор в мучение. Структура ниже одинакова от матча к матчу: те же три поля, тот же формат строки.

Откуда берётся live-статистика по теннису

Статистика лежит в массиве stat_list live-матча, и приходит она в двух местах: внутри каждого матча в live-списке и внутри подробного объекта матча.

GET /v1/events/4/0/sub/50/live/en
GET /v1/event/{gameId}/group/live/en

Пути указаны относительно домена API, который вместе с ключом выдаёт менеджер; ключ передаётся в заголовке Package. Первый запрос возвращает все live-матчи по теннису, сгруппированные по турнирам. Если коэффициенты не нужны, добавьте ?odds=false — ответ станет в 2–5 раз меньше, что важно при опросе раз в 7 секунд. Второй запрос возвращает один матч с полным списком рынков и подсобытиями.

Это реальный stat_list из матча Зверев — Музетти в начале первого сета (язык ответа ru):

"stat_list": [
  { "id": 1,  "name": "Эйсы",                                  "opp1": "1",   "opp2": "1"  },
  { "id": 2,  "name": "% выигранных очков на первой подаче",   "opp1": "100", "opp2": "67" },
  { "id": 3,  "name": "Реализация брейкпоинтов %",             "opp1": "0",   "opp2": "0"  },
  { "id": 4,  "name": "Двойные ошибки",                        "opp1": "0",   "opp2": "1"  },
  { "id": 7,  "name": "% выигранных очков на второй подаче",   "opp1": "100", "opp2": "67" },
  { "id": 8,  "name": "Реализовано первых подач",              "opp1": "50",  "opp2": "50" },
  { "id": 30, "name": "Очки на своей подаче",                  "opp1": "4",   "opp2": "4"  },
  { "id": 98, "name": "Брейки",                                "opp1": "0",   "opp2": "0"  }
]

Три правила чтения. Значения — строки, даже числа, поэтому перед сравнением и отрисовкой полосок их нужно привести к числу. opp1 всегда относится к opp_1_name, opp2 — к opp_2_name: если интерфейс меняет игроков местами, значения меняются вместе с ними. Для логики используйте id, потому что name зависит от языка: запросите матч на английском, и «Эйсы» станут Aces, а id: 1 останется.

idПоказательТипКак показывать
1Эйсысчётчикчисло на игрока
4Двойные ошибкисчётчикчисло на игрока
8Реализовано первых подачпроцентполоска, попадание первой подачи
2Выигранные очки на первой подачепроцентполоска
7Выигранные очки на второй подачепроцентполоска
30Очки на своей подачесчётчикчисло на игрока
3Реализация брейк-пойнтовпроцентполоска
98Брейкисчётчикчисло на игрока

Статистика есть только пока матч идёт. В prematch-объектах stat_list нет, а когда матч уходит из live-линии, статистика уходит вместе с ним. Если итоговые цифры нужны после матча, сохраните их из последнего live-ответа сами. И не у каждого live-матча статистика есть: в сохранённом снимке из документации она была у 16 матчей из 39 по всем видам спорта, так что пустой stat_list: [] — это «по матчу статистики нет», а не ошибка.

Разбираем счёт: сеты, геймы и очки в коде

Все три строки счёта одного формата, "слева:справа", поэтому форматтер умещается в несколько строк:

// score_full: сеты, score_period: геймы текущего сета, score_extra: очки текущего гейма
function tennisScore(match) {
  const [sets1, sets2] = match.score_full.split(':');
  const [games1, games2] = (match.score_period || '0:0').split(':');
  const points = match.score_extra || '';  // "40:0" во время гейма, "0:0" или "" между геймами
  return {
    sets: `${sets1}-${sets2}`,
    games: `${games1}-${games2}`,
    points,
    set: match.period_name,                // "1st set", "2nd set", ...
    stats: Object.fromEntries(
      (match.stat_list || []).map((s) => [s.id, [Number(s.opp1), Number(s.opp2)]]),
    ),
  };
}

// { sets: "0-0", games: "1-1", points: "40:0", set: "1st set", stats: { 1: [1, 1], 4: [0, 1], ... } }

Двух вещей в ответе нет, и выдумывать их не стоит. Нет поля «кто подаёт»: если макету нужен маркер подачи, придётся вести его самим по счёту геймов, а тай-брейк это правило ломает. И нет раскладки по завершённым сетам: score_full — это счёт по сетам, а не геймы каждого сыгранного сета. Геймы по сетам приходят после матча в линии результатов (об этом ниже).

Список live опрашивайте не чаще раза в 7 секунд, один матч — раз в 5. Между запросами счёт по очкам меняется быстрее, и это нормально: показывайте то, что пришло в последнем ответе, и не анимируйте таймер, потому что его нет.

Эйсы, двойные ошибки и брейки как подсобытия

В подробном объекте матча есть массив sub_games. У матча, который мы проверяли, в нём было 11 подсобытий, у каждого свой game_id:

1st set · 2nd set · Quick events · Quick events,1st set
Aces · Aces,1st set · Double Faults · Double Faults,1st set
Breaks · Breaks,1st set · Breaks,2nd set

Подсобытие в API — отдельный объект матча. Запросите его тем же методом event, и получите его собственные рынки и собственный счёт. У подсобытия «Эйсы» счёт — это и есть число эйсов: в тот момент score_full был "1:1", по одному эйсу у каждого, а рынки — тоталы на матч и на каждого игрока: больше 4,5, 9,5 и 14,5, плюс Total 1 и Total 2 по игрокам:

// подсобытия по статистике ищем по имени; каждое запрашивается как матч
const statSubs = match.sub_games.filter((s) =>
  /^(Aces|Double Faults|Breaks)$/.test(s.game_name),
);
for (const s of statSubs) {
  const sub = await fetchLine(`/v1/event/${s.game_id}/group/live/en`, 5_000);
  // sub.score_full: текущий счётчик, например "1:1" эйсов
  // sub.game_oc_list: тоталы на матч и на игрока
  // sub.game_mid: ссылка на основной матч
}

Здесь статистика и ставки встречаются. Число из stat_list говорит читателю, сколько эйсов уже подано; рынок подсобытия — чего линия ждёт от всего матча. Страница статистики тенниса, где рядом стоят «Эйсы: 7 / больше 14,5 за 1,36», собирается ровно из этих двух объектов. Поле game_mid у подсобытия указывает на основной матч, так что всё группируется на одной странице.

Что собрать на live-данных по теннису

Панель live-статистики для теннисного сайта. Опрашивайте events по виду спорта 4 с ?odds=false раз в 7 секунд, рисуйте три уровня счёта и восемь показателей полосками. Один опросчик на сервере обслуживает всех посетителей из кеша; ключ API остаётся на сервере. Виджет трекера матчей поддерживает теннис и доступен для матча, когда заполнено поле zp; у матча в Париже оно было заполнено.

Входные данные для модели вероятности победы. Люди ищут «tennis win probability API», а вероятностей линия не отдаёт. Она отдаёт две вещи, которые нужны модели: live-статистику подачи и текущие коэффициенты. Двухисходный рынок без маржи даёт базовую оценку, а модель корректирует её по статистике:

def implied_probability(k1: float, k2: float) -> tuple[float, float]:
    """Рынок с двумя исходами: убираем маржу букмекера пропорционально."""
    p1, p2 = 1 / k1, 1 / k2
    total = p1 + p2            # больше 1 из-за маржи
    return p1 / total, p2 / total

implied_probability(1.304, 3.57)   # (0.73, 0.27): Зверев — Музетти при 1-1 в первом сете

Коэффициенты 1.304 и 3.57 — это исходы W1 и W2 рынка 1x2 из того же ответа; ничьей в теннисе нет, поэтому у рынка две колонки. Как от базовой оценки перейти к обученной модели, рассказано в статье о прогнозной модели на Python; для тенниса подход тот же, признаки — статистика подачи.

Алерты. Брейк, тай-брейк, третий сет — всё это изменения полей, которые вы и так опрашиваете. Breaks сменился с 0 на 1, score_period дошёл до 6:6, period_name стал 3rd set. Цикл опроса и доставка в Telegram описаны в статье про бота live-сигналов; теннисная часть — только условие.

Расписание до матча и результаты после

Live-линия — один из трёх источников, и они не пересекаются:

КогдаЧто получаетеГде
До матчаТурниры, участники, время начала, prematch-рынкиevents с типом line; календарь матчей /v1/events/4/0/sub/50/line/{hours}/{days}/ru — на сегодня, завтра или ближайшие часы
Во время матчаСчёт по сетам, геймам и очкам, stat_list, live-рынки, подсобытияevents и event с типом live
После матчаИтоговый счёт по сетам и геймы каждого сетаAPI результатов матчей, от $25 в месяц за один вид спорта, +$10 за каждый дополнительный язык

Две детали для расписания. Парные матчи приходят с массивами opp_1_ids и opp_2_ids — по два ID участников на сторону, а имена остаются в opp_1_name и opp_2_name. И при переходе из prematch в live матч получает новый game_id, поэтому связывайте prematch- и live-записи по участникам и времени начала, а не по ID.

Подробной исторической статистики игроков, личных встреч и средних по сезону нет ни в live-линии, ни в результатах. Отдельный API статистики для этого в разработке; спросите о нём у менеджера вместо того, чтобы парсить сайты рейтингов.

Чего в линии нет

  • Статистики по prematch и завершённым матчам. stat_list есть только в live. Сохраняйте последние live-значения, если они нужны потом.
  • Маркера подачи. Поля «кто подаёт» нет.
  • Матчевых часов. timer у тенниса равен 0.
  • Вероятностей победы. Считайте их из коэффициентов и статистики у себя.
  • Гарантированной статистики по каждому матчу. Турниры низшего уровня могут идти без stat_list; проверяйте длину массива перед отрисовкой.
  • Push-канала. WebSocket в разработке; production-интеграции опрашивают API с документированными интервалами.

Ошибки, которые ломают теннисные страницы

  1. Принять score_full за геймы. Это сеты. Геймы — в score_period.
  2. Сравнивать opp1 как строки. "100" > "67" — сравнение строк; сначала приведите к числу.
  3. Искать показатели по name. Имена зависят от языка. Ищите по id.
  4. Опрашивать event по всем 54 матчам. Детали нужны только по открытому матчу; stat_list есть уже в списке.
  5. Связывать prematch и live по game_id. Это разные ID. Связывайте по участникам и времени начала.
  6. Показывать таймер. Он всегда 0.

Как проверить на сегодняшних матчах с SportAPI

Тестовый ключ даёт два дня доступа ко всем видам спорта, prematch и live, так что вся проверка укладывается в один вечер:

  1. GET /v1/menu/live/ru — убедитесь, что вид спорта 4 в списке и счётчик матчей не нулевой.
  2. GET /v1/events/4/0/sub/50/live/ru?odds=false — выберите матч с непустым stat_list.
  3. GET /v1/event/{gameId}/group/live/ru — прочитайте три поля счёта, статистику и sub_games.
  4. Запросите подсобытие «Эйсы» по его game_id и сравните его score_full с показателем id: 1 в stat_list.
  5. Поопрашивайте матч несколько минут и посмотрите, как меняется score_extra.

Live-статистика, подсобытия и теннисная линия входят в тариф на один вид спорта — от $30 в месяц. На странице API коэффициентов на теннис перечислены рынки; модель данных live-статистики в документации описывает stat_list для всех видов спорта.

Частые вопросы

Есть ли бесплатный API статистики тенниса?

Как постоянный тариф — нет. SportAPI даёт бесплатный тестовый ключ на два дня со всеми видами спорта и live-данными; этого хватает, чтобы собрать и проверить теннисную страницу. Дальше тариф на один вид спорта — от $30 в месяц.

API говорит, кто подаёт?

Нет. В live-объекте есть счёт трёх уровней и статистика, но маркера подачи нет. Если он нужен, выводите его из счёта геймов, а тай-брейк обрабатывайте отдельно.

Можно получить эйсы и двойные ошибки по завершённому матчу?

Из линии результатов — нет, она отдаёт счёт по сетам и геймам. Статистика доступна, пока матч идёт, поэтому сохраняйте последние live-значения, если они понадобятся после. Подробная историческая статистика — отдельный продукт, он в разработке.

Какие турниры есть в линии?

В наших проверках в live-списке были турниры ATP, WTA и Challenger. Покрытие меняется вместе с календарём, поэтому нужный турнир проверьте через menu на тестовом ключе, прежде чем обещать его пользователям.

Линия отдаёт вероятность победы?

Нет. Она отдаёт коэффициенты, из которых считается подразумеваемая вероятность, и live-статистику, которую можно подать в собственную модель.

Данные по теннису есть на других языках?

Да. Код языка в URL меняет name в stat_list, названия периодов и рынков. ID показателей и строки счёта остаются теми же.

Что проверить перед подключением

Откройте сегодня live-матч на тестовом ключе и посмотрите на четыре вещи: три поля счёта меняются по ходу розыгрышей, в stat_list восемь показателей, счёт подсобытия «Эйсы» совпадает с числом эйсов, а нужный турнир есть в menu. Если все четыре проверки прошли, теннисная страница — это день работы над фронтендом поверх цикла опроса. Попросите ключ у менеджера SportAPI в Telegram и прогоните проверку на вечерних матчах.

← Все статьи