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

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

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

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

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

https://live-volleyball-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 /csb	Бесплатно
GET /lineups	1 кредит за вызов
GET /h2h	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 /team_search	1 кредит за вызов
GET /player_search	1 кредит за вызов

Ошибки

Все ошибки возвращают 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-volleyball-api.com/api/v1/matches?api_key=YOUR_KEY&date=2026-09-01&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4999,
  "data": {
    "date": "2026-09-01",
    "language": "en",
    "timezone": "UTC+3",
    "matches": [
      {
        "id": "ae31818d-1eed-4f9f-abf7-84646dfe3aac",
        "league": {
          "id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
          "name": "European Championship Women Round of 16",
          "area": "World",
          "logo": "https://live-volleyball-api.com/leagues/b823d3cc-6286-1e9b-8ed5-e492f1761c40.png"
        },
        "date_time": "2026-09-01 16:20:00",
        "kickoff": "16:20",
        "status": {
          "status": "live",
          "display": "Live",
          "is_live": true
        },
        "home": {
          "id": "5740b6e3-8751-0dfd-1751-28c7cb764849",
          "name": "Turkey (W)",
          "logo": "https://live-volleyball-api.com/teams/5740b6e3-8751-0dfd-1751-28c7cb764849.png",
          "sets": 1
        },
        "away": {
          "id": "f206c54c-6d97-251a-cfdf-b74423417fa0",
          "name": "Azerbaijan (W)",
          "logo": "https://live-volleyball-api.com/teams/f206c54c-6d97-251a-cfdf-b74423417fa0.png",
          "sets": 0
        },
        "current_set_points": { "home": 11, "away": 10 },
        "tv_broadcast": true,
        "has_live_bet": true
      }
    ]
  },
  "timestamp": "2026-09-01 16:22:01"
}

status.status — одно из значений scheduled, live, finished, cancelled, postponed. current_set_points — текущий счёт по очкам в игровой партии, null если матч не идёт live. tv_broadcast / has_live_bet — булевы поля из исходных данных.

GET /live_match_details

Возвращает метаданные матча: информацию о турнире/раунде, площадку, данные о трансляции, турнирную сетку и URL встраиваемого виджета живых комментариев.

Параметры

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

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

GET https://live-volleyball-api.com/api/v1/live_match_details?api_key=YOUR_KEY&match_id=ae31818d-1eed-4f9f-abf7-84646dfe3aac&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4998,
  "data": {
    "match_id": "ae31818d-1eed-4f9f-abf7-84646dfe3aac",
    "title": "World - European Championship Women",
    "competition_name": "European Championship Women",
    "area_id": "b5f65d72-ec19-43d8-5ddb-a6ff45957d02",
    "league_id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
    "season_id": "1481a945-09d3-d8e9-d24d-caa45102514e",
    "date_time": "2026-09-01 16:20:00",
    "uncertain_time": false,
    "venue": "Sinan Erdem Sports Hall",
    "broadcasts": "TRT 1, tabii, TRT Spor Yıldız YouTube",
    "has_live_bet": true,
    "home": {
      "id": "5740b6e3-8751-0dfd-1751-28c7cb764849",
      "name": "Turkey (W)",
      "logo": "https://live-volleyball-api.com/teams/5740b6e3-8751-0dfd-1751-28c7cb764849.png"
    },
    "away": {
      "id": "f206c54c-6d97-251a-cfdf-b74423417fa0",
      "name": "Azerbaijan (W)",
      "logo": "https://live-volleyball-api.com/teams/f206c54c-6d97-251a-cfdf-b74423417fa0.png"
    },
    "csb_url": "https://live-volleyball-api.com/csb?id=6743466&lang=en",
    "bracket": { "round_names": ["Round of 16", "Quarterfinal", "Semifinal", "Final"], "rounds": [ [] ] },
    "slug": "turkey-vs-azerbaijan"
  },
  "timestamp": "2026-09-01 16:22:01"
}

bracket — полная турнирная сетка для матчей плей-офф, null для турниров кругового формата. Этот эндпоинт не содержит хронологию событий в реальном времени или статистику матча — используйте /matches для текущего счёта по партиям.

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

GET /csb

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

