Возможности

Один предсказуемый шлюз для дистрибуции данных

Промторг API раздаёт курируемые датасеты через единый шлюз. Одна и та же схема, один и тот же ответ при каждом обращении.

⚡

Единый шлюз

Каждый датасет публикуется в каталоге и раздаётся через шлюз дистрибуции с предсказуемой задержкой.

🔑

Ключи доступа

Один Bearer-токен в заголовке Authorization. Лимиты по ключу отдаются в стандартных заголовках ответа.

📦

Стабильные схемы

Датасеты версионируются под /v1. Ломающие изменения выходят на новом пути — не молча на месте.

🌍

Каталог API

Просматривайте реестр опубликованных API и датасетов и подключайте их по единому шлюзу.

📈

Наблюдаемость

Каждый ответ несёт X-Request-Id и X-Promtorg-Region; защищённые эндпоинты добавляют заголовки лимитов.

📚

OpenAPI

Полная OpenAPI 3 спецификация документирует каждый эндпоинт и питает справочник.

📡

Живые потоки изменений

SSE-поток передаёт каждое изменение датасета по одному постоянному соединению — без опроса.

⬇️

Снапшоты и экспорты

Полные многогигабайтные снапшоты и почасовые инкрементальные диффы (jsonl.zst).

Согласованные версионированные ответы

Шлюз возвращает идентичный JSON для одного и того же запроса. SDK не нужен — обычный HTTPS и JSON, с Bearer-токеном для защищённых эндпоинтов.

Стандартный конверт ошибки при любом сбое
Заголовки лимитов на защищённых эндпоинтах
Метки времени ISO 8601 и имена зон IANA
Фильтр стран по ISO-коду или валюте

Читать документацию

# Поиск страны по ISO-коду
curl -s https://db.promtorg.info/v1/countries?code=RU \
  -H "Authorization: Bearer $PROMTORG_KEY"

# Текущее время в конкретной зоне
curl -s "https://db.promtorg.info/v1/time?tz=Europe/Moscow" \
  -H "Authorization: Bearer $PROMTORG_KEY"

Датасеты и эндпоинты

Курируемые данные за небольшим стабильным набором GET-эндпоинтов.

Эндпоинт	Доступ	Что возвращает
GET `/v1/health`	Открытый	Проверка живости со временем ответа.
GET `/v1/status`	Открытый	Статус шлюза, узлы онлайн и задержка.
GET `/v1/regions`	Открытый	Зоны дистрибуции с городом и страной.
GET `/v1/timezones`	Bearer	Зоны IANA с текущими смещениями UTC.
GET `/v1/countries`	Bearer	Коды ISO 3166, столицы, валюты, телефонные коды.
GET `/v1/time`	Bearer	Текущее время и смещение для зоны IANA.
GET `/v3/api/stream`	Bearer	Живой SSE-поток изменений по постоянному соединению.
GET `/v3/api/snapshots`	Открытый	Полные и инкрементальные снапшоты с URL для скачивания.

Попробуйте через шлюз

Бесплатный тариф включает 100k запросов в месяц. Без привязки карты.

Получить ключ доступа