↑ Все API

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

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

Как вызвать

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

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

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

Укажите при вызове:

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.
  • ${SECRET_KEY} — секретный ключ.

Тело запроса передавайте в кодировке UTF-8.

Параметры запроса

НазваниеТипОбяз.?По умолч.Описание
querystringАдрес эл. почты

Что в ответе

Пример ответа
{
    "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"
                }
            }
        }
    ]
}
НазваниеОписание
valueEmail одной строкой
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 рублей за запрос. Не входит в годовую подписку.