Искали бесплатное API или парсер для букмекерской конторы?
Sstats.net представляет бесплатное API для получения данных от букмекера Pari.ru.
### [Перейти к API Pari.ru](https://api.sstats.net/docs/#tag/pari)
Sstats.net за вас собирает данные и приводит их в пригодный для анализа вид. Вам больше не нужно искать парсер, держать его онлайн и постоянно заботиться о его работоспособности.
Благодаря большому объему данных и заточенности под быстродействие, наше API для Pari.ru удобно использовать для лайв-сканеров и аналитики.
## Основные возможности
* **Быстрые лайв-коэффициенты:** Обновление актуальных данных происходит каждые 3 секунды.
* **Полная история движения коэффициентов:** Детальная история изменений котировок, от открытия линии до самого окончания матча (как в прематче, так и в лайве).
* **Огромный выбор рынков:** Большой и детализированный справочник доступных рынков коэффициентов (маркетов).
* **Масштабная база данных:** Мы храним и агрегируем большой объем исторических и статистических данных, что открывает широкие возможности для глубокого анализа и построения собственных моделей.
### Поддерживаемые рынки
- Исход (1X2, Двойной шанс)
- Фора
- Тоталы (Общие и индивидуальный тоталы)
- Обе забьют
- Угловые
- Желтые карточки
- Удары в створ
- Офсайды
- Вбросы из аута
- Удар от ворот
- Сейвы
Рынки поддерживаются для разных периодов (1-ый тайм, 2-ой тайм, Основное время)
---
## Основной рабочий процесс (Workflow)
Для эффективной работы с API рекомендуем придерживаться следующего сценария:
1. **Получение справочника стран:** Запросите список стран (`GET /pari/countries`), чтобы получить идентификатор (ID) нужного вам региона.
2. **Поиск лиги:** Используя ID нужной страны, получите список турниров (`GET /pari/leagues?countryId=...`).
3. **Получение списка матчей:** Запросите матчи выбранной лиги или за определенную дату (`GET /pari/matches?...`). В ответ придет список событий с мета-данными. На этом шаге коэффициенты не возвращаются, вы получаете лишь идентификаторы матчей (`eventId`) для дальнейшей навигации.
4. **Детали матча и коэффициенты:** Зная `eventId`, вы можете запрашивать актуальные коэффициенты (`GET /pari/match/{eventId}`) или полную историю их движения (`GET /pari/odds/history/{eventId}`).
---
## Описание эндпоинтов
Ниже представлены все доступные методы API с кратким описанием и примерами полезных запросов.
### 1. Получение списка стран
**`GET /pari/countries`**
Возвращает полный список стран и географических категорий. Идентификаторы из этого списка нужны для дальнейшей фильтрации лиг.
### 2. Получение списка лиг
**`GET /pari/leagues`**
Возвращает список всех лиг. Поддерживает фильтрацию по странам и постраничную загрузку (пагинацию).
*Примечание: Если у лиги нет страны (например, международные турниры), для её поиска необходимо передать `countryId=0`.*
**Примеры:**
* `GET /pari/leagues?countryId=2` — получить российские лиги.
* `GET /pari/leagues?countryId=0` — получить только международные турниры.
* `GET /pari/leagues?offset=100&limit=50` — получить список лиг с пагинацией (пропустить первые 100, взять 50).
### 3. Получение списка матчей
**`GET /pari/matches`**
Гибкий эндпоинт для поиска матчей. Позволяет фильтровать события по дате, лиге, статусу (лайв или предстоящие) и командам. Из-за большого объема данных этот эндпоинт всегда возвращает результаты постранично. Обязательно должен быть указан хотя бы один фильтр.
**Примеры полезных запросов:**
* `GET /pari/matches?date=2026-05-01` — все матчи за конкретный день (по UTC).
* `GET /pari/matches?leagueId=11935&upcoming=true` — только предстоящие матчи в конкретной лиге.
* `GET /pari/matches?live=true` — все матчи, которые идут прямо сейчас (в лайве).
* `GET /pari/matches?date=2026-05-01&offset=0&limit=100` — получение первой страницы (100 матчей) за указанный день.
### 4. Актуальные данные и коэффициенты матча
**`GET /pari/match/{eventId}`**
Возвращает самую свежую информацию о конкретном матче, включая актуальные на данную секунду коэффициенты. Данные обновляются раз в 3 секунды.
**Пример:**
* `GET /pari/match/64539390` — актуальная сводка и коэффициенты по матчу с ID 64539390.
### 5. История коэффициентов
**`GET /pari/odds/history/{eventId}`**
Позволяет выгрузить историю изменения всех коэффициентов по конкретному матчу. Историю можно отфильтровать, чтобы получить только изменения по ходу матча (лайв) или только изменения до его начала (прематч).
**Примеры:**
* `GET /pari/odds/history/64539390` — полная история всех изменений.
* `GET /pari/odds/history/64539390?oddsType=live` — история изменений коэффициентов только во время игры (лайв).
* `GET /pari/odds/history/64539390?oddsType=prematch` — изменения котировок только до начала матча.
### 6. Игровые события и статистика
**`GET /pari/evnets/{eventId}`**
Предоставляет детальный список игровых событий матча (голы, карточки, угловые и т.д.) и накопленную статистику, которая вычисляется на основе потока данных от Pari.ru. Данные обновляются раз в 10 секунд.
**Пример:**
* `GET /pari/evnets/64539390` — получить статистику и ход событий матча.
### 7. Справочник маркетов и исходов
**`GET /pari/odds/market-types`**
В списках коэффициентов исходы возвращаются в компактном виде — как пара "ID исхода — Значение". Этот справочный эндпоинт поможет вам расшифровать данные: он возвращает полный список маркетов и подскажет, к какому рынку, периоду (например, 1-й тайм) и параметру относится каждый идентификатор исхода.
|API|