Initask API

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[].statusactive, pending, ended або stopped
items[].dateдата заявки
items[].urlсторінка марки на marky.initask.com

Помилки

HTTPerrorКоли
400bad_requestзапит коротший за 2 символи або довший за 120
429rate_limitedліміт вичерпано, дивіться Retry-After
502, 504upstream_*джерело даних недоступне, ліміт не витрачається

Джерело і свіжість

Дані: Реєстр торговельних марок Укрпатенту (УКРНОІВІ), marky.initask.com. Шлюз тримає відповідь у кеші 1 год, поле meta.cached показує, звідки вона.

Питання і відповіді

Як шукати марки конкретної компанії?

Передайте в q код ЄДРПОУ власника з 8 цифр: прийдуть його марки, до 20 штук.

Що означає status?

active: чинне свідоцтво, pending: заявка на розгляді, ended: строк дії свідоцтва скінчився, stopped: заявку або свідоцтво припинено.

Чи шукає API схожі назви?

Так, слово без номера шукає схожі за написанням назви, як у перевірці перед реєстрацією бренду.

Повʼязані ендпоінти

Отримати ключ API

Ключ прийде листом з каси Initask. Безкоштовний ключ дає 100 запитів на добу, платний тариф додається до того самого ключа.