API: компания по email

Находит компанию по адресу электронной почты.

Как вызвать

Чтобы вызвать метод, и подтвердите почту.

Пример запроса:

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/findByEmail/company
            
            
                
                    { "query": "info@dadata.ru" }

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" }' \
  http://suggestions.dadata.ru/suggestions/api/4_1/rs/findByEmail/company

var url = "http://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)
Собственные справочники

Примеры вызова

Битрикс24: роботы

Ограничения

Длина запроса (параметр query) — не более 300 символов.

Количество запросов в день — в соответствии с тарифным планом.

Максимальная частота запросов — 30 в секунду с одного IP-адреса.

Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.

Стоимость

5 рублей за запрос. Не входит в годовую подписку.