POST /api/v1/process

Создаёт задачу анализа и возвращает task_id. Результат получается через SSE-стрим.

Запрос

POST /api/v1/process
Authorization: Bearer YOUR_KEY
Content-Type: application/json

{
  "own_page": "https://example.com/product",
  "competitor_urls": [
    "https://comp1.com/product",
    "https://comp2.com/product"
  ],
  "queries": ["купить товар", "лучший товар 2026"],
  "lang": "ru",
  "triplet_analysis": false,
  "url_cookies": {}
}

Параметры тела

Поле	Тип	Обязательно	Описание
own_page	string	✅	URL вашей страницы
competitor_urls	string[]	✅	URL конкурентов (1–20). Рекомендуется 3–10
queries	string[]	—	Целевые поисковые запросы (до 5, до 1000 символов каждый). Используются как семантические якоря для зонтичного анализа
lang	"ru" | "en"	—	Язык страниц. По умолчанию "ru"
triplet_analysis	boolean	—	Включить извлечение графа знаний. По умолчанию false
url_cookies	object	—	Куки для конкретных URL: {"https://url": "session=abc"}

Ответ

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000"
}

Поле	Тип	Описание
task_id	string (UUID)	Идентификатор задачи — передайте в /process/status/{task_id}

HTTP-статусы

Код	Значение
200	Задача создана
400	Ошибка валидации (слишком много URL, пустые поля)
401	Неверный API-ключ
429	Превышен лимит одновременных задач или rate limit
422	Неверный формат тела запроса

Пример — cURL

curl -X POST https://unihra.ru/api/v1/process \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "own_page": "https://example.com/product",
    "competitor_urls": [
      "https://comp1.com/product",
      "https://comp2.com/product",
      "https://comp3.com/product"
    ],
    "queries": ["купить матрас", "ортопедический матрас 180x200"],
    "lang": "ru"
  }'

{"task_id": "550e8400-e29b-41d4-a716-446655440000"}

Пример — расширенный режим (граф знаний)

curl -X POST https://unihra.ru/api/v1/process \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "own_page": "https://example.com/product",
    "competitor_urls": ["https://comp1.com", "https://comp2.com"],
    "queries": ["target keyword"],
    "lang": "ru",
    "triplet_analysis": true
  }'

Стоимость

Расширенный режим (triplet_analysis: true) стоит 5 кредитов вместо 1. Проверьте баланс перед запуском через GET /api/v1/key/limits.