Игроки

Информация об игроках

📄️Получить список игроков

Возвращает список игроков по их ID, по ID команды или по текстовому запросу для указанного вида спорта. Обязателен один из параметров: ids, team_id или q

📄️Сезоны со статистикой игрока

Список турниров и сезонов, за которые у игрока доступна сезонная статистика, с доступными типами статистики по каждому сезону. Доступность по видам спорта: игроки — football, basketball, ice-hockey, volleyball (volleyball — в основном крупные международные турниры); команды — football, basketball, ice-hockey, tennis, volleyball (tennis: команда = игрок, volleyball — в основном сборные). Для esports и table-tennis сезонная статистика недоступна. См. также: https://docs.api-sport.ru/concepts/season-statistics.

📄️Сезонная статистика игрока

Сезонная статистика игрока в указанном турнире и сезоне по типам статистики (overall, regularSeason, playoffs, home, away, ...). Названия и переводы ключей показателей — в словаре /v2/SeasonStatisticsDict.json. Доступность по видам спорта: игроки — football, basketball, ice-hockey, volleyball (volleyball — в основном крупные международные турниры); команды — football, basketball, ice-hockey, tennis, volleyball (tennis: команда = игрок, volleyball — в основном сборные). Для esports и table-tennis сезонная статистика недоступна. См. также: https://docs.api-sport.ru/concepts/season-statistics.

📄️Последняя статистика игрока (one-shot)

Последняя актуальная сезонная статистика игрока одним запросом — упрощённый вариант без предварительного запроса списка сезонов. Выбор данных: турнир — первый в списке по релевантности (или заданный `tournament_id`); сезон — новейший, за который уже собраны данные (при отсутствии данных в новейшем сезоне возвращается предыдущий, при отсутствии в турнире — следующий турнир списка, если `tournament_id` не задан); тип — `overall`, иначе `regularSeason`, иначе `mainDraw`, иначе первый доступный (или заданный `type` — тогда возвращается последний сезон, где этот тип есть). Фактически выбранные турнир, сезон и тип всегда видны в полях ответа. Доступность по видам спорта: игроки — football, basketball, ice-hockey, volleyball (volleyball — в основном крупные международные турниры); команды — football, basketball, ice-hockey, tennis, volleyball (tennis: команда = игрок, volleyball — в основном сборные). Для esports и table-tennis сезонная статистика недоступна. См. также: https://docs.api-sport.ru/concepts/season-statistics.

📄️Профиль игрока

Расширенный профиль игрока: характеристики (сильные/слабые стороны, football), атрибуты по годам (football), статистика за сборную (football), история трансферов (football, basketball), рыночный блок (трансферная стоимость и срок контракта), рабочая нога и детализированные позиции (football). Блоки, недоступные для вида спорта, отдаются как null или пустой массив.

📄️Последние матчи игрока

Последние завершённые матчи игрока, новые сначала. По умолчанию — ВСЕ матчи, в которых игрок выходил в составе, независимо от команды: клубные и за сборную (каждый элемент — `played=true` со строкой статистики). Каждый элемент — компактная карточка матча (турнир, сезон, раунд, команды, счёт, исход) плюс участие игрока: позиция, номер, капитанство, выход на замену и плоский объект показателей `statistics`. Командный режим — `team_id=<id>` (конкретная команда) или `current_team=true` (текущая команда игрока): возвращаются все последние матчи этой команды, включая те, где игрок не выходил (`played=false`, `statistics=null`); фильтр `played_only=true` в командном режиме оставляет только сыгранные. Для видов спорта без составов (теннис, настольный теннис, волейбол, киберспорт) используйте командный режим — он работает как история матчей команды/пары игрока с `played=false`.