API: поиск аффилированных компаний
Часто учредитель или директор не ограничивается участием в одном юрлице, а фигурирует в нескольких. Порой — в десятках разных компаний. Знать об этом полезно как для оценки надёжности контрагента, так и для более эффективного маркетинга и продаж. Чтобы облегчить поиск аффилированных компаний, «Дадата» находит организации по ИНН учредителей и руководителей.
Ищет по ИНН физлиц и юрлиц.
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
В параметре query
укажите ИНН учредителя или руководителя компании:
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-адреса.
Стоимость
Входит в состав годовой подписки на тарифе «Максимальный». На остальных тарифах недоступен.