Saltar al contenido principal
Oriéntate en 30 segundos. Cada fila es un endpoint; haz clic para ver la referencia completa de parámetros. Esta página cubre los endpoints que usan las recetas, además de los grupos principales de endpoints; la lista completa (incluidos Documents, Knowledge bases, Projects, Integrations y OpenAI Ads) está en la pestaña REST API. Para un contexto más profundo sobre las convenciones (fechas, ordenación, paginación), consulta Convenciones y trampas comunes.

Organización y configuración

Informes

Los endpoints de informes de Answer Engine Insights son solicitudes POST con ámbito de category_id y devuelven la estructura {info, data}. Los informes de visibilidad, citas, sentimiento y query-fanouts aceptan category_id, start_date, end_date y metrics, además de campos opcionales específicos de cada informe. Los informes de tráfico usan una estructura diferente: bots y referencias tienen como ámbito domain en lugar de category_id. Los informes de FactCheck V2 y las respuestas de prompts V2 tienen ámbito de categoría y fecha, pero no aceptan un campo metrics.

/v1/reports/visibility

Con qué frecuencia aparece tu activo en las respuestas de IA. Recetas comunes: Visibility Score (con delta), a lo largo del tiempo, clasificación, comparar competidores, segmentar por modelo/región/persona.

/v1/reports/citations

Qué URL y dominios citan las respuestas de IA. Recetas comunes: Citation Share + delta, cuota + volumen a lo largo del tiempo, clasificar por dominio.
citation_share se promedia por modelo de IA. count es el número bruto. Ordenar por uno no sigue al otro. Elige la pregunta que estás respondiendo y ordena por la métrica correspondiente.

/v1/reports/sentiment

Qué tan positiva o negativamente hacen referencia las respuestas de IA a tu activo.
/v1/reports/sentiment es el procesador de sentimiento heredado y sus números no coincidirán con el valor principal de la app de Profound. La app lee de Sentiment v2: usa POST /v2/reports/sentiment (consulta Filtrado y conceptos). Sus métricas positive_sentiment / negative_sentiment son porcentajes que suman 100 en cada fila, por lo que no son comparables con los recuentos de v1.

/v1/reports/query-fanouts

La vista de query-fanout (cómo los prompts se propagan en cascada por las superficies de IA). La misma estructura {info, data}.

/v1/reports/referrals (y /v2/reports/referrals)

Tráfico de referencias humanas a tus dominios atribuido a respuestas de IA.

/v1/reports/bots (y /v2/reports/bots)

Tráfico de rastreadores / bots de IA a tus dominios.

/v2/reports/factcheck y /v2/reports/factcheck/claims

Puntuaciones de FactCheck y afirmaciones inexactas de una categoría. Estos endpoints aceptan category_id, start_date y end_date, pero no metrics.

Endpoints de informes V2

POST /v2/reports/visibility, /v2/reports/citations, /v2/reports/sentiment y /v2/reports/query-fanouts son los equivalentes V2 de los informes V1 anteriores, con un end_date inclusivo, un árbol filter, campos de métrica con nombre en cada fila y paginación por cursor. /v2/reports/shopping/* y /v2/reports/social/youtube/* solo existen en V2. Cada uno tiene una variante SSE /stream. Consulta Filtrado y conceptos.

Respuestas (datos por prompt)

Agents

Prompts

Content Optimization (beta)


Para la referencia canónica de parámetros (todos los operadores, todos los campos, obligatorios frente a opcionales), consulta la pestaña REST API.