API личных встреч (H2H)

Прошлые матчи любых двух клубов со счётом и готовой сводкой — победы, ничьи, голы за матч, «обе забьют» и ТБ 2.5.

Статистика личных встреч есть в каждом превью матча, но чтобы её собрать, нужно сопоставлять названия команд по сезонам и турнирам — и каждый раз заново пересчитывать сводку.

Передайте ID двух команд — и получите встречи и сводку, которую можно выводить как есть. История — с 2019 года для европейских лиг (Аргентина, Бразилия и MLS — с 2012) плюс еврокубки.

Параметры запроса

ПараметрОписание
lastСколько встреч, 1–20 (по умолчанию 6)
venueall или только матчи на поле первой команды
competitionФильтр по лиге или кубку
GET/v1/h2h/liverpool/manchester-city?last=6200 OK
{
  "teams": ["Liverpool", "Manchester City"],
  "meetings": 6,
  "summary": {
    "liverpool_wins": 2, "draws": 2, "manchester_city_wins": 2,
    "goals_per_match": 2.33, "btts": 3, "over_2_5": 2
  },
  "matches": [
    { "date": "2026-02-08", "competition": "Premier League",
      "home": "Liverpool", "away": "Manchester City", "score": "1-2" }
    // …
  ],
  "source": "football-data.co.uk"
}
Поля ответа

Что приходит в ответе

ПолеТипОписание
meetingsintКоличество матчей в ответе
summaryobjectПобеды каждой команды, ничьи, голы за матч, «обе забьют» и ТБ 2.5
matches[]arrayДата, турнир, хозяева, гости и счёт каждой встречи
sourcestringУказание источника исходных результатов
Где использовать

Для тех, кто публикует футбольные данные

Превью

Автоматически добавляйте блок «последние 6 встреч» на страницу каждого матча.

Контент в масштабе

Генерируйте факты о личных встречах для десятков матчей в день без ручного поиска.

Модели

Используйте историческую результативность и «обе забьют» в парах команд как признаки.

FAQ

API личных встреч: вопросы

Учитываются кубковые матчи?

Да — встречи в еврокубках идут вместе с матчами национальных лиг.

Насколько глубокая история?

С 2019 года для европейских лиг и с 2012 года для Аргентины, Бразилии и MLS.

Нужны ID команд?

Используются те же нормализованные ID, что и в эндпоинтах формы и таблиц, например manchester-city.

Смотрите также

Ещё в API

Ранний доступ

Получите API-ключ первыми

Бесплатный тариф для небольших проектов. Первые пользователи получают скидку 50% на первый год.

Запросить ранний доступ