Документация football API

Простой REST API. Передавайте API-ключ как параметр запроса — заголовки не нужны.

Базовый URL: https://live-football-api.com/api/v1

Аутентификация

Добавьте api_key к каждому URL запроса. Создайте бесплатный аккаунт, чтобы получить ключ.

https://live-football-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-07-03

Не раскрывайте свой API-ключ в публичном коде или открытых репозиториях.

Кредиты

Каждый вызов API расходует кредиты. Кредиты не истекают. Новые аккаунты получают 100 бесплатных кредитов.

Эндпоинт	Стоимость
GET /matches	1 кредит за вызов
GET /live_match_details	1 кредит за вызов
GET /lineups	1 кредит за вызов
GET /h2h	1 кредит за вызов
GET /injuries	1 кредит за вызов
GET /officials	1 кредит за вызов
GET /leagues	1 кредит за вызов
GET /league	1 кредит за вызов
GET /league_standings	1 кредит за вызов
GET /league_fixtures	1 кредит за вызов
GET /team_matches	1 кредит за вызов
GET /team_squad	1 кредит за вызов
GET /team_standings	1 кредит за вызов
GET /player	1 кредит за вызов
GET /player_matches	1 кредит за вызов
GET /team_search	1 кредит за вызов
GET /player_search	1 кредит за вызов
POST /webhook/register	Бесплатно
GET /webhook/register	Бесплатно
DELETE /webhook/register	Бесплатно

Ошибки

Все ошибки возвращают JSON с полями code и message:

Код	Значение
400	Bad request — missing or invalid parameter
401	API key missing or invalid
403	Access denied — insufficient credits, daily limit exceeded, or inactive account
429	Insufficient credits
500	Database error
503	Upstream data source unavailable — retry after a few seconds

{
  "success": false,
  "message": "Access denied. Possible reasons: Invalid key, insufficient credits, daily limit exceeded, or inactive account.",
  "timestamp": "2026-07-03 14:22:01"
}

GET /matches

