↑ Все API

API: поиск аффилированных компаний

Часто учредитель или директор не ограничивается участием в одном юрлице, а фигурирует в нескольких. Порой — в десятках разных компаний. Знать об этом полезно как для оценки надёжности контрагента, так и для более эффективного маркетинга и продаж. Чтобы облегчить поиск аффилированных компаний, «Дадата» находит организации по ИНН учредителей и руководителей.

Ищет по ИНН физлиц и юрлиц.

Как вызвать

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

В параметре query укажите ИНН учредителя или руководителя компании:

{ "query": "7736207543" }
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Token ${API_KEY}" \
-d '{ "query": "7736207543" }' \
https://suggestions.dadata.ru/suggestions/api/4_1/rs/findAffiliated/party
// https://github.com/hflabs/dadata-csharp

var token = "${API_KEY}";
var api = new SuggestClientAsync(token);
var response = await api.FindAffiliated("7736207543");
var party = response.suggestions[0].data;
var url = "https://suggestions.dadata.ru/suggestions/api/4_1/rs/findAffiliated/party";
var token = "${API_KEY}";
var query = "7736207543";

var options = {
    method: "POST",
    mode: "cors",
    headers: {
        "Content-Type": "application/json",
        "Accept": "application/json",
        "Authorization": "Token " + token
    },
    body: JSON.stringify({query: query})
}

fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
// https://github.com/hflabs/dadata-php

$token = "${API_KEY}";
$dadata = new \Dadata\DadataClient($token, null);
$result = $dadata->findAffiliated("7736207543");
# https://github.com/hflabs/dadata-py

from dadata import Dadata
token = "${API_KEY}"
dadata = Dadata(token)
result = dadata.find_affiliated("7736207543")

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

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.

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

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

Название Тип Обяз.? По умолч. Описание
query string Текст запроса
count number 10 Количество результатов (максимум — 300)
scope array [string] FOUNDERS, MANAGERS Где искать — среди учредителей (FOUNDERS), руководителей (MANAGERS), или и тех, и других (по умолчанию). См. примеры

Ограничение области поиска

По умолчанию метод ищет как среди учредителей, так и среди руководителей. Если требуется искать только среди учредителей, укажите scope = FOUNDERS:

{
    "query": "7736207543",
    "scope": ["FOUNDERS"]
}

Аналогично — если требуется искать только среди руководителей:

{
    "query": "7736207543",
    "scope": ["MANAGERS"]
}

Что в ответе

Объект с массивом организаций в поле suggestions:

{
    "suggestions": [
        {
            "value": "ООО \"ДЗЕН.ПЛАТФОРМА\"",
            "unrestricted_value": "ООО \"ДЗЕН.ПЛАТФОРМА\"",
            "data": { ... }
        },
        {
            "value": "ООО \"ЕДАДИЛ\"",
            "unrestricted_value": "ООО \"ЕДАДИЛ\"",
            "data": { ... }
        },
        {
            "value": "ООО \"ЗНАНИЕ\"",
            "unrestricted_value": "ООО \"ЗНАНИЕ\"",
            "data": { ... }
        },
        {
            "value": "ООО \"НАПА\"",
            "unrestricted_value": "ООО \"НАПА\"",
            "data": { ... }
        },
        {
            "value": "ООО \"ЯНДЕКС.ДРАЙВ\"",
            "unrestricted_value": "ООО \"ЯНДЕКС.ДРАЙВ\"",
            "data": { ... }
        }
    ]
}

По каждой организации возвращается ограниченный набор полей:

Название Описание
value Наименование компании
unrestricted_value = value
data.inn ИНН
data.kpp КПП
data.ogrn ОГРН
data.hid Внутренний идентификатор в Дадате
data.type Тип организации
    LEGAL      — юридическое лицо
    INDIVIDUAL — индивидуальный предприниматель
Коды статистики (только для действующих организаций и ИП):
data.okato Код ОКАТО
data.oktmo Код ОКТМО
data.okpo Код ОКПО
data.okogu Код ОКОГУ
data.okfs Код ОКФС
data.okved Код ОКВЭД
data.okved_type Версия справочника ОКВЭД (2001 или 2014)
data.branch_count Количество филиалов
data.branch_type Тип подразделения
    MAIN   — головная организация
    BRANCH — филиал
data.address.value Aдрес одной строкой:
  • адрес организации для юридических лиц;
  • город проживания для индивидуальных предпринимателей.
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
data.state Состояние
└ actuality_date — дата последних изменений
└ registration_date — дата регистрации
└ liquidation_date — дата ликвидации
└ status — статус организации
    ACTIVE       — действующая
    LIQUIDATING  — ликвидируется
    LIQUIDATED   — ликвидирована
    BANKRUPT     — банкротство
    REORGANIZING — в процессе присоединения к другому
                    юрлицу, с последующей ликвидацией
└ code детальный статус
data.invalid Признак недостоверных сведений об организации (true/null)

Чтобы получить все поля, выберите конкретную компанию из ответа и вызовите метод Организация по ИНН.

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

Ограничения

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

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

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

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

Стоимость

Входит в состав годовой подписки на тарифе «Максимальный». На остальных тарифах недоступен.

ajax-spinner