Rapport de domaine

Indiquez le site web d'un client et obtenez un rapport sur la manière de le promouvoir dans les discussions publiques et la recherche : à qui s'adresse le produit, les mots-clés du marché avec des volumes de recherche mesurés, les vrais concurrents, les communautés où les acheteurs discutent, les requêtes qui font remonter les fils pertinents et, dans le rapport étendu, les fils auxquels il vaut la peine de répondre avec leur tonalité, un dossier complet de veille sur l'entreprise et la visibilité de la marque dans les assistants IA et la recherche.

Conçu pour les agences et les plateformes qui vendent de la promotion : un appel par domaine client, un prix par rapport livré.

L'accès est activé sur demande

Les rapports de domaine sont activés clé par clé. Écrivez à support@omev.be pour les activer. Le rapport est facturé sur le solde habituel de la clé.

Modes et prix

mode	Prix par rapport livré	Ce que vous obtenez	Durée typique
basic	$0.99	une réponse simple : produit, profil d'acheteur, jusqu'à 20 mots-clés avec volumes, 3 à 5 concurrents, jusqu'à 20 communautés actives classées par pertinence, 15 requêtes de recherche, un profil compact en 10 champs	environ 10 minutes, 1 heure au maximum
extended (par défaut)	$2.99	tout le contenu de basic, plus le dossier de veille sur l'entreprise avec la voix de l'audience, les fils auxquels répondre avec leur tonalité et des brouillons de réponse, la vérification de la visibilité dans l'IA et l'analyse des fils que vous indiquez	généralement 20 à 60 minutes, 5 heures au maximum

Un rapport est facturé une seule fois, lors du premier téléchargement du résultat terminé, selon son degré de complétude : 75 % ou plus correspond au prix complet, 40–74 % à 70 % du prix ($0.69 ou $2.09), 15–39 % à 30 % du prix ($0.29 ou $0.89), en dessous de 15 % c'est gratuit. Les montants partiels sont arrondis au centime inférieur. Les téléchargements répétés, les commandes échouées et annulées ne sont pas facturés.

Commander un rapport

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

Champ	Requis	Signification
url	oui	le site web du client
mode	non	basic ou extended (par défaut)
format	non	extended uniquement : standard (par défaut, le rapport complet) ou agent (une réponse compacte pour un agent IA, voir ci-dessous)
market	non	jusqu'à 10 pays ou régions, par exemple "US" ou ["UA", "EU"]
language	non	jusqu'à 6 codes de langue, par exemple "en" ou ["en", "de"]
questions	non	extended uniquement : 1 à 15 de vos propres questions d'acheteurs pour la vérification de la visibilité dans l'IA, de 5 à 200 caractères chacune
threads	non	extended uniquement : 1 à 10 liens de fils Reddit à analyser en détail
threads_only	non	avec threads : true analyse uniquement ces fils
voice	non	extended uniquement : au nom de qui parlent les brouillons de réponse, brand (par défaut) ou community_member
max_age_months	non	extended uniquement : 1 à 60 ; les fils plus anciens sont exclus (les fils que vous indiquez ne sont jamais filtrés)
client_ref	non	votre propre libellé pour le client final, jusqu'à 100 caractères
idempotency_key	non	8 à 200 caractères ; la réutiliser renvoie la même commande au lieu d'en lancer une nouvelle

La réponse est 202 avec la commande :

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

OmevAI prépare les brouillons de réponse ; il ne publie jamais rien. L'utilisation d'un brouillon, et la manière de l'utiliser, relèvent de votre décision.

Suivre la commande

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 vaut queued, running, puis completed, failed ou cancelled. Pendant l'exécution, stage indique l'étape : report, preview (le format agent), threads, visibility, final. steps présente chaque étape avec ses tentatives : une étape échouée est relancée jusqu'à deux fois de plus. Une commande livrée est completed avec completeness_percent. Interrogez le statut toutes les 30 à 60 secondes.

Pour arrêter une commande, envoyez le même corps à /v1/domain-delivery/jobs/cancel.

Télécharger le rapport

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

La réponse contient job et result. Tant que la commande n'est pas terminée, l'appel renvoie 409 JOB_NOT_READY ; une commande échouée ou annulée renvoie "result": null.

Rapport	result contient
basic	product, icp (profil d'acheteur et 1 à 3 segments), keywords (expression, volume, position), competitors, subreddits (communautés actives avec une publication adaptée, classées par pertinence), queries, profile (10 champs), completeness, limitations
extended, standard	report (le dossier complet de veille sur l'entreprise), ai_visibility (des questions d'acheteurs posées aux assistants IA et à la recherche IA : si la marque est mentionnée ou citée, et où le site et les fils Reddit se classent dans la recherche pour les mots-clés du marché), threads (chaque fil une seule fois par tactique : reply_now, ranking, reference, avec sa tonalité et son statut de réponse), given_threads (vos fils analysés), completeness
extended, agent	un JSON compact de 5 Ko au maximum : les 10 champs du profil (product_name, product_description, icp, keywords, competitors, pain_points, key_benefits, key_features, watched_subreddits, serp_queries), les segments d'acheteurs, les signaux d'adéquation, les affirmations sûres et risquées, un court résumé de la visibilité dans l'IA, completeness

Avec le format agent, jobs/get renvoie preview avec les 10 champs du profil dès qu'ils sont connus (généralement en moins d'une minute), et l'actualise pendant l'exécution de la commande. Pour obtenir le rapport complet d'une commande agent, appelez jobs/result avec "view": "full" ; il n'est pas facturé une seconde fois.

completeness liste chaque section avec ce qui a été trouvé, l'objectif et le minimum, ainsi que la part du prix facturée.

PDF

POST /v1/domain-delivery/jobs/pdf avec {"job_id": "dd_…"} renvoie le rapport terminé sous forme de fichier PDF, prêt à être envoyé au client final.

Erreurs

Code	Quand
401	clé API manquante ou invalide
403	les rapports de domaine ne sont pas activés pour la clé
404 JOB_NOT_FOUND	commande inconnue, ou commande appartenant à un autre compte
409 JOB_NOT_READY	le résultat ou le PDF a été demandé avant la fin de la commande
422 INVALID_URL, 422 MODE_NOT_AVAILABLE, 422 INVALID_FORMAT	une valeur en dehors des listes ci-dessus
422 FORMAT_NOT_AVAILABLE, 422 THREADS_NOT_AVAILABLE, 422 QUESTIONS_NOT_AVAILABLE, 422 VOICE_NOT_AVAILABLE, 422 MAX_AGE_NOT_AVAILABLE	une option utilisée avec basic (ou avec threads_only) qui ne fonctionne que dans une commande extended complète
422 INVALID_THREADS, 422 INVALID_MAX_AGE, 422 INVALID_VOICE, 422 INVALID_IDEMPOTENCY_KEY	un champ hors limites
429	trop de requêtes, ou le budget de la clé est épuisé

Toutes les erreurs ont la même forme : {"error": {"code": "INVALID_URL", "message": "…"}}. Consultez Erreurs et nouvelles tentatives pour les conseils de nouvelle tentative.