Звіт за доменом

Вкажіть вебсайт клієнта й отримайте один звіт про те, як просувати його в публічних обговореннях і пошуку: для кого цей продукт, ключові слова ринку з виміряними обсягами пошуку, реальні конкуренти, спільноти, де спілкуються покупці, пошукові запити, що виводять на релевантні гілки обговорень, а в розширеному звіті — гілки, на які варто відповісти, з їхньою тональністю, повна аналітична довідка про компанію та видимість бренду в ШІ-асистентах і пошуку.

Створено для агенцій і платформ, що продають просування: один виклик на домен клієнта, одна ціна за отриманий звіт.

Доступ вмикається на запит

Звіти за доменом вмикаються для кожного ключа окремо. Щоб їх увімкнути, напишіть на support@omev.be. Звіт списується зі звичайного балансу ключа.

Режими та ціни

mode	Ціна за отриманий звіт	Що ви отримуєте	Типовий час
basic	$0.99	одна проста відповідь: продукт, профіль покупця, до 20 ключових слів з обсягами, 3–5 конкурентів, до 20 активних спільнот, упорядкованих за релевантністю, 15 пошукових запитів, компактний профіль із 10 полів	близько 10 хвилин, не більше 1 години
extended (за замовчуванням)	$2.99	усе з basic, а також аналітична довідка про компанію з голосом аудиторії, гілки обговорень для відповіді з їхньою тональністю та чернетками відповідей, перевірка видимості в ШІ та аналіз гілок, які ви вкажете	зазвичай 20–60 хвилин, не більше 5 годин

Звіт оплачується один раз, під час першого завантаження готового результату, залежно від його повноти: за 75% і більше сплачується повна ціна, за 40–74% сплачується 70% ціни ($0.69 або $2.09), за 15–39% сплачується 30% ціни ($0.29 або $0.89), а якщо повнота менша за 15%, звіт безкоштовний. Часткові суми округлюються униз до цілих центів. Повторні завантаження, невдалі та скасовані замовлення не оплачуються.

Замовлення звіту

curl -sS https://llmapi.omev.be/v1/domain-delivery/jobs/create \
  -H "Authorization: Bearer $OMEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "rumpl.com",
    "mode": "extended",
    "market": ["US"],
    "language": ["en"],
    "client_ref": "acme-17",
    "idempotency_key": "acme-17-rumpl-2026-10"
  }'

Поле	Обов'язкове	Значення
url	так	вебсайт клієнта
mode	ні	basic або extended (за замовчуванням)
format	ні	лише extended: standard (за замовчуванням, повний звіт) або agent (компактна відповідь для ШІ-агента, див. нижче)
market	ні	до 10 країн або регіонів, наприклад "US" або ["UA", "EU"]
language	ні	до 6 кодів мов, наприклад "en" або ["en", "de"]
questions	ні	лише extended: 1–15 ваших власних запитань покупців для перевірки видимості в ШІ, по 5–200 символів
threads	ні	лише extended: 1–10 посилань на гілки Reddit для детального аналізу
threads_only	ні	разом із threads: true аналізує лише ці гілки
voice	ні	лише extended: від чийого імені написано чернетки відповідей, brand (за замовчуванням) або community_member
max_age_months	ні	лише extended: 1–60; гілки, старші за цей вік, не включаються (гілки, які ви вказали, ніколи не відфільтровуються)
client_ref	ні	ваша власна мітка для кінцевого клієнта, до 100 символів
idempotency_key	ні	8–200 символів; повтор із ним повертає те саме замовлення замість нового

Відповідь — 202 із замовленням:

{"job": {"id": "dd_…", "status": "queued", "mode": "extended", "format": "standard",
         "stage": null, "charged_usd": 0, …},
 "idempotent_replay": false}

OmevAI готує чернетки відповідей, але нічого не публікує. Чи використовувати чернетку і як саме — вирішуєте ви.

