Данные ГАР обновляются 2–3 раза в неделю

Адреса, которым можно верить

Подсказки при вводе, стандартизация строк и государственные идентификаторы ГАР (ФИАС) через собственный API. Плюс пайплайн выверки ваших данных с участием LLM и человека. Начните бесплатно — 10 000 запросов в день.

Живой запрос к нашему API — введите пару символов
119 млн+
адресных объектов и домов в ГАР
203 тыс.
населённых пунктов с координатами
<100 мс
отклик подсказок
10 000
бесплатных запросов каждый день

Что умеет API

Всё, что нужно интернет-магазину, банку или CRM, чтобы работать с российскими адресами.

🔍

Подсказки при вводе

Мгновенный нечёткий поиск по 119 млн адресов ГАР: опечатки, порядок слов, от региона до дома. Ответ быстрее 100 мс.

🧩

Стандартизация строк

Разбивает «как написалось» в структуру: регион, город, улица, дом. Детерминированный парсер — без LLM в горячем пути.

🎯

qc-коды качества

Каждый ответ несёт коды качества: точное совпадение, неполное или не найдено. Понятно, чему доверять, а что отправить на ручную проверку.

🏛

Идентификаторы ГАР/ФИАС

GUID и КЛАДР-коды каждого уровня адреса — с ними ваши данные стыкуются с госорганами и службами доставки.

🔄

Обновление данных

Данные ГАР обновляются 2–3 раза в неделю: дельты применяются очередью задач без остановки сервиса.

🤖

Выверка данных с LLM

Уникальность платформы: пайплайн сверки ваших справочников с ГАР — LLM нормализует «грязные» записи, спорные уходят человеку.

Как это устроено

Открытый конвейер данных: от государственной выгрузки до вашего запроса — и обратно, для выверки ваших справочников.

ГАР (ФНС)полная выгрузка + дельты 2–3 раза в неделю
ETL-очередьпотоковая загрузка, батчи, ретраи
Postgres + PostGISиерархии, дома, координаты НП
Индекс подсказокнечёткий поиск за миллисекунды
Публичный APIключи, дневные лимиты, qc-коды

🧹 Нормализация «грязных» данных

Транслит («Penza»), дубли гео-идентификаторов, пропущенные регионы — модель приводит записи к канонической форме, а детерминированный мэтчинг находит точный объект ГАР. LLM не «придумывает» идентификаторы — их назначает индекс.

👥 Человек на страже качества

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

Документация API

Семантика знакома по DaData — переезд лёгкий. Аутентификация: заголовокAuthorization: Bearer adr_…

POST/v1/suggest/address

Подсказки по мере ввода. Фильтры по уровню и региону, счёт результатов.

POST/v1/clean/address

Стандартизация строки в структуру с qc-кодами качества.

GET/v1/findById/address

Объект по GUID, OBJECTID или КЛАДР-коду.

GET/v1/profile/balance

Остаток дневного лимита ключа.

429лимит исчерпан

Квота восстанавливается в 00:00 МСК. Ошибки лимит не расходуют.

# Подсказки при вводе (по мере набора)
curl -X POST https://api.адресат.рф/v1/suggest/address \
  -H "Authorization: Bearer adr_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"query": "Пенза Ленина", "count": 5}'

# Стандартизация строки в структуру + qc-коды
curl -X POST https://api.адресат.рф/v1/clean/address \
  -H "Authorization: Bearer adr_ВАШ_КЛЮЧ" \
  -d '{"query": "г Пенза, ул Ленина, д 1"}'
ответ
{
  "suggestions": [
    {
      "value": "обл Пензенская, г Пенза, ул Ленина, д 1",
      "score": 0.91,
      "data": {
        "objectid": 11000,
        "guid": "30c2e92e-51bc-4a58-92a2-b04a95805000",
        "kind": "house",
        "level": 10,
        "typename": "д",
        "name": "1",
        "region_code": 58,
        "postalcode": "440011",
        "kladr": "58000001000040400"
      }
    }
  ]
}

qc-коды ответа

КодЗначениеЧто делать
qc 0Точное совпадение с ГАРИспользовать как есть
qc 1Неполное или нечёткое совпадениеПоказать вариант пользователю
qc 3Объект не найденОтправить на ручную проверку

Тарифы

Плата за запросы, а не за символы. Смена тарифа — без годовой подписки.

Free
0 ₽ / месяц
  • 10 000 запросов в день
  • Все эндпоинты адресного API
  • qc-коды и идентификаторы ГАР
  • Для тестов и небольших форм
Создать ключ
Популярный
Старт
700 ₽ / месяц
  • 50 000 запросов в день
  • Приоритетная поддержка очередей
  • Статистика использования
  • Для интернет-магазинов
Начать
Стандарт
1 400 ₽ / месяц
  • 100 000 запросов в день
  • Пайплайн выверки справочников
  • Массовый ингест JSONL
  • Для CRM и логистики
Подключить

Частые вопросы

Коротко о главном. Остальное — в документации и панели управления.

Что за данные и можно ли их использовать?

Источник — Государственный адресный реестр (ГАР, наследник ФИАС), открытые данные по 443-ФЗ. Мы применяем дельты 2–3 раза в неделю и отдаём официальные идентификаторы: GUID, КЛАДР, ОКТМО, почтовые индексы.

Чем вы отличается от DaData?

Семантика API и qc-коды знакомы по DaData, а отличие — в открытом контуре данных: у нас встроен пайплайн выверки ваших справочников с ГАР на локальных и облачных LLM с ручной проверкой спорных записей. Плюс честная тарификация: лимит считается по запросам, а не по символам.

Как считается дневной лимит?

Каждый успешный запрос к API — это один запрос из лимита. Ошибки (4xx) не расходуют квоту. Баланс видно в реальном времени: GET /v1/profile/balance.

Что если запись нельзя сопоставить автоматически?

В конвейере выверки неоднозначные записи («деревня Юсупова» — их в России пять) не гадают: модель предлагает нормализованный вариант и кандидатов, а финальное решение принимает оператор в панели ревью.

Где работают ваши модели?

Нормализация и сверка данных выполняются на зарегистрированных в платформе LLM-провайдерах — локальных (vLLM/Ollama) или облачных OpenAI-совместимых. Модели назначаются на задачи флагами: нормализация, мэтчинг, анализ ошибок, планирование краулеров.