v1Recursos/AEO/getObtener el informe AEO de una ubicación
Obtener el informe AEO de una ubicación
Devuelve el informe de visibilidad en IA más reciente de una ubicación: puntuaciones generales y por motor, la matriz de palabras clave/prompts, comparaciones de brechas y posicionamiento frente a la competencia, cobertura de citas, sentimiento y correcciones recomendadas. La generación del informe es asíncrona — este es también el endpoint de sondeo para POST /api/v1/aeo/reports/enqueue: siga llamando a este endpoint y observe el campo generating hasta que vuelva a false y generatedAt se actualice. Indique prompt para profundizar en un prompt seguido específico en lugar del informe completo.
get
aeo:read/api/v1/aeo/reportsParámetros de consulta
locationIdstringobligatorio
La ubicación a consultar.
clientIdstringopcional
El cliente de la ubicación.
promptstringopcional
Profundiza en un prompt seguido (coincidencia sin distinción de mayúsculas) en lugar de devolver el informe completo. Devuelve celdas null si el prompt no está en la matriz de esta ubicación.
Respuesta
dataobjectopcional
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/aeo/reports
Su clave de API
locationId *
clientId
prompt
{
"data": {
"generatedAt": "2026-02-01T06:00:00.000Z",
"generating": false,
"configuredEngines": [
"ChatGPT",
"Gemini"
],
"visibility": {
"overall": 62,
"label": "GOOD",
"message": "Your business shows up for most of the prompts you're tracking.",
"engines": {
"ChatGPT": {
"score": 68,
"comparisonPct": 12,
"configured": true
},
"Gemini": {
"score": 56,
"comparisonPct": -4,
"configured": true
},
"Perplexity": {
"score": null,
"comparisonPct": null,
"configured": false
}
}
},
"metrics": {
"visibility": {
"value": 62,
"delta": 5
},
"mentionRate": {
"value": 71,
"delta": 3
},
"avgPosition": {
"value": 2.1,
"delta": -0.4
},
"promptsCovered": {
"value": 8,
"total": 10
},
"sourcesCited": {
"value": 14,
"delta": 2
}
},
"keywordMap": {
"ChatGPT": [
{
"keyword": "best dentist austin",
"percentage": 82,
"dataSources": [
{
"name": "Google Business Profile"
}
]
}
],
"Gemini": [
{
"keyword": "emergency dentist austin",
"percentage": 54,
"dataSources": []
}
],
"Perplexity": []
},
"matrix": [
{
"keyword": "best dentist austin",
"cells": {
"ChatGPT": {
"score": 82,
"mentioned": true,
"rank": 1,
"answerExcerpt": "Acme Dental — Downtown is highly rated for..."
},
"Gemini": {
"score": 54,
"mentioned": true,
"rank": 3,
"answerExcerpt": null
},
"Perplexity": null
},
"best": 82
}
],
"gap": [
{
"business": "Acme Dental — Downtown",
"isYou": true,
"overall": 62,
"chatgpt": 68,
"gemini": 56,
"perplexity": null,
"comparisonPct": null
},
{
"business": "Smile Bright Dental",
"isYou": false,
"overall": 71,
"chatgpt": 74,
"gemini": 68,
"perplexity": null,
"comparisonPct": 9
}
],
"ranking": {
"All": {
"primary": {
"good": 6,
"neutral": 2,
"bad": 2
},
"competitors": []
},
"ChatGPT": {
"primary": {
"good": 7,
"neutral": 1,
"bad": 2
},
"competitors": []
},
"Gemini": {
"primary": {
"good": 5,
"neutral": 3,
"bad": 2
},
"competitors": []
},
"Perplexity": {
"primary": {
"good": 0,
"neutral": 0,
"bad": 0
},
"competitors": []
}
},
"radar": {
"ChatGPT": {
"relevance": 78,
"reviews": 88,
"engagement": 65,
"freshness": 74,
"citations": 81
},
"Gemini": {
"relevance": 70,
"reviews": 80,
"engagement": 75,
"freshness": 85,
"citations": 65
},
"Perplexity": {
"relevance": 0,
"reviews": 0,
"engagement": 0,
"freshness": 0,
"citations": 0
}
},
"factors": [
{
"key": "citations",
"label": "Citations",
"value": 81,
"detail": "Cited by 14 of 20 tracked sources across configured engines.",
"action": {
"label": "Fix missing citations",
"target": "citations"
}
}
],
"citations": {
"summary": {
"totalSources": 20,
"active": 14,
"detected": 4,
"missing": 2,
"missingDirectories": [
"Yelp"
]
},
"byEngine": {
"ChatGPT": [
{
"name": "Google Business Profile",
"status": "active"
}
],
"Gemini": [],
"Perplexity": []
}
},
"sentiment": {
"positive": 62,
"neutral": 30,
"negative": 8,
"mentions": []
},
"attention": [
{
"text": "Bing Places is missing your current hours.",
"tone": "warn"
}
],
"recommendations": [
{
"id": "rec_reviews_1",
"kind": "opportunity",
"priority": "high",
"title": "Add more customer reviews mentioning services",
"detail": "Reviews that name specific services improve how often engines cite you for those prompts.",
"action": {
"label": "Request reviews",
"target": "reviews"
}
}
],
"history": [
{
"yearMonth": "2026-01",
"overall": 57,
"chatgpt": 61,
"gemini": 53,
"perplexity": null,
"sources": 12
},
{
"yearMonth": "2026-02",
"overall": 62,
"chatgpt": 68,
"gemini": 56,
"perplexity": null,
"sources": 14
}
],
"competitorHistory": [
{
"name": "Smile Bright Dental",
"points": [
{
"yearMonth": "2026-01",
"overall": 65
},
{
"yearMonth": "2026-02",
"overall": 71
}
]
}
]
}
}