↑ Все API
{"query": "info@dadata.ru"}
API: компания по email
Находит компанию по адресу электронной почты.
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
Пример запроса:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -H "X-Secret: ${SECRET_KEY}" \ -d '{ "query": "info@dadata.ru" }' \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/findByEmail/company
var url = https://suggestions.dadata.ru/suggestions/api/4_1/rs/findByEmail/company var token = "${API_KEY}"; var secret = "${SECRET_KEY}"; var query = "info@dadata.ru"; var options = { method: "POST", mode: "cors", headers: { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Token " + token, "X-Secret": secret }, body: JSON.stringify({query: query}) } fetch(url, options) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log("error", error));
Укажите при вызове:
Content-Type: application/json
.Accept: application/json
.${API_KEY}
— API-ключ.${SECRET_KEY}
— секретный ключ.
Тело запроса передавайте в кодировке UTF-8
.
Параметры запроса
Название | Тип | Обяз.? | По умолч. | Описание |
---|---|---|---|---|
query | string | ✓ | Адрес эл. почты |
Что в ответе
Пример ответа
{ "suggestions": [ { "value": "info@dadata.ru", "unrestricted_value": "info@dadata.ru", "data": { "email": { "source": "info@dadata.ru", "type": "ROLE", "local": "info", "domain": "dadata.ru" }, "company": { "domain": "dadata.ru", "name": "ООО \"ДЕЙТА КЬЮ\"", "inn": "7721581040", "ogrn": "5077746329876", "okved": "63.11", "okved_name": "Деятельность по обработке данных, предоставление услуг по размещению информации и связанная с этим деятельность", "employee_count": "8", "income": "113827000.0", "city": "Москва", "timezone": "UTC+3" } } } ] }
Название | Описание |
---|---|
value | Email одной строкой |
unrestricted_value | = value |
data.email | Информация об адресе эл. почты |
└ source | — адрес эл. почты одной строкой |
└ type | — тип адреса
PERSONAL — личный (@mail.ru, @yandex.ru) CORPORATE — корпоративный (@ozon.ru) ROLE — «ролевой» (info@, support@) DISPOSABLE — одноразовый (@temp-mail.ru) |
└ local | — локальная часть адреса (то, что до «собачки») |
└ domain | — домен (то, что после «собачки») |
data.company | Информация о компании |
└ domain | — домен компании |
└ name | — краткое наименование компании |
└ inn | — ИНН компании |
└ ogrn | — ОГРН компании |
└ okved | — основной код ОКВЭД |
└ okved_name | — расшифровка кода ОКВЭД |
└ employee_count | — среднесписочная численность работников (заполнена у 65% компаний) |
└ income | — доходы за год по открытой бух. отчётности (заполнены у 65% компаний) |
└ city | — город регистрации |
└ timezone | — часовой пояс |
Источники данных
- ЕГРЮЛ и ЕГРИП Налоговой службы
- Сведения о среднесписочной численности работников организации
- Бухгалтерская отчетность (форма по ОКУД 0710002)
- Собственные справочники
Примеры вызова
Ограничения
Длина запроса (параметр query
) — не более 300 символов.
Количество запросов в день — в соответствии с тарифным планом.
Максимальная частота запросов — 30 в секунду с одного IP-адреса.
Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.
Стоимость
5 рублей за запрос. Не входит в годовую подписку.