API торговельних марок: пошук за назвою, номером або кодом власника
Пошук у реєстрі торговельних марок Укрпатенту (УКРНОІВІ) повертає до 20 марок: назву, номер свідоцтва, власника, класи МКТП, стан і дату заявки. Номер свідоцтва, номер заявки або код ЄДРПОУ власника дають точний збіг, будь-яке інше слово шукає схожі назви.
Де застосовують: Перевірка назви бренду перед запуском, пошук марок конкурента, моніторинг схожих заявок.
Запит
GEThttps://dani.initask.com/v1/trademarks/search
| Параметр | Де | Опис |
|---|---|---|
q обовʼязковий | запит | Назва марки, номер свідоцтва, номер заявки або код ЄДРПОУ власника, від 2 до 120 символів. |
Приклади
curl
curl -H "Authorization: Bearer $INITASK_KEY" "https://dani.initask.com/v1/trademarks/search?q=eldorado"
JavaScript
const r = await fetch("https://dani.initask.com/v1/trademarks/search?q=eldorado", {
headers: { Authorization: `Bearer ${process.env.INITASK_KEY}` },
});
const { ok, data, error } = await r.json();
console.log(r.headers.get("X-RateLimit-Remaining"), data);
Python
import os, requests
r = requests.get(
"https://dani.initask.com/v1/trademarks/search?q=eldorado",
headers={"Authorization": f"Bearer {os.environ['INITASK_KEY']}"},
timeout=10,
)
body = r.json()
print(r.headers["X-RateLimit-Remaining"], body["data"])
Змінна INITASK_KEY містить ваш ключ. Без ключа запит теж пройде в межах 100 запитів на добу.
Відповідь
Справжня відповідь на запит /v1/trademarks/search?q=eldorado.
{
"ok": true,
"data": {
"q": "eldorado",
"items": [
{
"id": "2000010075",
"name": "eldorado",
"number": "28532",
"owner": "Підприємство з іноземною інвестицією «UKRAINE LEISURE COMPANY\"",
"classes": [
36,
41,
42
],
"status": "ended",
"date": "2000-01-10",
"url": "https://marky.initask.com/marka/2000010075"
}
]
},
"meta": {
"source": "marky.initask.com",
"cached": false
}
}
q | запит |
|---|---|
items | до 20 марок, найближчі першими |
items[].id | ідентифікатор марки |
items[].name | словесна частина марки |
items[].number | номер свідоцтва; null для заявки |
items[].owner | власник |
items[].classes | класи МКТП |
items[].status | active, pending, ended або stopped |
items[].date | дата заявки |
items[].url | сторінка марки на marky.initask.com |
Помилки
| HTTP | error | Коли |
|---|---|---|
| 400 | bad_request | запит коротший за 2 символи або довший за 120 |
| 429 | rate_limited | ліміт вичерпано, дивіться Retry-After |
| 502, 504 | upstream_* | джерело даних недоступне, ліміт не витрачається |
Джерело і свіжість
Дані: Реєстр торговельних марок Укрпатенту (УКРНОІВІ), marky.initask.com. Шлюз тримає відповідь у кеші 1 год, поле meta.cached показує, звідки вона.
Питання і відповіді
Як шукати марки конкретної компанії?
Передайте в q код ЄДРПОУ власника з 8 цифр: прийдуть його марки, до 20 штук.
Що означає status?
active: чинне свідоцтво, pending: заявка на розгляді, ended: строк дії свідоцтва скінчився, stopped: заявку або свідоцтво припинено.
Чи шукає API схожі назви?
Так, слово без номера шукає схожі за написанням назви, як у перевірці перед реєстрацією бренду.
Повʼязані ендпоінти
Отримати ключ API
Ключ прийде листом з каси Initask. Безкоштовний ключ дає 100 запитів на добу, платний тариф додається до того самого ключа.