Synupv1
Crear clave
v1Recursos/AEO/getObtener el resumen AEO de todas las ubicaciones

Obtener el resumen AEO de todas las ubicaciones

Devuelve el resumen del informe AEO más reciente por ubicación, opcionalmente limitado a un cliente y/o etiquetas de ubicación, además de datos de tendencia de toda la cartera y de correcciones sistémicas. Las ubicaciones sin informe todavía muestran puntuaciones null.

get/api/v1/aeo/rollup
aeo:read
Parámetros de consulta
clientIdstringopcional
Restringe los resultados a un cliente. Cuando su clave está limitada a clientes específicos, esto es obligatorio.
tagsstringopcional
Nombres de etiquetas de ubicación separados por comas. Solo se incluyen las ubicaciones que tengan al menos una de estas etiquetas.
Respuesta
dataobjectopcional
rowsarray of objectopcional
Una fila por cada ubicación en el alcance.
locationIdstringopcional
Identificador único de la ubicación.
namestringopcional
El nombre comercial de la ubicación.
citystringopcional
Ciudad, o null.
overallnumberopcional
Última puntuación general de visibilidad en IA (de 0 a 100), o null si nunca se generó.
chatgptnumberopcional
Última puntuación de ChatGPT, o null.
gemininumberopcional
Última puntuación de Gemini, o null.
perplexitynumberopcional
Última puntuación de Perplexity, o null.
generatedAtstringopcional
Cuándo se generó el informe más reciente, como marca de tiempo ISO 8601, o null si nunca se generó.
yearMonthstringopcional
Mes del informe más reciente (YYYY-MM), o null.
tagsarray of stringopcional
Las etiquetas internas de la ubicación.
historyarray of numberopcional
Historial de puntuación general de esta ubicación, en orden cronológico, solo valores no null.
deltanumberopcional
Variación de la puntuación general respecto al informe anterior, o null en el primer informe o si no hay un mes previo.
topIssueobjectopcional
El factor de visibilidad más débil de esta ubicación, o null si aún no tiene un informe.
labelstringopcional
tonestring (good | warn | bad)opcional
configuredEnginesarray of string (ChatGPT | Gemini | Perplexity)opcional
Motores de IA para los que esta agencia tiene una clave de API configurada.
portfolioHistoryarray of objectopcional
Puntuación general promedio entre las ubicaciones en el alcance, por mes.
yearMonthstringopcional
Mes en formato YYYY-MM.
avgnumberopcional
Puntuación general promedio entre las ubicaciones con informe ese mes.
locationsnumberopcional
Número de ubicaciones con informe ese mes (el denominador del promedio).
systemicFixesarray of objectopcional
Debilidades compartidas entre varias ubicaciones, cada una con una única corrección por lotes, ordenadas por alcance.
factorstringopcional
Identificador del factor legible por máquina.
labelstringopcional
Nombre del factor legible por humanos.
detailstringopcional
Explicación de la debilidad sistémica.
targetstring (listings | citations | reviews | posts | competitors | prompts)opcional
A qué parte del producto dirige la corrección.
countnumberopcional
Número de ubicaciones afectadas.
pctnumberopcional
Porcentaje de ubicaciones con informe afectadas.
Errores
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.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/aeo/rollup
Su clave de API
clientId
tags
{
  "data": {
    "rows": [
      {
        "locationId": "cm_loc_1",
        "name": "Acme Dental — Downtown",
        "city": "Austin",
        "overall": 62,
        "chatgpt": 68,
        "gemini": 56,
        "perplexity": null,
        "generatedAt": "2026-02-01T06:00:00.000Z",
        "yearMonth": "2026-02",
        "tags": [
          "priority"
        ],
        "history": [
          57,
          62
        ],
        "delta": 5,
        "topIssue": null
      }
    ],
    "configuredEngines": [
      "ChatGPT",
      "Gemini"
    ],
    "portfolioHistory": [
      {
        "yearMonth": "2026-01",
        "avg": 57,
        "locations": 5
      },
      {
        "yearMonth": "2026-02",
        "avg": 62,
        "locations": 5
      }
    ],
    "systemicFixes": [
      {
        "factor": "citations",
        "label": "Citations",
        "detail": "6 locations are missing citations on Yelp.",
        "target": "citations",
        "count": 6,
        "pct": 30
      }
    ]
  }
}