Параметры

Параметр	Тип	Обязательный	Описание
id	string	Да	Числовой ID виджета, извлечённый из строки запроса `csb_url` в ответе /live_match_details — используйте возвращённый `csb_url` напрямую в iframe, не собирайте этот URL вручную.
lang	string	Нет	Язык ответа: `en` `tr` `de` `ru`

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

<iframe
  src="https://live-volleyball-api.com/csb?id=6743466&lang=en"
  width="636"
  height="400"
  frameborder="0"
  allowtransparency="true"
></iframe>

Всегда получайте id из свежего вызова /live_match_details, а не жёстко фиксируйте его — ID виджета может измениться при переносе или переигровке матча.

GET /lineups

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

Параметры

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

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

GET https://live-volleyball-api.com/api/v1/lineups?api_key=YOUR_KEY&match_id=6f863cce-4607-46b5-bb14-1701d5247316&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4997,
  "data": {
    "match_id": "6f863cce-4607-46b5-bb14-1701d5247316",
    "home": [
      { "id": "010a289d-be42-f932-7f15-54d39782ebfb", "number": "7", "name": "A. Koulberg", "nationality_id": "a1f4a627-5510-54f7-0f17-98ee028b06bc", "image": "https://live-volleyball-api.com/people/010a289d-be42-f932-7f15-54d39782ebfb.png" },
      { "id": "0314d212-2fa0-d823-c3c2-f76bc54b5c43", "number": "10", "name": "P. Martin", "nationality_id": "a1f4a627-5510-54f7-0f17-98ee028b06bc", "image": "https://live-volleyball-api.com/people/0314d212-2fa0-d823-c3c2-f76bc54b5c43.png" }
    ],
    "away": [
      { "id": "example-away-player-id", "number": "5", "name": "K. Lohmann", "nationality_id": "example-nationality-id", "image": "https://live-volleyball-api.com/people/example-away-player-id.png" }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

home и away — плоские списки состава (без деления на старт/скамейку) — в волейбольных данных передаётся заявленный состав, а не расстановка.

GET /h2h

Возвращает текущую форму обеих команд (последние 5 матчей) и историю их личных встреч.

Параметры

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

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

GET https://live-volleyball-api.com/api/v1/h2h?api_key=YOUR_KEY&match_id=6f863cce-4607-46b5-bb14-1701d5247316&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4996,
  "data": {
    "match_id": "6f863cce-4607-46b5-bb14-1701d5247316",
    "home_form": [
      { "id": "8f4a8162-9d46-8190-e45c-40e3fbfeba0d", "date": "2026-08-27", "home": "Netherlands (W)", "away": "Belgium (W)", "score": "2-3", "won": true }
    ],
    "away_form": [
      { "id": "9e2c1a77-1234-5678-9abc-def012345678", "date": "2026-08-28", "home": "Germany (W)", "away": "Poland (W)", "score": "1-3", "won": false }
    ],
    "h2h": [
      { "id": "example-h2h-match-id", "date": "2025-07-10", "home": "Belgium (W)", "away": "Germany (W)", "score": "3-1", "won": true }
    ],
    "home_series": [0, 1, 1, 1, 1],
    "away_series": [1, 0, 0, 1, 1]
  },
  "timestamp": "2026-09-01 14:22:01"
}

home_series / away_series — те же результаты последних 5 матчей в виде последовательности побед/поражений (0/1), в том же порядке, что и home_form / away_form.

GET /league

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

Параметры

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

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

GET https://live-volleyball-api.com/api/v1/league?api_key=YOUR_KEY&league_id=b823d3cc-6286-1e9b-8ed5-e492f1761c40&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4993,
  "data": {
    "id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
    "name": "European Championship Women",
    "logo": "https://live-volleyball-api.com/leagues/b823d3cc-6286-1e9b-8ed5-e492f1761c40.png",
    "area": { "id": "b5f65d72-ec19-43d8-5ddb-a6ff45957d02", "name": "World" },
    "seasons": [
      { "id": "1481a945-09d3-d8e9-d24d-caa45102514e", "name": "2026", "selected": true },
      { "id": "bedd9910-09f0-8286-cc5f-90baf99d6006", "name": "2023", "selected": false }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

Каждая запись в seasons — выбираемый сезон: передайте её id как season_id в /league_standings или /league_fixtures, чтобы посмотреть прошлый сезон вместо текущего.

GET /league_standings

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

Параметры

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

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

GET https://live-volleyball-api.com/api/v1/league_standings?api_key=YOUR_KEY&league_id=b823d3cc-6286-1e9b-8ed5-e492f1761c40&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4992,
  "data": {
    "league_id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
    "columns": ["Rank", "Team", "P", "W", "L", "S", "Pts"],
    "tabs": ["Overall", "Home", "Away"],
    "zones": [ { "id": "836572bd-a2fe-1404-1743-964ec9c7baca", "name": "Qualified", "color": "#02206B" } ],
    "standings": [
      {
        "title": "Group A",
        "round_id": "99d8f31f-42b5-dd52-62e5-d7e4a7ee8fdb",
        "group_id": "99d8f31f-42b5-dd52-62e5-d7e4a7ee8fdb",
        "week": 5,
        "max_week": 5,
        "total": [
          {
            "team_id": "83f6313f-0cb3-ca49-c3c9-d8daaf1ce99d",
            "team_name": "Poland (W)",
            "logo": "https://live-volleyball-api.com/teams/83f6313f-0cb3-ca49-c3c9-d8daaf1ce99d.png",
            "columns": ["1", "Poland (W)", "5", "5", "0", "15-3", "14"],
            "zone_id": "836572bd-a2fe-1404-1743-964ec9c7baca"
          }
        ],
        "home": [ ],
        "away": [ ]
      }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

columns — локализованные заголовки столбцов для массива columns каждой строки (тот же порядок). tabs перечисляет доступные виды таблицы (общая/дома/в гостях) — в каждой группе есть соответствующие массивы total / home / away. zones описывает цвета зон еврокубков/вылета, на которые указывает zone_id каждой строки.

GET /league_fixtures

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

Параметры

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

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

GET https://live-volleyball-api.com/api/v1/league_fixtures?api_key=YOUR_KEY&league_id=b823d3cc-6286-1e9b-8ed5-e492f1761c40&lang=tr

Ответ

{
  "success": true,
  "credits_remaining": 4991,
  "data": {
    "league_id": "b823d3cc-6286-1e9b-8ed5-e492f1761c40",
    "weeks": [
      {
        "title": "1. Week",
        "matches": [
          {
            "id": "9a674f49-43f5-2447-56f1-71681ac5801e",
            "date_time": "2026-08-21 11:00:00",
            "status": "finished",
            "home": {
              "id": "d682a14f-59a3-a7fe-c7ab-0c3efe87fe24",
              "name": "France (W)",
              "logo": "https://live-volleyball-api.com/teams/d682a14f-59a3-a7fe-c7ab-0c3efe87fe24.png",
              "sets": 3
            },
            "away": {
              "id": "747b36c4-61e7-e3ab-6ab0-a8dedfa5d852",
              "name": "Slovakia (W)",
              "logo": "https://live-volleyball-api.com/teams/747b36c4-61e7-e3ab-6ab0-a8dedfa5d852.png",
              "sets": 0
            }
          }
        ]
      }
    ]
  },
  "timestamp": "2026-08-31 12:00:00"
}

GET /team_matches

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

Параметры

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

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

GET https://live-volleyball-api.com/api/v1/team_matches?api_key=YOUR_KEY&team_id=547c6214-9072-0db0-cf71-35eacb40f104&season=2026&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4991,
  "data": {
    "team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
    "season": "2026",
    "competitions": [
      {
        "id": "d1e7325d-5b84-4735-bf93-8d08da440deb",
        "title": "World - International Friendly Women",
        "area_id": "b5f65d72-ec19-43d8-5ddb-a6ff45957d02",
        "rounds": [
          {
            "id": "59c4337f-9b1c-4bab-b7dd-a300d32d9965",
            "name": "Regular Season",
            "matches": [
              {
                "id": "9d3939df-0c5b-4ea6-ac29-75c8a1717cba",
                "date_time": "2026-05-14 19:00:00",
                "status": "finished",
                "home": { "id": "547c6214-9072-0db0-cf71-35eacb40f104", "name": "Italy (W)", "logo": "https://live-volleyball-api.com/teams/547c6214-9072-0db0-cf71-35eacb40f104.png", "sets": 3 },
                "away": { "id": "d682a14f-59a3-a7fe-c7ab-0c3efe87fe24", "name": "France (W)", "logo": "https://live-volleyball-api.com/teams/d682a14f-59a3-a7fe-c7ab-0c3efe87fe24.png", "sets": 0 },
                "won": true
              }
            ]
          }
        ]
      }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

GET /team_squad

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

Параметры

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

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

GET https://live-volleyball-api.com/api/v1/team_squad?api_key=YOUR_KEY&team_id=547c6214-9072-0db0-cf71-35eacb40f104

Ответ

{
  "success": true,
  "credits_remaining": 4990,
  "data": {
    "team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
    "name": "Italy (W)",
    "logo": "https://live-volleyball-api.com/teams/547c6214-9072-0db0-cf71-35eacb40f104.png",
    "season": "2026",
    "available_seasons": ["2026", "2026 Italy", "2025", "2024 Paris", "2024", "2023", "2022"],
    "column_names": ["No", "Player", "P", "Age", "M", "Points", "Blk"],
    "coach": {
      "id": "c3d1b6c7-9278-4a14-8fc4-09b3a5a34161",
      "name": "Julio Velasco",
      "nationality_id": "501dc4bd-8129-8c1b-9873-704cb5165dee",
      "image": "https://live-volleyball-api.com/people/c3d1b6c7-9278-4a14-8fc4-09b3a5a34161.png"
    },
    "players": [
      {
        "id": "168ec450-c327-a648-8325-f2f3b4088d18",
        "name": "M. Sylla",
        "number": "17",
        "nationality_id": "8e69dfd6-38ee-7738-3d1c-2028011930f8",
        "nationality": "Italy",
        "active_team_id": "f75aa922-8e34-70e7-2c75-9635c1ce3a87",
        "active_team_name": "Galatasaray Daikin (W)",
        "image": "https://live-volleyball-api.com/people/168ec450-c327-a648-8325-f2f3b4088d18.png",
        "columns": ["17", "M. Sylla", "S", "32", "12", "8.7", "0.8"]
      }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

column_names — локализованные заголовки столбцов для массива columns каждого игрока (тот же порядок) — конкретные статистические столбцы зависят от турнира.

GET /team_standings

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

Параметры

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

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

GET https://live-volleyball-api.com/api/v1/team_standings?api_key=YOUR_KEY&team_id=547c6214-9072-0db0-cf71-35eacb40f104&season=2026&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4989,
  "data": {
    "team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
    "season": "2026",
    "columns": ["Rank", "Team", "P", "W", "L", "S", "Pts"],
    "tabs": ["Overall", "Home", "Away"],
    "standings": [
      {
        "title": "Nations League Women",
        "round_id": "bcb2531a-c8d3-402e-a8e1-a3647b8a4f6c",
        "week": 12,
        "max_week": 12,
        "total": [
          {
            "team_id": "547c6214-9072-0db0-cf71-35eacb40f104",
            "team_name": "Italy (W)",
            "logo": "https://live-volleyball-api.com/teams/547c6214-9072-0db0-cf71-35eacb40f104.png",
            "columns": ["2", "Italy (W)", "12", "10", "2", "32-14", "28"],
            "zone_id": "6a4acb0f-3450-cec7-199a-d2a0e34c96ea"
          }
        ]
      }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

GET /team_search

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

Параметры

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

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

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

Ответ

{
  "success": true,
  "credits_remaining": 4990,
  "data": {
    "keywords": "eczacibasi",
    "total": 3,
    "teams": [
      {
        "id": "f244f38b-d084-9902-b52e-e068873c4a46",
        "name": "Eczacıbaşı Peron İstanbul (W)",
        "logo": "https://live-volleyball-api.com/teams/f244f38b-d084-9902-b52e-e068873c4a46.png",
        "country": "Turkey"
      },
      {
        "id": "a00b9015-94e6-c24f-9c9a-3e4ecdfffdcf",
        "name": "Eczacıbaşı II (W)",
        "logo": "https://live-volleyball-api.com/teams/a00b9015-94e6-c24f-9c9a-3e4ecdfffdcf.png",
        "country": "Turkey"
      }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}

Базовый поисковый индекс охватывает все виды спорта, которые обслуживает mackolikfeeds (футбол, баскетбол, волейбол и т.д.) без явного поля вида спорта — мы фильтруем только волейбольные результаты на стороне сервера, поэтому команды/игроки других видов спорта никогда не попадают в ответ.

GET /player

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

Параметры

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

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

GET https://live-volleyball-api.com/api/v1/player?api_key=YOUR_KEY&player_id=0d66ae65-5596-8a3f-9165-a1d3d5e47d14&lang=en

Ответ

{
  "success": true,
  "credits_remaining": 4988,
  "data": {
    "player_id": "0d66ae65-5596-8a3f-9165-a1d3d5e47d14",
    "name": "Sinead Jack-Kısal",
    "shirt_number": "88",
    "photo": "https://live-volleyball-api.com/people/0d66ae65-5596-8a3f-9165-a1d3d5e47d14.png",
    "team_id": "c86225f5-6f73-0097-474f-45c9a2357948",
    "team_logo": "https://live-volleyball-api.com/teams/c86225f5-6f73-0097-474f-45c9a2357948.png",
    "profile": [
      { "label": "First Name", "value": "Sinead" },
      { "label": "Last Name", "value": "Jack-Kısal" },
      { "label": "Date of Birth", "value": "08 Nov 1993 (Age: 33)" },
      { "label": "Nationality", "value": "Turkey" },
      { "label": "Height", "value": "196 cm" },
      { "label": "Weight", "value": "83 kg" },
      { "label": "Position", "value": "Middle Blocker" },
      { "label": "Hand", "value": "Right" },
      { "label": "Club", "value": "Fenerbahçe (W)" }
    ],
    "career": {
      "column_names": ["Season", "Team", "Matches", "Points", "Blk"],
      "seasons": [
        { "team_id": "f244f38b-d084-9902-b52e-e068873c4a46", "team_logo": "https://live-volleyball-api.com/teams/f244f38b-d084-9902-b52e-e068873c4a46.png", "columns": ["2025/2026", "Eczacıbaşı Peron İstanbul (W)", "43", "9.5", "2.7"] }
      ]
    },
    "clubs": {
      "column_names": ["Years", "Team", "Matches", "Points", "Blk"],
      "rows": [
        { "team_id": "f244f38b-d084-9902-b52e-e068873c4a46", "team_logo": "https://live-volleyball-api.com/teams/f244f38b-d084-9902-b52e-e068873c4a46.png", "columns": ["2022 - Present", "Eczacıbaşı Dynavit (W)", "153", "6.2", "1.6"] }
      ]
    },
    "national_teams": {
      "column_names": ["Years", "Team", "Matches", "Points", "Blk"],
      "rows": [
        { "team_id": "5740b6e3-8751-0dfd-1751-28c7cb764849", "team_logo": "https://live-volleyball-api.com/teams/5740b6e3-8751-0dfd-1751-28c7cb764849.png", "columns": ["2025 - Present", "Turkey (W)", "22", "7.4", "1.5"] }
      ]
    },
    "slug": "sinead-jack-kisal"
  },
  "timestamp": "2026-09-01 14:22:01"
}

profile — список локализованных пар label/value именно в том виде, в каком их предоставляет источник — порядок полей и подписи могут отличаться у разных игроков. career — по сезонам, а clubs / national_teams суммируют каждый период в клубе или сборной одной строкой.

GET /player_search

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

Параметры

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

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

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

Ответ

{
  "success": true,
  "credits_remaining": 4989,
  "data": {
    "keywords": "antropova",
    "total": 1,
    "players": [
      {
        "id": "23bf9fb8-bcc8-5ee0-14c4-f227d4081895",
        "name": "E. Antropova",
        "photo": "https://live-volleyball-api.com/people/23bf9fb8-bcc8-5ee0-14c4-f227d4081895.png",
        "country": "Italy"
      }
    ]
  },
  "timestamp": "2026-09-01 14:22:01"
}