INFO
Эта документация была разработана в 2025 году, когда официальная OpenAPI спецификация ещё не была опубликована. С тех пор (по состоянию на март 2026) многое изменилось, и хотя данная неофициальная документация по прежнему полезна, она требует обновления. Если хотите помочь, присоединяйтесь на GitHub.
Офицальные OpenAPI-схемы:
- cleaner.yml — «Стандартизация». Методы clean/address, clean/phone и аналогичные.
- suggestions.yml — «Подсказки» и поиск. Методы suggest, findById, geolocate и другие.
- profile.yml — личный кабинет. Баланс, статистика, версии.
WARNING
Документация находится на ранней стадии разработки. Сайт может часто меняться, но мы постараемся сделать его как можно более удобным.
Нажмите здесь, чтобы перейти на GitHub, если хотите помочь.
Dadata — это сервис подсказок и поиска по российским адресам, организациям, ФИО и другим данным.
Данная спецификация включает полный список публичных API «Дадаты» с детальным описанием формата запросов и ответов.
Спецификация не является официальным продуктом «ДаДаты».
Аутентификация
- Запросы к API подсказок и «Поиск по коду» требуют передать API-ключ (токен) в заголовке
Authorization: Token <API_KEY>. Получить API-ключ - Запросы к API «Стандартизации», а также данным об аккаунте, помимо токена, требуют также указать секретный ключ в заголовке
X-Secret: <SECRET_KEY>
Внимание! Запросы к «Стандартизации» и данным аккаунта (любые запросы, где требуется заголовокX-Secret) недоступны из браузера.
Некоторые сервисы являются платными. Для уточнения цен и условий ознакомьтесь с соответствующим разделом официального сайта.
Лимиты запросов
API «Подсказки» (suggest) и «Поиск по коду» (findById):
- До 30 запросов в секунду на один IP
- До 60 новых соединений в минуту на один IP
- Суточные лимиты зависят от тарифного плана.
API стандартизации:
- До 20 запросов в секунду на один IP
- До 60 новых соединений в минуту на один IP
Важно знать
Данная спецификация составлена на основании официального описания от DaData и анализа ответов API, но не является официальной.
При обнаружении расхождений с официальными ресурсами, имейте в виду:
- В некоторых случаях, данный документ исправляет неточности официальной документации.
- Но не исключены ошибки, отставание от официальных обновлений, или ограничения, связанные с противоречиями и неполнотой официальных ресурсов.
Если у вас есть вопросы:
- По спецификации - откройте Issue и дискуссию на GitHub
- Официальная поддержка «Дадаты»: support.dadata.ru