Raport domeny

Podaj stronę internetową klienta, a otrzymasz jeden raport o tym, jak ją promować w publicznych dyskusjach i w wyszukiwarkach: dla kogo jest produkt, słowa kluczowe rynku ze zmierzonymi wolumenami wyszukiwań, rzeczywistych konkurentów, społeczności, w których rozmawiają kupujący, zapytania wyszukiwania prowadzące do trafnych wątków, a w raporcie rozszerzonym także wątki warte odpowiedzi wraz z ich wydźwiękiem, pełny raport o firmie oraz to, jak widoczna jest marka w asystentach AI i w wyszukiwarkach.

Stworzone dla agencji i platform, które sprzedają promocję: jedno wywołanie na domenę klienta, jedna cena za dostarczony raport.

Dostęp jest włączany na życzenie

Raporty domen są włączane dla każdego klucza osobno. Napisz na support@omev.be, aby je włączyć. Raport jest rozliczany ze zwykłego salda klucza.

Tryby i ceny

mode	Cena za dostarczony raport	Co otrzymujesz	Typowy czas
basic	$0.99	jedna prosta odpowiedź: produkt, profil kupującego, do 20 słów kluczowych z wolumenami, 3–5 konkurentów, do 20 aktywnych społeczności uszeregowanych według trafności, 15 zapytań wyszukiwania, kompaktowy profil z 10 polami	około 10 minut, najwyżej 1 godzina
extended (domyślnie)	$2.99	wszystko z basic, a do tego raport o firmie z głosem odbiorców, wątki do odpowiedzi z ich wydźwiękiem i szkicami odpowiedzi, sprawdzenie widoczności w AI oraz analiza wskazanych przez Ciebie wątków	zwykle 20–60 minut, najwyżej 5 godzin

Raport jest rozliczany raz, przy pierwszym pobraniu gotowego wyniku, zależnie od jego kompletności: 75% lub więcej to pełna cena, 40–74% to 70% ceny ($0.69 lub $2.09), 15–39% to 30% ceny ($0.29 lub $0.89), poniżej 15% raport jest bezpłatny. Częściowe kwoty są zaokrąglane w dół do pełnych centów. Ponowne pobrania oraz nieudane i anulowane zamówienia nie są płatne.

Zamówienie raportu

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"
  }'

Pole	Wymagane	Znaczenie
url	tak	strona internetowa klienta
mode	nie	basic lub extended (domyślnie)
format	nie	tylko extended: standard (domyślnie, pełny raport) lub agent (kompaktowa odpowiedź dla agenta AI, zobacz niżej)
market	nie	do 10 krajów lub regionów, np. "US" lub ["UA", "EU"]
language	nie	do 6 kodów języków, np. "en" lub ["en", "de"]
questions	nie	tylko extended: 1–15 własnych pytań kupujących do sprawdzenia widoczności w AI, każde 5–200 znaków
threads	nie	tylko extended: 1–10 linków do wątków Reddit do szczegółowej analizy
threads_only	nie	z threads: true analizuje tylko te wątki
voice	nie	tylko extended: w czyim imieniu są pisane szkice odpowiedzi, brand (domyślnie) lub community_member
max_age_months	nie	tylko extended: 1–60; wątki starsze niż ta wartość są pomijane (wątki wskazane przez Ciebie nigdy nie są filtrowane)
client_ref	nie	Twoja własna etykieta klienta końcowego, do 100 znaków
idempotency_key	nie	8–200 znaków; ponowne użycie zwraca to samo zamówienie zamiast uruchamiać nowe

Odpowiedzią jest 202 z zamówieniem:

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

OmevAI przygotowuje szkice odpowiedzi; nigdy niczego nie publikuje. To, czy i jak szkic zostanie użyty, jest Twoją decyzją.

Śledzenie zamówienia

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 przyjmuje wartość queued, running, a następnie completed, failed lub cancelled. W trakcie działania stage pokazuje etap: report, preview (format agent), threads, visibility, final. steps pokazuje każdy etap wraz z liczbą prób: nieudany etap jest ponawiany jeszcze maksymalnie dwa razy. Dostarczone zamówienie ma status completed z completeness_percent. Sprawdzaj status co 30–60 sekund.

Aby zatrzymać zamówienie, wyślij tę samą treść żądania na /v1/domain-delivery/jobs/cancel.

Pobranie raportu

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_…"}'

Odpowiedź zawiera job i result. Dopóki zamówienie się nie zakończy, wywołanie zwraca 409 JOB_NOT_READY; nieudane lub anulowane zamówienie zwraca "result": null.

Raport	Zawartość result
basic	product, icp (profil kupującego i 1–3 segmenty), keywords (fraza, wolumen, pozycja), competitors, subreddits (aktywne społeczności z pasującym postem, uszeregowane według trafności), queries, profile (10 pól), completeness, limitations
extended, standard	report (pełny raport o firmie), ai_visibility (pytania kupujących zadane asystentom AI i wyszukiwarkom z AI: czy marka jest wymieniana lub cytowana oraz na jakich pozycjach w wyszukiwarce są strona i wątki Reddit dla słów kluczowych rynku), threads (każdy wątek raz, według taktyki: reply_now, ranking, reference, z wydźwiękiem i statusem możliwości odpowiedzi), given_threads (analiza Twoich wątków), completeness
extended, agent	kompaktowy JSON o rozmiarze najwyżej 5 KB: 10 pól profilu (product_name, product_description, icp, keywords, competitors, pain_points, key_benefits, key_features, watched_subreddits, serp_queries), segmenty kupujących, sygnały dopasowania, bezpieczne i ryzykowne twierdzenia, krótkie podsumowanie widoczności w AI, completeness

W formacie agent wywołanie jobs/get zwraca preview z 10 polami profilu, gdy tylko są one znane (zwykle w ciągu minuty), i aktualizuje je w trakcie realizacji zamówienia. Aby otrzymać pełny raport zamówienia agent, wywołaj jobs/result z "view": "full"; nie jest to ponownie płatne.

completeness wymienia każdą sekcję z tym, co znaleziono, celem i minimum, a także część ceny, która zostaje pobrana.

PDF

POST /v1/domain-delivery/jobs/pdf z {"job_id": "dd_…"} zwraca gotowy raport jako plik PDF, gotowy do wysłania klientowi końcowemu.

Błędy

Kod	Kiedy
401	brak klucza API lub nieprawidłowy klucz
403	raporty domen nie są włączone dla klucza
404 JOB_NOT_FOUND	nieznane zamówienie lub zamówienie innego konta
409 JOB_NOT_READY	wynik lub PDF zażądano przed zakończeniem zamówienia
422 INVALID_URL, 422 MODE_NOT_AVAILABLE, 422 INVALID_FORMAT	wartość spoza powyższych list
422 FORMAT_NOT_AVAILABLE, 422 THREADS_NOT_AVAILABLE, 422 QUESTIONS_NOT_AVAILABLE, 422 VOICE_NOT_AVAILABLE, 422 MAX_AGE_NOT_AVAILABLE	opcja użyta z basic (lub z threads_only), która działa tylko w pełnym zamówieniu extended
422 INVALID_THREADS, 422 INVALID_MAX_AGE, 422 INVALID_VOICE, 422 INVALID_IDEMPOTENCY_KEY	pole poza zakresem
429	zbyt wiele żądań lub budżet klucza został wykorzystany

Każdy błąd ma tę samą postać: {"error": {"code": "INVALID_URL", "message": "…"}}. Wskazówki dotyczące ponawiania prób znajdziesz w sekcji Błędy i ponawianie prób.