Domain-Bericht
Sie geben die Website eines Kunden an und erhalten einen Bericht darüber, wie sie sich in öffentlichen Diskussionen und in der Suche bewerben lässt: für wen das Produkt gedacht ist, die Keywords des Marktes mit gemessenen Suchvolumina, echte Wettbewerber, die Communitys, in denen Käufer sich austauschen, die Suchanfragen, die relevante Threads zutage fördern, und im erweiterten Bericht die Threads, auf die sich eine Antwort lohnt, samt ihrer Stimmung, ein vollständiges Unternehmensanalyse-Briefing und die Sichtbarkeit der Marke in KI-Assistenten und in der Suche.
Gedacht für Agenturen und Plattformen, die Promotion verkaufen: ein Aufruf pro Kunden-Domain, ein Preis pro geliefertem Bericht.
Domain-Berichte werden pro Schlüssel freigeschaltet. Schreiben Sie an support@omev.be, um sie zu aktivieren. Der Bericht wird dem üblichen Guthaben des Schlüssels belastet.
Modi und Preise
mode | Preis pro geliefertem Bericht | Was Sie erhalten | Typische Dauer |
|---|---|---|---|
basic | $0.99 | eine einfache Antwort: Produkt, Käuferprofil, bis zu 20 Keywords mit Volumina, 3–5 Wettbewerber, bis zu 20 aktive Communitys nach Relevanz sortiert, 15 Suchanfragen, ein kompaktes Profil mit 10 Feldern | etwa 10 Minuten, höchstens 1 Stunde |
extended (Standard) | $2.99 | alles aus basic, dazu das Unternehmensanalyse-Briefing mit der Stimme der Zielgruppe, die Threads für Antworten mit ihrer Stimmung und Antwortentwürfen, die Prüfung der KI-Sichtbarkeit und die Analyse der Threads, die Sie angeben | meist 20–60 Minuten, höchstens 5 Stunden |
Ein Bericht wird einmal berechnet, beim ersten Herunterladen des fertigen Ergebnisses, und zwar nach seiner Vollständigkeit: ab 75 % der volle Preis, bei 40–74 % 70 % des Preises ($0.69 oder $2.09), bei 15–39 % 30 % des Preises ($0.29 oder $0.89), unter 15 % kostenlos. Teilbeträge werden auf ganze Cent abgerundet. Wiederholte Downloads, fehlgeschlagene und abgebrochene Aufträge werden nicht berechnet.
Einen Bericht bestellen
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"
}'
| Feld | Erforderlich | Bedeutung |
|---|---|---|
url | ja | die Website des Kunden |
mode | nein | basic oder extended (Standard) |
format | nein | nur extended: standard (Standard, der vollständige Bericht) oder agent (eine kompakte Antwort für einen KI-Agenten, siehe unten) |
market | nein | bis zu 10 Länder oder Regionen, zum Beispiel "US" oder ["UA", "EU"] |
language | nein | bis zu 6 Sprachcodes, zum Beispiel "en" oder ["en", "de"] |
questions | nein | nur extended: 1–15 eigene Käuferfragen für die Prüfung der KI-Sichtbarkeit, jeweils 5–200 Zeichen |
threads | nein | nur extended: 1–10 Links zu Reddit-Threads für eine detaillierte Analyse |
threads_only | nein | mit threads: true analysiert nur diese Threads |
voice | nein | nur extended: in wessen Namen die Antwortentwürfe sprechen, brand (Standard) oder community_member |
max_age_months | nein | nur extended: 1–60; ältere Threads werden ausgelassen (von Ihnen angegebene Threads werden nie gefiltert) |
client_ref | nein | Ihre eigene Bezeichnung für den Endkunden, bis zu 100 Zeichen |
idempotency_key | nein | 8–200 Zeichen; eine Wiederholung liefert denselben Auftrag, statt einen neuen zu starten |
Die Antwort ist 202 mit dem Auftrag:
{"job": {"id": "dd_…", "status": "queued", "mode": "extended", "format": "standard",
"stage": null, "charged_usd": 0, …},
"idempotent_replay": false}
OmevAI bereitet die Antwortentwürfe vor; es veröffentlicht nie etwas. Ob und wie ein Entwurf verwendet wird, entscheiden Sie.
Den Auftrag verfolgen
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 ist queued, running und danach completed, failed oder cancelled. Während der Ausführung zeigt stage den Schritt: report, preview (das Format agent), threads, visibility, final. steps zeigt jeden Schritt mit seinen Versuchen: Ein fehlgeschlagener Schritt wird bis zu zweimal wiederholt. Ein gelieferter Auftrag ist completed mit completeness_percent. Fragen Sie alle 30–60 Sekunden ab.
Um einen Auftrag zu stoppen, senden Sie denselben Body an /v1/domain-delivery/jobs/cancel.
Den Bericht herunterladen
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_…"}'
Die Antwort enthält job und result. Bevor der Auftrag fertig ist, gibt der Aufruf 409 JOB_NOT_READY zurück; ein fehlgeschlagener oder abgebrochener Auftrag liefert "result": null.
| Bericht | result enthält |
|---|---|
basic | product, icp (Käuferprofil und 1–3 Segmente), keywords (Phrase, Volumen, Rang), competitors, subreddits (aktive Communitys mit einem passenden Beitrag, nach Relevanz sortiert), queries, profile (10 Felder), completeness, limitations |
extended, standard | report (das vollständige Unternehmensanalyse-Briefing), ai_visibility (Käuferfragen, die KI-Assistenten und der KI-Suche gestellt wurden: ob die Marke erwähnt oder zitiert wird, und wo die Website und Reddit-Threads in der Suche für die Keywords des Marktes ranken), threads (jeder Thread einmal nach Taktik: reply_now, ranking, reference, mit seiner Stimmung und dem Antwortstatus), given_threads (Ihre analysierten Threads), completeness |
extended, agent | ein kompaktes JSON von höchstens 5 KB: die 10 Profilfelder (product_name, product_description, icp, keywords, competitors, pain_points, key_benefits, key_features, watched_subreddits, serp_queries), Käufersegmente, Passungssignale, sichere und riskante Aussagen, eine kurze Zusammenfassung der KI-Sichtbarkeit, completeness |
Beim Format agent liefert jobs/get das Feld preview mit den 10 Profilfeldern, sobald sie bekannt sind (meist innerhalb einer Minute), und aktualisiert es, während der Auftrag läuft. Für den vollständigen Bericht eines agent-Auftrags rufen Sie jobs/result mit "view": "full" auf; das wird nicht erneut berechnet.
completeness führt jeden Abschnitt mit dem Gefundenen, dem Ziel und dem Minimum auf sowie den Anteil des berechneten Preises.
PDF
POST /v1/domain-delivery/jobs/pdf mit {"job_id": "dd_…"} liefert den fertigen Bericht als PDF-Datei, bereit zum Versand an den Endkunden.
Fehler
| Code | Wann |
|---|---|
401 | fehlender oder ungültiger API-Schlüssel |
403 | Domain-Berichte sind für den Schlüssel nicht freigeschaltet |
404 JOB_NOT_FOUND | unbekannter Auftrag oder ein Auftrag eines anderen Kontos |
409 JOB_NOT_READY | das Ergebnis oder das PDF wurde angefordert, bevor der Auftrag fertig war |
422 INVALID_URL, 422 MODE_NOT_AVAILABLE, 422 INVALID_FORMAT | ein Wert außerhalb der obigen Listen |
422 FORMAT_NOT_AVAILABLE, 422 THREADS_NOT_AVAILABLE, 422 QUESTIONS_NOT_AVAILABLE, 422 VOICE_NOT_AVAILABLE, 422 MAX_AGE_NOT_AVAILABLE | eine Option, die mit basic (oder mit threads_only) verwendet wurde und nur in einem vollständigen extended-Auftrag funktioniert |
422 INVALID_THREADS, 422 INVALID_MAX_AGE, 422 INVALID_VOICE, 422 INVALID_IDEMPOTENCY_KEY | ein Feld außerhalb des zulässigen Bereichs |
429 | zu viele Anfragen oder das Budget des Schlüssels ist aufgebraucht |
Jeder Fehler hat dieselbe Form: {"error": {"code": "INVALID_URL", "message": "…"}}. Hinweise zu Wiederholungen finden Sie unter Fehler und Wiederholungsversuche.