Возвращает матчи по Футболу за указанную дату. Названия команд и лиг можно переводить.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
date	string	Нет	Дата матча в формате `YYYY-MM-DD`
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-07-03&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4999,
  "data": {
    "date": "2026-07-03",
    "language": "en",
    "timezone": "UTC",
    "matches": [
      {
        "id": "lfa4phmwb3bhclg7aqht1ajcwk",
        "league": {
          "id": "lfa-premier-league",
          "name": "Premier League",
          "country": "England"
        },
        "kickoff": "14:00",
        "status": {
          "status": "live",
          "display": "73'",
          "is_live": true,
          "state": "inPlay"
        },
        "home": {
          "id": "lfa-man-city",
          "name": "Manchester City",
          "logo": "https://live-football-api.com/teams/lfa-man-city.png",
          "score": 2
        },
        "away": {
          "id": "lfa-arsenal",
          "name": "Arsenal",
          "logo": "https://live-football-api.com/teams/lfa-arsenal.png",
          "score": 1
        },
        "halftime": { "home": 1, "away": 0 },
        "tv_broadcast": true,
        "penalty": { "home": null, "away": null }
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

tv_broadcast — true, если матч транслируется по ТВ (названия каналов пока недоступны). penalty — счёт послематчевых пенальти, null, если серии пенальти не было.

GET /live_match_details

Возвращает данные матча в реальном времени: хронология событий и статистика.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
match_id	string	Да	ID матча из ответа `/matches`
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/live_match_details?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4998,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "last_updated": "2026-07-03 14:22:01 UTC",
    "header": {
      "home": {
        "name": "Manchester City",
        "id": "lfa-man-city",
        "logo": "https://live-football-api.com/teams/lfa-man-city.png",
        "score": "2"
      },
      "away": {
        "name": "Arsenal",
        "id": "lfa-arsenal",
        "logo": "https://live-football-api.com/teams/lfa-arsenal.png",
        "score": "1"
      },
      "status": { "display": "", "is_live": true, "is_postponed": 0, "minute": "73", "state": "inPlay" }
    },
    "events": [
      {
        "time": "23",
        "type": "Goal",
        "side": "home",
        "detail": {
          "player": { "name": "Haaland", "id": "lfa-haaland", "image": "https://live-football-api.com/people/lfa-haaland.png" },
          "score": "1-0"
        }
      },
      {
        "time": "65",
        "type": "Yellow Card",
        "side": "away",
        "detail": {
          "player": { "name": "Rice", "id": "lfa-rice", "image": "https://live-football-api.com/people/lfa-rice.png" }
        }
      }
    ],
    "stats": [
      { "label": "Possession", "home": "62%", "away": "38%" },
      { "label": "Shots",      "home": "14",  "away": "6"   },
      { "label": "Corners",    "home": "7",   "away": "3"   }
    ],
    "csb_url": "https://live-football-api.com/api/v1/csb?token=eyJhbGci...&matchid=lfa4phmwb3bhclg7aqht1ajcwk&lang=en",
    "venue": { "name": "Etihad Stadium", "capacity": 53400 },
    "referee": "M. Oliver",
    "tv_channels": ["beIN SPORTS 1"],
    "player_of_the_match": { "name": "Haaland", "id": "lfa-haaland", "image": "https://live-football-api.com/people/lfa-haaland.png", "rating": 8.7 }
  },
  "timestamp": "2026-07-03 14:22:01"
}

Новые поля: venue, referee, tv_channels (реальные названия каналов) и player_of_the_match. События также могут содержать флаги is_penalty / is_second_yellow внутри detail, если применимо.

csb_url — Готовый к использованию URL для iframe с визуализацией CSB живого матча. Встраивайте напрямую: <iframe src="csb_url" width="636" height="400" frameborder="0"></iframe>
Возвращает null, если у матча нет активного CSB-потока (например, до начала матча или неподдерживаемое соревнование).

GET /csb

Возвращает визуализацию Centre Stage Board (CSB) живого матча в виде HTML-страницы — предназначена для встраивания в <iframe>. Поле csb_url в ответе /live_match_details уже содержит готовый URL с предварительно полученным токеном; в большинстве случаев вам не нужно вызывать этот эндпоинт вручную.

Параметры

Параметр	Тип	Обязательный	Описание
token	string	Да	JWT-токен визуализации (предоставляется в готовом виде внутри `csb_url` из ответа live_match_details).
matchid	string	Да	ID матча в формате `lfa` (совпадает с полем `id` из /matches).
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

<iframe
  src="https://live-football-api.com/api/v1/csb?token=TOKEN&matchid=lfa4phmwb3bhclg7aqht1ajcwk&lang=en"
  width="636"
  height="400"
  frameborder="0"
  allowtransparency="true"
></iframe>

CSB-токен имеет ограниченный срок действия (как правило, 4 часа). Всегда используйте csb_url из свежего вызова /live_match_details, чтобы получить действующий токен. Не кэшируйте и не записывайте токены жёстко.

GET /lineups

Возвращает стартовый состав, запасных и тренера обеих команд.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
match_id	string	Да	ID матча из ответа `/matches`
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/lineups?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4997,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "home": {
      "starting": [
        { "id": "lfa-ederson", "name": "Ederson", "image": "https://live-football-api.com/people/lfa-ederson.png", "number": "31", "position": "Goalkeeper", "rating": 6.8 },
        { "id": "lfa-haaland", "name": "Haaland", "image": "https://live-football-api.com/people/lfa-haaland.png", "number": "9",  "position": "Forward",   "rating": 8.7 }
      ],
      "subs": [
        { "id": "lfa-bernardo", "name": "Bernardo Silva", "image": "https://live-football-api.com/people/lfa-bernardo.png", "number": "20", "position": "Midfielder", "rating": null }
      ],
      "coach": { "id": "lfa-guardiola", "name": "Pep Guardiola", "image": "https://live-football-api.com/people/lfa-guardiola.png" }
    },
    "away": {
      "starting": [
        { "id": "lfa-raya", "name": "Raya", "image": "https://live-football-api.com/people/lfa-raya.png", "number": "1", "position": "Goalkeeper", "rating": 6.5 }
      ],
      "subs": [],
      "coach": { "id": "lfa-arteta", "name": "Mikel Arteta", "image": "https://live-football-api.com/people/lfa-arteta.png" }
    },
    "formation": { "home": 433, "away": 442 },
    "is_projected": false
  },
  "timestamp": "2026-07-03 14:22:01"
}

