Бесплатный публичный API

Для кого это

Редакторы / авторы проверяют заявленный RTP в статьях. Запроси /api/rtp/[slug] со слагом вроде gates-of-olympus и укажи источник URL в материале.

Разработчики создающие инструменты для обзоров казино, сравнительные движки или аналитические дашборды. Используй /api/rtp/list с фильтром и пагинацией для массовых запросов.

Дата-журналисты отслеживающие тренды провайдеров. Комбинируй эндпоинты реестра с /api/rtp/history для временных рядов изменений RTP.

Все ответы — JSON. CORS открыт (*). Данные под лицензией CC-BY 4.0 — используй свободно с указанием авторства.

GET /api/rtp/list

Поиск, фильтрация, сортировка и пагинация реестра.

Параметры запроса

q	Свободный текст. Ищет по имени, слагу, провайдеру.
provider	Фильтр по ключу провайдера (напр. `pragmatic-play`).
game_type	slot · scratchcard · table · instant · bingo · keno
has_variants	`1` — только мультивариантные слоты.
sort	name (по умолч.) · provider · rtp_desc · rtp_asc · variants_desc · recent
limit	1–200, по умолч. 50
offset	Смещение пагинации, по умолч. 0

Пример

curl 'https://toolsgambling.com/api/rtp/list?provider=playngo&has_variants=1&limit=5'

▸ Пример структуры ответа (нажми чтобы раскрыть)

{
  "meta": {
    "data_version": "1.0.0",
    "frozen_at": "2026-05-08T...",
    "total": 3646,
    "filtered": 391,
    "has_more": true,
    "query": { ... }
  },
  "facets": {
    "providers": [{ "provider": "...", "display": "...", "count": 620 }],
    "game_types": [{ "game_type": "slot", "count": 3561 }]
  },
  "items": [{
    "canonical_slug": "moon-princess",
    "canonical_name": "Moon Princess",
    "provider": "playngo",
    "provider_display": "Play'n GO",
    "stated_rtp": 96.5,
    "rtp_variants": [84.5, 87.5, 91.49, 94.51, 96.5],
    "rtp_min": 84.5,
    "rtp_max": 96.5,
    "variants_count": 5,
    "volatility": null,
    "max_win": null,
    "release_year": 2017,
    "game_type": "slot",
    "last_verified": "2026-05-08T...",
    "snapshot_id": "sha256:...",
    "source_url": "https://www.playngo.com/games/moon-princess",
    "badges": ["verified_rtp", "variants_tracked"],
    ...
  }]
}

GET /api/rtp/[slug]

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

Пример

curl 'https://toolsgambling.com/api/rtp/gates-of-olympus'

Ответ 404

Если слаг не в реестре, эндпоинт возвращает HTTP 404 с телом {"statusCode": 404, "statusMessage": "slot not found in registry"}.

GET /widget/rtp/[slug]

Пре-рендеренный iframe-виджет для встраивания. Возвращает HTML, не JSON.

<iframe src="https://toolsgambling.com/widget/rtp/gates-of-olympus"
        width="100%" height="220" frameborder="0" loading="lazy">
</iframe>

dark

hex (none убирает рамку), radius=0

`Кэширование и лимиты`

/api/rtp/list — кэш 5 минут на edge
/api/rtp/[slug] — кэш 1 час на edge
/widget/rtp/[slug] — кэш 1 час

Заголовки rate-limit в ответе

X-RateLimit-Limit	Общий бюджет за период (сейчас 1000)
X-RateLimit-Remaining	Оставшихся запросов в текущем 24ч окне
X-RateLimit-Reset	Unix-секунды когда сбросится бакет

При превышении лимита возвращается HTTP 429 с JSON-телом описывающим время сброса. Исключения без лимита: /api/rtp/provider/[provider], /api/rtp/history, /api/widget/rtp/[slug].

Embed-код из /rtp содержит параметр ?v=. Это подсказка сброса кэша для CDN партнёров — старые embed-коды продолжают работать, роут виджета параметр игнорирует.

`Нужно больше 1 000 в день?`

Мы выдаём API-ключи раннего доступа вручную для подтверждённых кейсов — аффилиат-сайты, внутренние инструменты компаний игровой индустрии, исследовательские / журналистские проекты.

Напиши на hello@toolsgambling.com с коротким описанием: hello@toolsgambling.com

твой сайт или компания
что ты строишь / почему нужна большая квота
ожидаемый объём запросов (в день)

Нет самообслуживания и автовыдачи. Ответим в течение нескольких рабочих дней. White-label (без атрибуции) и дашборды API-ключей выйдут с Pro-тарифом.