Organización y configuración
Informes
Los endpoints de informes de Answer Engine Insights son solicitudesPOST 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/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.
Respuestas (datos por prompt)
Agents
Prompts
Content Optimization
Para la referencia canónica de parámetros (todos los operadores, todos los campos, obligatorios frente a opcionales), consulta la pestaña REST API.