Synupv1
Créer une clé
v1Ressources/AEO/getObtenir la synthèse AEO tous établissements

Obtenir la synthèse AEO tous établissements

Renvoie la synthèse du dernier rapport AEO par établissement, éventuellement restreinte à un client et/ou à des tags d'établissement, ainsi que la tendance de portefeuille et les données de correction systémique. Les établissements sans rapport encore affichent des scores null.

get/api/v1/aeo/rollup
aeo:read
Paramètres de requête
clientIdstringfacultatif
Restreint les résultats à un client. Quand votre clé est limitée à des clients spécifiques, ceci est obligatoire.
tagsstringfacultatif
Noms de tags d'établissement séparés par des virgules. Seuls les établissements portant au moins un de ces tags sont inclus.
Réponse
dataobjectfacultatif
rowsarray of objectfacultatif
Une ligne par établissement dans le périmètre.
locationIdstringfacultatif
Identifiant unique de l'établissement.
namestringfacultatif
Le nom commercial de l'établissement.
citystringfacultatif
Ville, ou null.
overallnumberfacultatif
Dernier score de visibilité IA global (0 à 100), ou null si jamais généré.
chatgptnumberfacultatif
Dernier score ChatGPT, ou null.
gemininumberfacultatif
Dernier score Gemini, ou null.
perplexitynumberfacultatif
Dernier score Perplexity, ou null.
generatedAtstringfacultatif
Date de génération du dernier rapport, au format horodatage ISO 8601, ou null si jamais généré.
yearMonthstringfacultatif
Mois du dernier rapport (YYYY-MM), ou null.
tagsarray of stringfacultatif
Les tags internes de l'établissement.
historyarray of numberfacultatif
Historique du score global pour cet établissement, chronologique, valeurs non nulles uniquement.
deltanumberfacultatif
Variation du score global par rapport au rapport précédent, ou null sur le premier rapport ou s'il n'y a pas de mois précédent.
topIssueobjectfacultatif
Le facteur de visibilité le plus faible de cet établissement, ou null s'il n'a pas encore de rapport.
labelstringfacultatif
tonestring (good | warn | bad)facultatif
configuredEnginesarray of string (ChatGPT | Gemini | Perplexity)facultatif
Moteurs IA pour lesquels cette agence a une clé API configurée.
portfolioHistoryarray of objectfacultatif
Score global moyen sur les établissements du périmètre, par mois.
yearMonthstringfacultatif
Mois au format YYYY-MM.
avgnumberfacultatif
Score global moyen sur les établissements ayant un rapport ce mois-là.
locationsnumberfacultatif
Nombre d'établissements ayant un rapport ce mois-là (le dénominateur de la moyenne).
systemicFixesarray of objectfacultatif
Faiblesses transversales partagées par plusieurs établissements, chacune avec une correction groupée unique, classées par portée.
factorstringfacultatif
Identifiant de facteur lisible par une machine.
labelstringfacultatif
Nom de facteur lisible par un humain.
detailstringfacultatif
Explication de la faiblesse systémique.
targetstring (listings | citations | reviews | posts | competitors | prompts)facultatif
Vers quelle partie du produit la correction mène.
countnumberfacultatif
Nombre d'établissements concernés.
pctnumberfacultatif
Pourcentage d'établissements en rapport concernés.
Erreurs
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/aeo/rollup
Votre clé 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
      }
    ]
  }
}