Відстеження замовлення

curl -sS https://llmapi.omev.be/v1/domain-delivery/jobs/get \
  -H "Authorization: Bearer $OMEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id": "dd_…"}'

status спочатку має значення queued, потім running, а далі completed, failed або cancelled. Під час виконання stage показує крок: report, preview (формат agent), threads, visibility, final. steps показує кожен крок із кількістю спроб: невдалий крок повторюється ще до двох разів. Отримане замовлення має статус completed і поле completeness_percent. Перевіряйте статус кожні 30–60 секунд.

Щоб зупинити замовлення, надішліть те саме тіло запиту на /v1/domain-delivery/jobs/cancel.

Завантаження звіту

curl -sS https://llmapi.omev.be/v1/domain-delivery/jobs/result \
  -H "Authorization: Bearer $OMEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id": "dd_…"}'

Відповідь містить job і result. Доки замовлення не завершено, виклик повертає 409 JOB_NOT_READY; невдале або скасоване замовлення повертає "result": null.

Звіт	Що містить result
basic	product, icp (профіль покупця та 1–3 сегменти), keywords (фраза, обсяг, позиція), competitors, subreddits (активні спільноти з відповідним дописом, упорядковані за релевантністю), queries, profile (10 полів), completeness, limitations
extended, standard	report (повна аналітична довідка про компанію), ai_visibility (запитання покупців у ШІ-асистентах і ШІ-пошуку: чи згадується або цитується бренд, а також позиції сайту й гілок Reddit у пошуку за ключовими словами ринку), threads (кожна гілка один раз за тактикою: reply_now, ranking, reference, з її тональністю та статусом відповідей), given_threads (аналіз ваших гілок), completeness
extended, agent	компактний JSON обсягом не більше 5 КБ: 10 полів профілю (product_name, product_description, icp, keywords, competitors, pain_points, key_benefits, key_features, watched_subreddits, serp_queries), сегменти покупців, сигнали відповідності, безпечні та ризиковані твердження, короткий підсумок видимості в ШІ, completeness

У форматі agent виклик jobs/get повертає preview із 10 полями профілю, щойно вони стають відомими (зазвичай упродовж хвилини), і оновлює його, поки виконується замовлення. Щоб отримати повний звіт замовлення agent, викличте jobs/result з "view": "full"; повторно це не оплачується.

completeness перелічує кожен розділ із тим, що знайдено, ціллю та мінімумом, а також частку ціни, яку списано.

PDF

POST /v1/domain-delivery/jobs/pdf з {"job_id": "dd_…"} повертає готовий звіт у вигляді файлу PDF, який можна одразу надіслати кінцевому клієнту.

Помилки

Код	Коли
401	API-ключ відсутній або недійсний
403	звіти за доменом не ввімкнено для ключа
404 JOB_NOT_FOUND	невідоме замовлення або замовлення іншого облікового запису
409 JOB_NOT_READY	результат або PDF запитано до завершення замовлення
422 INVALID_URL, 422 MODE_NOT_AVAILABLE, 422 INVALID_FORMAT	значення поза наведеними вище переліками
422 FORMAT_NOT_AVAILABLE, 422 THREADS_NOT_AVAILABLE, 422 QUESTIONS_NOT_AVAILABLE, 422 VOICE_NOT_AVAILABLE, 422 MAX_AGE_NOT_AVAILABLE	параметр використано з basic (або з threads_only), хоча він працює лише в повному замовленні extended
422 INVALID_THREADS, 422 INVALID_MAX_AGE, 422 INVALID_VOICE, 422 INVALID_IDEMPOTENCY_KEY	поле поза допустимими межами
429	забагато запитів або бюджет ключа вичерпано

Кожна помилка має однаковий вигляд: {"error": {"code": "INVALID_URL", "message": "…"}}. Поради щодо повторних спроб див. на сторінці Помилки та повторні спроби.