v1Ressources/AEO/getObtenir le rapport AEO d'un établissement
Obtenir le rapport AEO d'un établissement
Renvoie le dernier rapport de visibilité IA d'un établissement : scores global et par moteur, la matrice mots-clés/prompts, les comparaisons d'écart et de classement concurrentiel, la couverture des citations, le sentiment et les corrections recommandées. La génération de rapport est asynchrone — cet endpoint est aussi la cible d'interrogation pour POST /api/v1/aeo/reports/enqueue : continuez à l'appeler et surveillez le champ generating jusqu'à ce qu'il repasse à false et que generatedAt se mette à jour. Passez prompt pour explorer un seul prompt suivi au lieu du rapport complet.
get
aeo:read/api/v1/aeo/reportsParamètres de requête
locationIdstringobligatoire
L'établissement à consulter.
clientIdstringfacultatif
Le client de l'établissement.
promptstringfacultatif
Explore un seul prompt suivi (comparé sans distinction de casse) au lieu de renvoyer le rapport complet. Renvoie des cellules null si le prompt n'est pas dans la matrice de cet établissement.
Réponse
dataobjectfacultatif
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
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.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/aeo/reports
Votre clé 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
}
]
}
]
}
}