INFO
This documentation was developed in 2025 when the official OpenAPI spec had not yet been published. Since then (as of March 2026), much has changed, and although this unofficial documentation is still useful, it requires updating. If you wish to help, join us on GitHub.
Official OpenAPI Schemas:
- cleaner.yml — "Standardization". Methods clean/address, clean/phone, and similar.
- suggestions.yml — "Suggestions" and search. Methods suggest, findById, geolocate, and others.
- profile.yml — personal account. Balance, statistics, versions.
WARNING
The documentation is in the early stage of development. The site might change frequently, but we will try to make it as user-friendly as possible.
Click here to go to GitHub if you want to help.
If you're interested in the English version of this spec, let us know on the 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