Sports Data API — REST API спортивных данных SportWire

// ПРИМЕР

Один запрос — полный контекст

Один GET возвращает матч целиком — счёт, события, статистику, xG и готовую аналитику. Без склейки десятка источников.

curl · api.sportwire.ru

$ curl api.sportwire.ru/v1/event/8842?key=…
{
  "id": 8842, "sport": "football",
  "tournament": "РПЛ", "tournament_ru": "РПЛ",
  "status": "live", "minute": 67,
  "home": { "name": "ЦСКА", "score": 2 },
  "away": { "name": "Зенит", "score": 1 },
  "xg": [1.84, 1.12],
  "insights": {
    "over_2_5": "8/10", "btts": "7/10",
    "model": { "p1": 0.52, "x": 0.26, "p2": 0.22 }
  },
  "weather": { "t": 7, "wind": 4.1 }
}

РПЛ · 24-й турLIVE 67'

ЦСКЦСКА

2:1

ЗЕНЗенит

Моментум · xG по ходу матчаxG 1.84

Over 2.5 — 8/10 П1 52% · кэф 1.92 7°C · ветер 4 м/с

// ENDPOINTS

Основные endpoints

Все данные доступны через единый REST API. Ниже — ключевые маршруты для работы с матчами, командами и контентом.

GET /v1/events

Расписание и список матчей

Все матчи по дате, лиге и статусу. Поддерживает фильтрацию по виду спорта и турниру.

GET /v1/event/{id}

Полная карточка матча

Счёт, статус, события, статистика команд, состав, xG и модельные оценки в одном запросе.

GET /v1/event/{id}/insights

Аналитика и модель

Готовая предматчевая аналитика: форма, H2H, статистические тренды и модельные вероятности.

GET /v1/participant/{id}/image

Логотипы и фото

Гербы клубов, фотографии игроков и изображения лиг. Доступны несколько размеров и форматов.

GET /v1/leagues

Лиги и турниры

Полный каталог лиг с идентификаторами, страной, уровнем и доступными модулями данных.

GET /v1/team/{id}/form

Форма команды

Результаты последних N матчей, тренд, среднее голов, серия и позиция в таблице.

Все endpoints в документации

// RATE LIMITS

Rate limits в API

Каждый тариф имеет свои лимиты. Информация о лимитах передаётся в заголовках каждого ответа.

API возвращает заголовки X-RateLimit-* с каждым ответом. Следите за значением X-RateLimit-Remaining и реализуйте retry-логику при получении 429 Too Many Requests.

Статические данные (логотипы, составы до матча) рекомендуется кешировать на стороне клиента. Live-данные обновляются раз в 15–30 секунд, нет смысла опрашивать чаще.

Код	Значение	Что делать
`200`	OK	Данные получены
`400`	Bad Request	Проверьте параметры запроса
`401`	Unauthorized	Ключ отсутствует или недействителен
`403`	Forbidden	Модуль недоступен на вашем тарифе
`404`	Not Found	Объект не найден
`429`	Too Many Requests	Снизьте частоту, используйте Retry-After
`500`	Server Error	Повторите через несколько секунд

Response headers

# Заголовки в каждом ответе

HTTP/2 200 OK
Content-Type: application/json
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 47
X-RateLimit-Reset: 1718910060
X-RateLimit-Window: minute

# При превышении лимита

HTTP/2 429 Too Many Requests
Retry-After: 23
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1718910083

// МОДУЛИ

Модули данных

Каждый модуль данных — отдельный блок API: от live-счёта до xG, погоды и русской локализации.

Live-счёт

Статус матча, текущий счёт и минута. Обновление ~20 сек. Поддерживает polling.

События матча

Голы, карточки, замены, VAR, пенальти — с минутой и участниками события.

Статистика команд

Владение, удары, угловые, офсайды, фолы, точность передач и сейвы вратаря.

xG и expected stats

Ожидаемые голы (xG), xA и карта ударов по ходу матча. Доступна история.

Составы

Стартовый состав, скамейка, формация, номера и позиции игроков.

Коэффициенты

Открывающие и текущие коэффициенты от ведущих букмекеров.

Изображения

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

Расписание

Матчи на дату, неделю или месяц с фильтрами по видам спорта и лигам.

Предматчевая аналитика

Инсайты, форма и тренды команд, H2H, вероятности исходов.

Исторические данные

История матчей, турнирные таблицы, рекорды сезонов и лиг.

Погода

Температура, ветер, осадки и влажность на стадионе в момент матча.

Русская локализация

Названия команд, лиг и игроков на русском языке в отдельных полях.

REST API для спортивных данных и аналитики

Один запрос — полный контекст

Основные endpoints

Rate limits в API

Модули данных

Подключите Sports Data API за один день