API: бренд по ИНН

Это документация для разработчиков. Получить сведения о бренде в демоформе и посмотреть сценарии использования сервиса можно на странице «Бренд по ИНН»

Находит по ИНН бренд компании или ИП: название, сайт и логотип. Рассказывает, чем занимается бизнес.

Как вызвать

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

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

            
                POST https://api.dadata.ru/findById/brand
            
            
                
                    { "query": "560404424247" }

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -H "X-Secret: ${SECRET_KEY}" \
  -d '{ "query": "560404424247" }' \
  https://api.dadata.ru/findById/brand

var url = "https://api.dadata.ru/findById/brand";
var token = "${API_KEY}"; 
var secret = "${SECRET_KEY}";
var query = "560404424247";

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": "РобоШкола",
            "unrestricted_value": "РобоШкола",
            "data": {
                "domain": "roboshkola.com",
                "name":"РобоШкола",
                "inn":"560404424247",
                "summary":"РобоШкола — поставщик робототехники и конструкторов, включая LEGO Education, для образовательных учреждений: детских садов, школ, кружков, колледжей и вузов. Комплектует заведения под ключ по национальным проектам «Образование», «Кванториум» и «Точка роста». Основные направления — дошкольное, школьное и высшее образование. Работает по России, Казахстану и Беларуси, сотрудничая с государственными и коммерческими организациями более 7 лет.",
                "logos": [
                    {
                        "url": "https://cdn.dadata.ru/logo/roboshkola.com?token=${API_KEY}"
                    }
                ]
            }
        }
    ]
}

Название	Описание
value	Название бренда
unrestricted_value	= value

data.domain	Сайт
data.name	= value
data.inn	ИНН компании
data.summary	Описание бизнеса
data.logos	Логотипы компании
└ url	— ссылка на логотип

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

Собственные справочники
Открытые веб-источники

Ограничения

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

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

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

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

Стоимость

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