SSTATS API Версия документации: 0.4.1

API SStats.net предоставляет данные о футбольных матчах (статистика, коэффициенты, составы, события и т.д) в формате JSON.

Основной адрес: https://api.sstats.net

Авторизация

Для использования API вам необходимо иметь api-ключ, который представляет собой строку из 16 символов.
API ключ: 75kwgw7361l0l1ir. Ограничение: 180 запросов в минуту на всех пользователей.

API-ключ (apikey) должен передаваться в каждом запросе одним из трёх способов:

1. В HTTP заголовках в поле apikey.
Пример: 
curl --location 'https://api.sstats.net/games/1063599' \
--header 'apikey: 75kwgw7361l0l1ir'

2. В параметре адреса
Пример: 
https://api.sstats.net/games/1063599?apikey=75kwgw7361l0l1ir

3. Либо поле apikey должно присутсвовать в Cookie

Ошибки и ограничения

Если api-ключ не передан, то возвращается ошибка с HTTP статусом 401 
{
        "status": "error",
        "message": "No valid key received",
        "statusCode": 401
}


При превышении максимального количества допустимых запросов в минуту, возвращается ошибка с HTTP статусом 429: 
{
        "status": "error",
        "message": "Request limit reached",
        "statusCode": 429
}

Account

/account/info
Информация о владельце API-ключа и проверка его валидности


Прмер: https://api.sstats.net/account/info?apikey=75kwgw7361l0l1ir

Countries


Leagues

/leagues
Список лиг и сезонов

Пример:
https://api.sstats.net/leagues

Seasons


Games

Обновление списка матчей на сервере происходит примерно раз в три часа. Обновление данных о матчах происходит раз в 5 минут.

/games/list
Извлечение списка матчей. Данные о каждом матче возвращаются в сокращенном варианте (только основная информация). Для получения полной информации о конкретном матче используется /games/{id}
Параметры: (все параметры являются необязательными)
Название Тип Описание Пример
Id число / список Один или несколько идентификаторов через запятую. Позволяет извлечь сразу несолько матчей по Id 1105093,1100628,1100629
FlashId строка / список Id матча (один или несколько через запятую) с сайтов flashscore.com (myscore.ru), flashfootball.com (soccerstand.com). 8 cимволов Eup2yYAC,82q6zhQI
LeagueId число Идентификатор лиги 898
SeasonUid строка Идентификатор сезона 1DC9CB63-0958-11EE-B462-879841420925
Year число Год сезона 2023
From дата Период "от". Дата в формате (ГГГГ-ММ-ДД) 2022-12-30
To дата Период "до". Дата в формате (ГГГГ-ММ-ДД) 2023-01-30
Status число Статус матча. (См. все статусы) 2
HomeTeam число / список Id домашней команды, или несколько Id через запятую 529
AwayTeam число / список Id гостевой команды, или несколько Id через запятую 529,14171
Team число / список Id любой из команд (хозяева или гости), или несколько Id через запятую 529
BothTeams число / список И команда хозяев и команда гостей должна быть из этого списка. Встречи команд между собой 529,541
Ended boolean. Матч закончен. 'true' или 'false' true
Live boolean. Матч в процессе. 'true' или 'false' false
Upcoming boolean Предстоящий матч. 'true' или 'false'
Limit число Ограничить количество возвращенных матчей. (Не больше 300) 5
Offset число Пропустить первые n матчей и возвратить следующие. Используется для извлечения матчей порциями 300
Order число Сортировка по дате игры. '1' - по возврастанию, '-1' - по убыванию. По умолчанию - во возврастанию -1
IncludeOdds boolean Включить в ответ коэфициенты (основные) true


Примеры:
Извлечение всех матчей по id лиги и году сезона https://api.sstats.net/games/list?leagueid=183&year=2022 Извлечение всех матчей по id сезона 1DC9CB60-0958-11EE-B462-879841420925 https://api.sstats.net/games/list?seasonUid=1DC9CB60-0958-11EE-B462-879841420925 Извлечение всех матчей по id лиги и временному интервалу https://api.sstats.net/games/list?leagueid=183&from=2022-10-30&to=2022-12-30 Предстоящие матчи команды https://api.sstats.net/games/list?upcoming=true&team=529 Прошедшие матчи между командами когда они играли друг с другом (Head 2 Head) https://api.sstats.net/games/list?ended=true&bothTeams=529,541 Патч по Flash Id
/games/{id}
Получение полных данных о матче. В ответе коэффициенты только основные. Чтоб получить все коэфициенты по всем букмекерам, используйте /odds/{id}

Параметры:
Название Тип Описание Пример
Id int Идентификатор матча 830966
Пример:
https://api.sstats.net/games/851183


Teams


Players


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

/odds/{id}
Доматчевые коэфициенты. Обновляются раз в несколько часов

Параметры
Название Тип Описание Пример
Id int Идентификатор матча 830966

Пример
https://api.sstats.net/odds/838346




/odds/live/{id}
Коэфициенты матча в режиме реального времени. Обновляются раз в 10-15 секунд. После завершения матча данные коэфициенты могут быть отражать последнее изменение


Пример
https://api.sstats.net/odds/live/838346


Stadiums


FAQ

Справочник

Статусы матча
1 — Time To Be Defined
2 — Not Started
3 — "First Half — Kick Off"
4 — Halftime
5 — "Second Half — 2nd Half Started"
6 — Extra Time
7 — Penalty In Progress
8 — Match Finished
9 — Match Finished After Extra Time
10 — Match Finished After Penalty
11 — Break Time in Extra Time
12 — Match Suspended
13 — Match Interrupted
14 — Match Postponed
15 — Match Cancelled
16 — Match Abandoned
17 — Technical Loss
18 — WalkOver
19 — In Progress
Типы доматчевых ставок
Типы Live ставок