У каждого игрока теперь также есть number, position и rating. Новые поля верхнего уровня: formation и is_projected (true = предполагаемый состав до начала матча).

GET /h2h

Возвращает историю встреч двух команд.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
match_id	string	Да	ID матча из ответа `/matches`
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/h2h?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4996,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "home_form": [
      {
        "date": "2026-06-14",
        "home": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
        "away": { "id": "lfa-chelsea",  "name": "Chelsea",         "logo": "https://live-football-api.com/teams/lfa-chelsea.png" },
        "score": "3-1"
      }
    ],
    "away_form": [ ],
    "h2h": [
      {
        "date": "2025-09-22",
        "home": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
        "away": { "id": "lfa-arsenal",  "name": "Arsenal",         "logo": "https://live-football-api.com/teams/lfa-arsenal.png" },
        "score": "2-1"
      }
    ],
    "h2h_summary": { "home_wins": 8, "away_wins": 6, "draws": 4 }
  },
  "timestamp": "2026-07-03 14:22:01"
}

h2h_summary — новое поле: суммарное количество побед/ничьих двух команд, в дополнение к спискам матчей.

GET /injuries

Возвращает травмированных и дисквалифицированных игроков обеих команд.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
match_id	string	Да	ID матча из ответа `/matches`
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/injuries?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4995,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "injuries": {
      "home": [
        {
          "id": "lfa-de-bruyne",
          "name": "Kevin De Bruyne",
          "image": "https://live-football-api.com/people/lfa-de-bruyne.png",
          "position": "Midfielder",
          "status": "Hamstring Injury",
          "stats": { "appearence": 12, "assists": 6, "goals": 2, "redCards": 0, "yellowCards": 1 }
        }
      ],
      "away": [
        { "id": "lfa-zinchenko", "name": "Oleksandr Zinchenko", "image": "https://live-football-api.com/people/lfa-zinchenko.png", "position": "Defender", "status": "Suspended", "stats": null }
      ]
    }
  },
  "timestamp": "2026-07-03 14:22:01"
}

У каждого игрока теперь также есть поле stats (матчи/голы/передачи/карточки в этом сезоне), если доступно, иначе null.

GET /officials

Возвращает судей, назначенных на матч.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
match_id	string	Да	ID матча из ответа `/matches`
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/officials?api_key=YOUR_KEY&match_id=lfa4phmwb3bhclg7aqht1ajcwk

Ответ

