Informe de dominio
Indica el sitio web de un cliente y recibe un único informe sobre cómo promocionarlo en debates públicos y en el buscador: para quién es el producto, las palabras clave del mercado con volúmenes de búsqueda medidos, los competidores reales, las comunidades donde hablan los compradores, las búsquedas que hacen aparecer hilos relevantes y, en el informe extendido, los hilos que merece la pena responder con su tono, un informe completo de inteligencia de empresa y lo visible que es la marca en los asistentes de IA y en el buscador.
Pensado para agencias y plataformas que venden promoción: una llamada por dominio de cliente, un precio por informe entregado.
Los informes de dominio se activan para cada clave por separado. Escribe a support@omev.be para activarlos. El informe se cobra del saldo habitual de la clave.
Modos y precios
mode | Precio por informe entregado | Qué recibes | Tiempo habitual |
|---|---|---|---|
basic | $0.99 | una respuesta sencilla: producto, perfil del comprador, hasta 20 palabras clave con volúmenes, 3–5 competidores, hasta 20 comunidades activas ordenadas por relevancia, 15 búsquedas, un perfil compacto de 10 campos | unos 10 minutos, como máximo 1 hora |
extended (por defecto) | $2.99 | todo lo de basic, más el informe de inteligencia de empresa con la voz de la audiencia, los hilos que responder con su tono y borradores de respuesta, la comprobación de visibilidad en IA y el análisis de los hilos que indiques | normalmente 20–60 minutos, como máximo 5 horas |
Un informe se cobra una sola vez, en la primera descarga del resultado terminado, según lo completo que esté: con un 75 % o más se cobra el precio completo, entre el 40 % y el 74 % el 70 % del precio ($0.69 o $2.09), entre el 15 % y el 39 % el 30 % del precio ($0.29 o $0.89), por debajo del 15 % es gratis. Los importes parciales se redondean a la baja a céntimos enteros. No se cobran las descargas repetidas ni los pedidos fallidos o cancelados.
Pedir un informe
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"
}'
| Campo | Requerido | Significado |
|---|---|---|
url | sí | el sitio web del cliente |
mode | no | basic o extended (por defecto) |
format | no | solo extended: standard (por defecto, el informe completo) o agent (una respuesta compacta para un agente de IA, ver más abajo) |
market | no | hasta 10 países o regiones, como "US" o ["UA", "EU"] |
language | no | hasta 6 códigos de idioma, como "en" o ["en", "de"] |
questions | no | solo extended: de 1 a 15 preguntas propias de compradores para la comprobación de visibilidad en IA, de 5 a 200 caracteres cada una |
threads | no | solo extended: de 1 a 10 enlaces a hilos de Reddit que analizar en detalle |
threads_only | no | con threads: true analiza solo esos hilos |
voice | no | solo extended: en nombre de quién hablan los borradores de respuesta, brand (por defecto) o community_member |
max_age_months | no | solo extended: de 1 a 60; los hilos más antiguos quedan fuera (los hilos que indicas nunca se filtran) |
client_ref | no | tu propia etiqueta para el cliente final, hasta 100 caracteres |
idempotency_key | no | de 8 a 200 caracteres; repetirla devuelve el mismo pedido en lugar de iniciar uno nuevo |
La respuesta es 202 con el pedido:
{"job": {"id": "dd_…", "status": "queued", "mode": "extended", "format": "standard",
"stage": null, "charged_usd": 0, …},
"idempotent_replay": false}
OmevAI prepara los borradores de respuesta; nunca publica nada. Decidir si se usa un borrador y cómo es decisión tuya.
Seguimiento del pedido
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 pasa por queued, running y después completed, failed o cancelled. Durante la ejecución, stage indica el paso: report, preview (el formato agent), threads, visibility, final. steps muestra cada paso con sus intentos: un paso fallido se reintenta hasta dos veces más. Un pedido entregado queda en completed con completeness_percent. Consulta el estado cada 30–60 segundos.
Para detener un pedido, envía el mismo cuerpo a /v1/domain-delivery/jobs/cancel.
Descargar el informe
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 respuesta contiene job y result. Antes de que termine el pedido, la llamada devuelve 409 JOB_NOT_READY; un pedido fallido o cancelado devuelve "result": null.
| Informe | result contiene |
|---|---|
basic | product, icp (perfil del comprador y 1–3 segmentos), keywords (frase, volumen, posición), competitors, subreddits (comunidades activas con una publicación pertinente, ordenadas por relevancia), queries, profile (10 campos), completeness, limitations |
extended, standard | report (el informe completo de inteligencia de empresa), ai_visibility (preguntas de compradores planteadas a asistentes de IA y a la búsqueda con IA: si la marca se menciona o se cita, y en qué posición aparecen el sitio y los hilos de Reddit en el buscador para las palabras clave del mercado), threads (cada hilo una sola vez según la táctica: reply_now, ranking, reference, con su tono y si admite respuestas), given_threads (tus hilos analizados), completeness |
extended, agent | un JSON compacto de 5 KB como máximo: los 10 campos del perfil (product_name, product_description, icp, keywords, competitors, pain_points, key_benefits, key_features, watched_subreddits, serp_queries), segmentos de compradores, señales de encaje, afirmaciones seguras y arriesgadas, un breve resumen de visibilidad en IA, completeness |
Con el formato agent, jobs/get devuelve preview con los 10 campos del perfil en cuanto se conocen (normalmente en menos de un minuto) y lo va revisando mientras se ejecuta el pedido. Para obtener el informe completo de un pedido agent, llama a jobs/result con "view": "full"; no se vuelve a cobrar.
completeness enumera cada sección con lo encontrado, el objetivo y el mínimo, y la parte del precio que se cobra.
PDF
POST /v1/domain-delivery/jobs/pdf con {"job_id": "dd_…"} devuelve el informe terminado como archivo PDF, listo para enviarlo al cliente final.
Errores
| Código | Cuándo |
|---|---|
401 | clave de API ausente o no válida |
403 | los informes de dominio no están activados para la clave |
404 JOB_NOT_FOUND | pedido desconocido, o un pedido de otra cuenta |
409 JOB_NOT_READY | se pidió el resultado o el PDF antes de que terminara el pedido |
422 INVALID_URL, 422 MODE_NOT_AVAILABLE, 422 INVALID_FORMAT | un valor fuera de las listas anteriores |
422 FORMAT_NOT_AVAILABLE, 422 THREADS_NOT_AVAILABLE, 422 QUESTIONS_NOT_AVAILABLE, 422 VOICE_NOT_AVAILABLE, 422 MAX_AGE_NOT_AVAILABLE | una opción usada con basic (o con threads_only) que solo funciona en un pedido extended completo |
422 INVALID_THREADS, 422 INVALID_MAX_AGE, 422 INVALID_VOICE, 422 INVALID_IDEMPOTENCY_KEY | un campo fuera de rango |
429 | demasiadas peticiones, o el presupuesto de la clave se ha agotado |
Todos los errores tienen la misma forma: {"error": {"code": "INVALID_URL", "message": "…"}}. Consulta Errores y reintentos para ver los consejos sobre reintentos.