↑ Все API

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

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

Как вызвать

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

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

{"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" }' \
  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 — часовой пояс

Источники данных

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

Ограничения

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

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

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

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

Стоимость

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

ajax-spinner