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

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

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

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

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

https://live-basketball-api.com/api/v2/<endpoint>?api_key=YOUR_KEY

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

Кредиты

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

Остаток возвращается в каждом ответе в поле credits_remaining и заголовке X-Credits-Remaining.

Ошибки

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

{ "error": "Invalid API key.", "code": 401 }

Код	Значение
401	Отсутствующий или недействительный `api_key`
402	Недостаточно кредитов
400	Недопустимый параметр (например, неверный формат даты)
503	Источник данных недоступен

GET /matches

Returns basketball matches for a given date, grouped by area and competition. Optionally translate team and competition names.

GET /api/v2/matches 1 credit

Параметры

Параметр	Обязательный	По умолчанию	Описание
api_key	Да	—	Ваш API-ключ
date	Нет	Сегодня	Match date in `YYYY-MM-DD` format
lang	Нет	`en`	Response language (`en`, `tr`, `de`, `ru`)

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

https://live-basketball-api.com/api/v2/matches?api_key=YOUR_KEY
curl "https://live-basketball-api.com/api/v2/matches?api_key=YOUR_KEY"

Ответ

{
  "status": "ok",
  "date": "2026-09-14",
  "count": 52,
  "matches": [
    {
      "id": "1eqn6tjzbimqz9hmlx4nce1as",
      "start_time": "2026-09-13 22:00:00",
      "status": "Playing",
      "period": "Third Quarter",
      "clock": { "minute": 0, "second": 365 },
      "team1": { "id": "ebcguhyffr8em9ift0qwt7llg", "name": "Santos U23", "short_name": "SAN", "logo": "https://live-basketball-api.com/image/v2/teams/ebcguhyffr8em9ift0qwt7llg.png" },
      "team2": { // same shape },
      "competition": { "id": "...", "name": "1a Divisão Sub-23", "area": { "id": "...", "name": "Brazil", "flag": "https://live-basketball-api.com/image/v2/flags/....png" } },
      "round": "1st Round",
      "quarters": [ { "quarter": 1, "score": [20, 20] } ],
      "score": { "final": [50, 50] },
      "winner": null,
      "is_awarded": false,
      "has_broadcast": false
    }
  ],
  "credits_remaining": 99
}

GET /match/details

Returns full details for a single match: quarter-by-quarter score, teams, competition, season, round and venue.

GET /api/v2/match/details 1 credit

Параметры

Параметр	Обязательный	По умолчанию	Описание
api_key	Да	—	Ваш API-ключ
match_id	Да	—	Match ID from `/matches`
lang	Нет	`en`	Response language (`en`, `tr`, `de`, `ru`)

https://live-basketball-api.com/api/v2/match/details?api_key=YOUR_KEY&match_id=1eqn6tjzbimqz9hmlx4nce1as

GET /match/form

Returns each team's last 5 results (recent form) leading into this match, with opponent and score for each.

GET /api/v2/match/form 1 credit

Параметры

Параметр	Обязательный	По умолчанию	Описание
api_key	Да	—	Ваш API-ключ
match_id	Да	—	Match ID from `/matches`
lang	Нет	`en`	Response language (`en`, `tr`, `de`, `ru`)

https://live-basketball-api.com/api/v2/match/form?api_key=YOUR_KEY&match_id=1eqn6tjzbimqz9hmlx4nce1as

GET /team/players

Returns a team's full roster with per-player season stats (games played, points, assists, rebounds).

GET /api/v2/team/players 1 credit

Параметры

Параметр	Обязательный	По умолчанию	Описание
api_key	Да	—	Ваш API-ключ
team_id	Да	—	Team ID
season_id	Нет	active season	Season ID (from the `seasons` list in this endpoint's response) — roster differs by season
lang	Нет	`en`	Response language (`en`, `tr`, `de`, `ru`)

https://live-basketball-api.com/api/v2/team/players?api_key=YOUR_KEY&team_id=dk1qmybcn1uls9bfgy65e1dug

GET /team/matches

Returns a team's competition standings table and grouped fixture schedule.

GET /api/v2/team/matches 1 credit

Параметры

Параметр	Обязательный	По умолчанию	Описание
api_key	Да	—	Ваш API-ключ
team_id	Да	—	Team ID
season_id	Нет	active season	Season ID (from the `seasons` list in this endpoint's response) — fixtures/standings differ by season
lang	Нет	`en`	Response language (`en`, `tr`, `de`, `ru`)

https://live-basketball-api.com/api/v2/team/matches?api_key=YOUR_KEY&team_id=dk1qmybcn1uls9bfgy65e1dug

GET /competition/details

Returns competition info (seasons, area), the standings table for league-format competitions (null for cups/friendlies that don't have one), plus its full round-by-round schedule and results.

GET /api/v2/competition/details 1 credit

Параметры

Параметр	Обязательный	По умолчанию	Описание
api_key	Да	—	Ваш API-ключ
competition_id	Да	—	Competition ID
season_id	Нет	active season	Season ID (from the `seasons` list in this endpoint's response) — defaults to the active season
lang	Нет	`en`	Response language (`en`, `tr`, `de`, `ru`)

https://live-basketball-api.com/api/v2/competition/details?api_key=YOUR_KEY&competition_id=cyohiao9118myq8vhllxvnliy

GET /player/search

Searches for basketball players by name. Results are already filtered to basketball only — the underlying feed covers every sport, so any player from another sport is dropped before it reaches you.

GET /api/v2/player/search 1 credit

Параметры

Параметр	Обязательный	По умолчанию	Описание
api_key	Да	—	Ваш API-ключ
q	Да	—	Search text (player name)
lang	Нет	`en`	Response language (`en`, `tr`, `de`, `ru`)

https://live-basketball-api.com/api/v2/player/search?api_key=YOUR_KEY&q=lebron%20james

Ответ

{
  "status": "ok",
  "query": "lebron james",
  "players": [
    { "id": "1ryu7mdwimohk0gin1u89b6x", "name": "LeBron James", "photo": "https://live-basketball-api.com/image/v2/players/....png", "area": { "id": "...", "name": "USA" } }
  ]
}

GET /team/search

Searches for basketball teams by name. Results are already filtered to basketball only.

GET /api/v2/team/search 1 credit

Параметры

Параметр	Обязательный	По умолчанию	Описание
api_key	Да	—	Ваш API-ключ
q	Да	—	Search text (team name)
lang	Нет	`en`	Response language (`en`, `tr`, `de`, `ru`)

https://live-basketball-api.com/api/v2/team/search?api_key=YOUR_KEY&q=boston%20celtics

Ответ

{
  "status": "ok",
  "query": "boston celtics",
  "teams": [
    { "id": "...", "name": "Boston", "logo": "https://live-basketball-api.com/image/v2/teams/....png", "area": { "id": "...", "name": "USA" } }
  ]
}

GET /league/search

Searches for basketball competitions/leagues by name. Use the returned id with GET /competition/details to get standings and fixtures.

GET /api/v2/league/search 1 credit

Параметры

Параметр	Обязательный	По умолчанию	Описание
api_key	Да	—	Ваш API-ключ
q	Да	—	Search text (league/competition name)
lang	Нет	`en`	Response language (`en`, `tr`, `de`, `ru`)

https://live-basketball-api.com/api/v2/league/search?api_key=YOUR_KEY&q=Türkiye%20Sigorta%20BSL

Ответ

{
  "status": "ok",
  "query": "Türkiye Sigorta BSL",
  "leagues": [
    { "id": "c744bzsdcz9n7pz90phxoxuh9", "name": "Türkiye Sigorta BSL", "area": { "id": "...", "name": "Türkiye" } }
  ]
}

GET /player/details

Returns a player's profile (position, height, weight, nationality, current club) plus their full club and international career history, broken down by team, season and competition (games played, points, assists).

GET /api/v2/player/details 1 credit

Параметры

Параметр	Обязательный	По умолчанию	Описание
api_key	Да	—	Ваш API-ключ
player_id	Да	—	Player ID, from `/player/search` or a roster in `/team/players`
lang	Нет	`en`	Response language (`en`, `tr`, `de`, `ru`)

https://live-basketball-api.com/api/v2/player/details?api_key=YOUR_KEY&player_id=1ryu7mdwimohk0gin1u89b6x

Ответ

{
  "status": "ok",
  "player": {
    "id": "1ryu7mdwimohk0gin1u89b6x", "name": "L. James", "first_name": "LeBron", "last_name": "James",
    "photo": "https://live-basketball-api.com/image/v2/players/....png",
    "nationality": "USA", "position": "Forward", "height": "206 cm", "weight": "113 kg",
    "birthdate": "1984-12-30", "current_club": "Philadelphia", "shirt_number": "23"
  },
  "club_career": [
    {
      "team": { "id": "2ja1jlnhsy0ksuvvxzff3ky9e", "name": "LA Lakers", "logo": "https://live-basketball-api.com/image/v2/teams/....png" },
      "date_start": "2018-07-09Z", "date_end": "2026-07-25Z",
      "seasons": [
        { "name": "2025/2026", "competitions": [
          { "competition": { "id": "...", "name": "NBA" }, "games_played": 70, "points": 1488, "avg_points": 21.3, "assists": 507 }
        ] }
      ]
    }
  ],
  "international_career": [ // same shape, national team stints ]
}