{
  "success": true,
  "credits_remaining": 4994,
  "data": {
    "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
    "officials": [
      { "id": "8d319822-2432-4da3-7bcb-ca5c11421394", "name": "Michael Oliver", "role": "Main" },
      { "id": "6c998fdc-ca49-69c3-2488-347671830e3a", "name": "Stuart Burt",    "role": "Lineman 1" },
      { "id": "6a528c78-5157-c275-9d86-ca7ed7ff21ac", "name": "Simon Long",     "role": "Lineman 2" },
      { "id": "e6e57850-918d-c5ef-9bc0-e8b43c2b8e88", "name": "Anthony Taylor","role": "Fourth official" },
      { "id": "4748a374-2d55-ae66-642e-8e9e05fb566c", "name": "Graham Scott",  "role": "VAR" }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /leagues

Возвращает все доступные лиги, сгруппированные по странам.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/leagues?api_key=YOUR_KEY&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4993,
  "data": {
    "language": "en",
    "total_countries": 45,
    "data": [
      {
        "country": "England",
        "leagues": [
          { "id": "lfa-premier-league",    "name": "Premier League" },
          { "id": "lfa-championship",      "name": "Championship" },
          { "id": "lfa-league-one",        "name": "League One" }
        ]
      },
      {
        "country": "Spain",
        "leagues": [
          { "id": "lfa-la-liga",   "name": "La Liga" },
          { "id": "lfa-segunda",   "name": "Segunda División" }
        ]
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /league

Возвращает подробную информацию о лиге.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
league_id	string	Да	ID лиги из `/leagues`
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/league?api_key=YOUR_KEY&league_id=lfa-premier-league&lang=en

GET /league_standings

Возвращает турнирную таблицу лиги.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
league_id	string	Да	ID лиги из `/leagues`
season	string	Нет	Идентификатор сезона, напр. `2025` или `2025-2026`. Пропустите для текущего сезона.
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/league_standings?api_key=YOUR_KEY&league_id=lfa-premier-league&season=2024/2025&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4992,
  "data": {
    "league_id": "lfa-premier-league",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024", "2022/2023"],
    "timezone": "UTC",
    "standings": [
      {
        "title": "Premier League",
        "table": [
          {
            "rank": 1,
            "team": {
              "id": "lfa-liverpool",
              "name": "Liverpool",
              "logo": "https://live-football-api.com/teams/lfa-liverpool.png"
            },
            "played": 38, "won": 28, "drawn": 6, "lost": 4,
            "goals_for": 86, "goals_against": 41,
            "goal_diff": 45, "points": 90,
            "form": "WWDWL",
            "zone": { "name": "Champions League", "color": "#02206B" }
          },
          {
            "rank": 2,
            "team": {
              "id": "lfa-man-city",
              "name": "Manchester City",
              "logo": "https://live-football-api.com/teams/lfa-man-city.png"
            },
            "played": 38, "won": 24, "drawn": 7, "lost": 7,
            "goals_for": 78, "goals_against": 52,
            "goal_diff": 26, "points": 79,
            "form": "WDWWW",
            "zone": { "name": "Champions League", "color": "#02206B" }
          }
        ]
      }
    ],
    "home_standings": [ { "title": "Premier League", "table": [ ] } ],
    "away_standings": [ { "title": "Premier League", "table": [ ] } ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

Каждая строка теперь содержит form (последние 5 результатов, напр. "WWDWL") и zone (зона еврокубков/вылета, если есть). Новые поля верхнего уровня: home_standings / away_standings — та же таблица, но только по домашним и только по гостевым результатам. Примечание: числовые поля (rank, played, points и т.д.) теперь являются числами JSON, а не строками.

GET /league_fixtures

Возвращает полное расписание матчей лиги по неделям, со счётом для сыгранных матчей и временем начала для предстоящих.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
league_id	string	Да	ID лиги из `/leagues`
season	string	Нет	Идентификатор сезона, напр. `2025` или `2025-2026`. Пропустите для текущего сезона.
week	string	Нет	Фильтр по одному туру/неделе, напр. `1`. Не указывайте, чтобы получить все недели.
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/league_fixtures?api_key=YOUR_KEY&league_id=lfa-super-lig&season=2025/2026&week=1&lang=tr

Ответ

{
  "success": true,
  "credits_remaining": 4991,
  "data": {
    "league_id": "lfa-super-lig",
    "league_name": "Trendyol Süper Lig",
    "season": "2025/2026",
    "available_seasons": ["2025/2026", "2024/2025", "2023/2024"],
    "timezone": "UTC",
    "weeks": [
      {
        "week": "1",
        "matches": [
          {
            "id": "lfa-c5b95lue06z36lha2ueniwsgk",
            "league": { "id": "lfa-super-lig", "name": "Trendyol Süper Lig" },
            "round": "Adnan Süvari Sezonu",
            "date": "2026-08-14",
            "kickoff": "18:30",
            "status": { "status": "finished", "display": "MS", "is_live": false, "state": "postGame" },
            "home": {
              "id": "lfa-esa748l653sss1wurz5ps3228",
              "name": "Galatasaray",
              "logo": "https://live-football-api.com/teams/lfa-esa748l653sss1wurz5ps3228.png",
              "score": "2"
            },
            "away": {
              "id": "lfa-eg0cqg1u8zz85ma9nzk0cijv",
              "name": "Çorum FK",
              "logo": "https://live-football-api.com/teams/lfa-eg0cqg1u8zz85ma9nzk0cijv.png",
              "score": "2"
            },
            "halftime": { "home": 0, "away": 0 },
            "penalty": { "home": null, "away": null }
          }
        ]
      }
    ],
    "stale": false
  },
  "timestamp": "2026-08-31 12:00:00"
}

GET /team_matches

Возвращает расписание и результаты команды за сезон.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
team_id	string	Да	ID команды из данных матча
season	string	Нет	Идентификатор сезона, напр. `2025` или `2025-2026`. Пропустите для текущего сезона.
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/team_matches?api_key=YOUR_KEY&team_id=lfa-man-city&season=2024/2025&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4991,
  "data": {
    "team_id": "lfa-man-city",
    "team_logo": "https://live-football-api.com/teams/lfa-man-city.png",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024", "2022/2023"],
    "timezone": "UTC",
    "matches": [
      {
        "id": "lfa4phmwb3bhclg7aqht1ajcwk",
        "date": "2025-08-17 14:00:00",
        "timestamp": 1755439200,
        "league": { "id": "lfa-premier-league", "name": "Premier League", "country": "England" },
        "status": "FT",
        "home": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png", "score": 2 },
        "away": { "id": "lfa-chelsea",  "name": "Chelsea",          "logo": "https://live-football-api.com/teams/lfa-chelsea.png",  "score": 0 }
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /team_squad

Возвращает полный состав команды с позициями и номерами.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
team_id	string	Да	ID команды из данных матча
season	string	Нет	Идентификатор сезона, напр. `2025` или `2025-2026`. Пропустите для текущего сезона.
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/team_squad?api_key=YOUR_KEY&team_id=lfa-man-city&season=2024/2025

Ответ

{
  "success": true,
  "credits_remaining": 4990,
  "data": {
    "team_id": "lfa-man-city",
    "team_logo": "https://live-football-api.com/teams/lfa-man-city.png",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024", "2022/2023"],
    "timezone": "UTC",
    "squad": [
      {
        "id": "lfa-haaland",
        "name": "Erling Haaland",
        "image": "https://live-football-api.com/people/lfa-haaland.png",
        "number": "9",
        "position": "Forward",
        "age": 25,
        "country": "Norway",
        "stats": { "matches": 34, "goals": 27, "assists": 5 },
        "yellow_cards": 2,
        "red_cards": 0
      }
    ],
    "coaches": [
      { "id": "lfa-guardiola", "name": "Pep Guardiola", "image": "https://live-football-api.com/people/lfa-guardiola.png" }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

У каждого игрока теперь также есть yellow_cards / red_cards за сезон. Новое поле верхнего уровня coaches — тренерский штаб команды.

GET /team_standings

Возвращает текущее положение команды в лиге.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
team_id	string	Да	ID команды из данных матча
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/team_standings?api_key=YOUR_KEY&team_id=lfa-man-city&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4989,
  "data": {
    "team_id": "lfa-man-city",
    "season": "2024/2025",
    "available_seasons": ["2024/2025", "2023/2024"],
    "timezone": "UTC",
    "standings": [
      {
        "league": "Premier League",
        "table": [
          {
            "rank": 2,
            "team": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
            "played": 38, "won": 24, "drawn": 7, "lost": 7,
            "goals_for": 78, "goals_against": 52, "goal_diff": 26, "points": 79,
            "form": "WDWWW",
            "zone": { "name": "Champions League", "color": "#02206B" }
          }
        ]
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /team_search

Поиск команд по названию. Возвращает подходящие команды с их ID и логотипами.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
q	string	Да	Поисковый запрос (название команды или имя игрока)
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/team_search?api_key=YOUR_KEY&q=galatasaray

Ответ

{
  "success": true,
  "credits_remaining": 4990,
  "data": {
    "keywords": "galatasaray",
    "total": 3,
    "teams": [
      {
        "id": "lfa-galatasaray",
        "name": "Galatasaray",
        "logo": "https://live-football-api.com/teams/lfa-galatasaray.png",
        "country": "Turkey"
      },
      {
        "id": "lfa-galatasaray-u19",
        "name": "Galatasaray U19",
        "logo": "https://live-football-api.com/teams/lfa-galatasaray-u19.png",
        "country": "Turkey"
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

Каждый результат теперь также содержит country (страна команды/игрока). Этот поиск больше не выдаёт ошибку 500 для известных однословных фамилий ("messi", "ronaldo", "kane"), как это было у предыдущего провайдера.

GET /player

Возвращает профиль игрока (биография, позиция, рыночная стоимость), а также полную историю клубной и сборной карьеры.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
player_id	string	Да	ID игрока, возвращаемый `/player_search`
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/player?api_key=YOUR_KEY&player_id=lfa-haaland&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4988,
  "data": {
    "player_id": "lfa-haaland",
    "name": "E. Haaland",
    "first_name": "Erling",
    "last_name": "Haaland",
    "photo": "https://live-football-api.com/people/lfa-haaland.png",
    "position": "Forward",
    "nationality": "Norway",
    "birthdate": "2000-07-21",
    "height": "195 cm",
    "weight": "88 kg",
    "foot": "Left",
    "shirt_number": 9,
    "market_value": "180.000.000€",
    "current_team": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
    "clubs_career": [
      {
        "team": { "id": "lfa-man-city", "name": "Manchester City", "logo": "https://live-football-api.com/teams/lfa-man-city.png" },
        "date_start": "2022-07-01",
        "is_loaned": false,
        "seasons": [
          {
            "name": "2024/2025",
            "competitions": [
              { "league": { "id": "lfa-premier-league", "name": "Premier League" }, "appearances": 34, "goals": 27, "assists": 5, "yellow_cards": 2, "red_cards": 0 }
            ]
          }
        ]
      }
    ],
    "internationals_career": [
      {
        "team": { "id": "lfa-norway", "name": "Norway", "logo": "https://live-football-api.com/teams/lfa-norway.png" },
        "date_start": "2019-09-05",
        "is_loaned": false,
        "seasons": []
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

GET /player_matches

Возвращает журнал матчей игрока (голы, передачи, карточки, старты) для одной команды и сезона.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
player_id	string	Да	ID игрока, возвращаемый `/player_search`
team_id	string	Нет	ID команды, за которую играл игрок; см. `current_team.id` / `clubs_career[].team.id` из `/player`. По умолчанию — текущая команда.
season	string	Нет	Название сезона (напр. "2024/2025"); см. `clubs_career[].seasons[].name` из `/player`. По умолчанию — самый свежий сезон с реальными матчами за эту команду.
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/player_matches?api_key=YOUR_KEY&player_id=lfa-haaland&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4987,
  "data": {
    "player_id": "lfa-haaland",
    "team_id": "lfa-man-city",
    "team_name": "Manchester City",
    "season": "2024/2025",
    "competitions": [
      {
        "league": { "id": "lfa-premier-league", "name": "Premier League" },
        "matches": [
          {
            "id": "lfa4phmwb3bhclg7aqht1ajcwk",
            "date": "2025-08-17 14:00:00",
            "is_home": true,
            "opponent": { "id": "lfa-chelsea", "name": "Chelsea", "logo": "https://live-football-api.com/teams/lfa-chelsea.png" },
            "score": "2-0",
            "goals": 1,
            "assists": 0,
            "yellow_card": false,
            "second_yellow_card": false,
            "red_card": false,
            "started": true
          }
        ]
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

Если team_id/season не указаны, эндпоинт автоматически выбирает самую свежую команду+сезон, где игрок реально выходил на поле (пропуская сезоны с нулём матчей, например сразу после трансфера).

GET /player_search

Поиск игроков по имени. Возвращает подходящих игроков с их ID и фотографиями.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
q	string	Да	Поисковый запрос (название команды или имя игрока)
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

Пример запроса

GET https://live-football-api.com/api/v1/player_search?api_key=YOUR_KEY&q=mbappe

Ответ

{
  "success": true,
  "credits_remaining": 4989,
  "data": {
    "keywords": "mbappe",
    "total": 2,
    "players": [
      {
        "id": "lfa-k-mbappe",
        "name": "K. Mbappe",
        "photo": "https://live-football-api.com/people/lfa-k-mbappe.png",
        "country": "France"
      },
      {
        "id": "lfa-e-mbappe",
        "name": "E. Mbappe",
        "photo": "https://live-football-api.com/people/lfa-e-mbappe.png",
        "country": "France"
      }
    ]
  },
  "timestamp": "2026-07-03 14:22:01"
}

POST /webhook/register

Зарегистрируйте URL для получения уведомления в реальном времени при каждом голе в live-матче. Регистрация бесплатна. Каждое доставленное уведомление о голе стоит 1 кредит.

Вебхуки доставляются через HTTP POST. Сервер должен ответить 2xx в течение 10 секунд, иначе — 3 повтора.

⚠️ Важное уведомление о безопасности Webhook-уведомления отправляются из нашей системы с IP-адреса 45.94.4.69. Для дополнительной безопасности вы можете ограничить входящие запросы к вашему webhook-эндпоинту на вашем сервере (на уровне брандмауэра), разрешив доступ только с этого IP-адреса.

Параметры (тело POST)

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
webhook_url	string	Да	URL для обратного вызова (HTTPS обязателен)
label	string	Нет	Необязательная метка для этого вебхука

Пример запроса

POST https://live-football-api.com/api/v1/webhook/register?api_key=YOUR_KEY
Content-Type: application/json

{
  "webhook_url": "https://yourapp.com/webhooks/football",
  "label": "my server"
}

Ответ

{
  "success": true,
  "data": {
    "id": 1,
    "webhook_url": "https://yourapp.com/webhooks/football",
    "label": "my server",
    "is_active": true,
    "message": "Webhook registered. You will be charged 1 credit per goal notification."
  }
}

GET /webhook/register

Возвращает все зарегистрированные вебхуки. Бесплатно.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ

Пример запроса

GET https://live-football-api.com/api/v1/webhook/register?api_key=YOUR_KEY

Ответ

{
  "success": true,
  "data": {
    "webhooks": [
      {
        "id": 1,
        "webhook_url": "https://yourapp.com/webhooks/football",
        "label": "my server",
        "is_active": true,
        "created_at": "2026-07-04 12:00:00"
      }
    ],
    "total": 1
  }
}

DELETE /webhook/register

Безвозвратно удаляет вебхук. Бесплатно.

Параметры

Параметр	Тип	Обязательный	Описание
api_key	string	Да	Ваш API-ключ
id	integer	Да	ID вебхука для удаления (из списка)

Пример запроса

DELETE https://live-football-api.com/api/v1/webhook/register?api_key=YOUR_KEY&id=1

Ответ

{
  "success": true,
  "data": {
    "message": "Webhook deleted successfully."
  }
}

Примеры нагрузок

Ваш URL будет получать POST-запрос с JSON-телом при каждом голе — это единственный отправляемый тип события.

Goal Event

{
  "event": "goal",
  "match_id": "lfa4phmwb3bhclg7aqht1ajcwk",
  "timestamp": "2026-07-03T14:46:00Z",
  "data": {
    "minute": 46,
    "team": "home",
    "player": "Erling Haaland",
    "assist": "Kevin De Bruyne",
    "score": { "home": 3, "away": 1 }
  }
}

В настоящее время голы — единственный тип события, отправляемый этим API — нет событий card, kickoff или fulltime, и нет параметра event_types для настройки (регистрация принимает только webhook_url и опциональный label).