API пошуку компаній: назва або частина коду ЄДРПОУ
Оновлено 26.09.2026
Пошук компаній Initask API знаходить юридичних осіб у ЄДР за назвою, частиною назви або кодом ЄДРПОУ і повертає до 10 збігів: код, повну і скорочену назву та стан. Адреса `GET https://dani.initask.com/v1/company/search`, запит передається параметром `q`. Далі за знайденим кодом береться повна картка компанії.
Навіщо окремий пошук
Користувач рідко памʼятає код ЄДРПОУ. Він памʼятає назву, часто неточно: «Приватбанк», «ПРИВАТ БАНК», «кб приват». Пошук вирішує саме цю задачу: з неточного введення отримати кілька кандидатів з кодами, з яких людина обирає потрібного.
Типові сценарії: підказки у полі «Контрагент» форми, пошук клієнта за назвою з рахунку, звірка написання назви.
Параметр запиту
| Параметр | Де | Обовʼязковий | Опис |
|---|---|---|---|
| q | у запиті | так | назва, частина назви або код ЄДРПОУ, від 2 до 120 символів |
Приклад запиту за назвою «приватбанк»:
``` https://dani.initask.com/v1/company/search?q=приватбанк ```
У реальному коді кирилиця в адресі кодується, бібліотеки запитів роблять це самі. Ключ передається заголовком `Authorization: Bearer КЛЮЧ` або параметром `key`, без ключа доступно 100 запитів на добу з однієї IP-адреси.
Що повертається
| Поле | Значення |
|---|---|
| q | запит, як його прочитав пошук |
| items | до 10 збігів |
| items[].edrpou | код ЄДРПОУ |
| items[].name | повна назва |
| items[].short_name | скорочена назва |
| items[].status | стан латиницею |
У прикладі з «приватбанк» першим іде АТ КБ «ПРИВАТБАНК» з кодом 14360570 і станом `active`. Серед збігів трапляється і ТОВ з кодом 46379669 зі станом `cancelled`. Саме тому стан варто показувати в підказці поруч з назвою: користувач одразу бачить, що припинену компанію обирати не треба.
Найточніші збіги йдуть першими. Пошук дивиться і повну, і скорочену назву, регістр літер значення не має.
Порожній результат і помилки
Коли нічого не знайдено, приходить відповідь 200 з порожнім масивом `items`. Так клієнт відрізняє порожній результат від збою і може показати «нічого не знайдено» замість повідомлення про помилку.
| Код | Помилка | Коли |
|---|---|---|
| 400 | bad_request | запит коротший за 2 символи або довший за 120 |
Для підказок у полі вводу це важливо: відправляйте запит лише після другого символу, інакше перша літера дасть 400.
Ліміти
| План | Запитів | Ціна, грн на місяць |
|---|---|---|
| Безкоштовний | 100 на добу | 0 |
| Старт | 10000 на місяць | 990 |
| Про | 100000 на місяць | 2990 |
Для підказок під час набору ліміт витрачається швидше, ніж здається: кожна нова літера це новий запит. Затримка перед відправкою на кілька сотень мілісекунд після останнього натискання і мінімум два символи помітно економлять запити. Шлюз кешує відповіді пошуку на 10 хвилин, тож повторні однакові запити від різних користувачів обробляються швидко. Поточний залишок видно в заголовку `X-RateLimit-Remaining`, після вичерпання приходить 429 з `Retry-After`.
Як зробити підказки зручними
Добрі підказки у полі контрагента показують дві-три строки на кожну компанію: скорочену назву великими літерами, повну назву дрібніше і код з позначкою стану. Людина за секунду бачить, що це саме та компанія, і не плутає однойменні фірми. Якщо збігів багато, користувач просто дописує ще кілька літер, і перелік звужується.
Корисно також приймати в тому самому полі код: якщо людина вставила вісім цифр, пошук знайде компанію за кодом, і вибір стане однозначним.
Третя порада стосується помилок написання. Люди пишуть назви з лапками і без, з формою власності на початку і в кінці. Пошук дивиться і повну, і скорочену назву без урахування регістру, тому зазвичай достатньо ввести найбільш впізнаване слово з назви без форми власності і лапок.
Звʼязка пошуку і картки
Пошук дає лише назву, код і стан. Для реквізитів, керівника і засновників викличте картку компанії за ЄДРПОУ з кодом, який обрав користувач. Така пара запитів покриває всю форму контрагента.
Що робити
- Відкрийте документацію пошуку і спробуйте кілька варіантів написання однієї назви.
- У полі «Контрагент» відправляйте запит після другого символу і з невеликою затримкою.
- Показуйте в підказці назву, код і стан.
- Після вибору викликайте картку компанії за кодом.
- Порахуйте очікувану кількість запитів і оберіть план на сторінці Ціни і ліміти.
Питання і відповіді
Як знайти компанію за назвою через API?
Зробіть запит GET https://dani.initask.com/v1/company/search?q= з назвою або її частиною від 2 до 120 символів. Відповідь містить до 10 компаній з кодом ЄДРПОУ, назвою і станом.
Чи шукає API за скороченою назвою?
Так, пошук дивиться і повну, і скорочену назву, регістр літер значення не має.
Що повертає пошук, якщо компанію не знайдено?
Відповідь 200 з порожнім масивом items. Так клієнт відрізняє порожній результат від помилки.