v1Ressourcen/AEO/getStandortübergreifendes AEO-Rollup abrufen

Standortübergreifendes AEO-Rollup abrufen

Liefert die neueste AEO-Berichtszusammenfassung je Standort, optional eingeschränkt auf einen Kunden und/oder Standort-Tags, plus portfolioweite Trend- und Systemfehler-Daten. Standorte ohne bisherigen Bericht zeigen null-Scores.

get/api/v1/aeo/rollup

aeo:read

Query-Parameter

clientIdstringoptional

Ergebnisse auf einen Kunden beschränken. Ist Ihr Schlüssel auf bestimmte Kunden beschränkt, ist dies erforderlich.

tagsstringoptional

Kommagetrennte Liste von Standort-Tag-Namen. Nur Standorte mit mindestens einem dieser Tags werden einbezogen.

Antwort

dataobjectoptional

rowsarray of objectoptional

Eine Zeile je Standort im Geltungsbereich.

locationIdstringoptional

Eindeutige Kennung des Standorts.

namestringoptional

Der Firmenname des Standorts.

citystringoptional

Stadt, oder null.

overallnumberoptional

Neuester Gesamt-KI-Sichtbarkeits-Score (0–100), oder null, falls nie generiert.

chatgptnumberoptional

Neuester ChatGPT-Score, oder null.

gemininumberoptional

Neuester Gemini-Score, oder null.

perplexitynumberoptional

Neuester Perplexity-Score, oder null.

generatedAtstringoptional

Wann der neueste Bericht generiert wurde, als ISO-8601-Zeitstempel, oder null, falls nie generiert.

yearMonthstringoptional

Monat des neuesten Berichts (YYYY-MM), oder null.

tagsarray of stringoptional

Die internen Tags des Standorts.

historyarray of numberoptional

Gesamt-Score-Historie für diesen Standort, chronologisch, nur Werte ungleich null.

deltanumberoptional

Veränderung des Gesamt-Scores gegenüber dem vorherigen Bericht, oder null beim ersten Bericht oder falls es keinen vorherigen Monat gibt.

topIssueobjectoptional

Der schwächste Sichtbarkeitsfaktor dieses Standorts, oder null, falls noch kein Bericht vorliegt.

labelstringoptional

tonestring (good | warn | bad)optional

configuredEnginesarray of string (ChatGPT | Gemini | Perplexity)optional

KI-Engines, für die diese Agentur einen API-Schlüssel konfiguriert hat.

portfolioHistoryarray of objectoptional

Durchschnittlicher Gesamt-Score über die Standorte im Geltungsbereich, je Monat.

yearMonthstringoptional

Monat im Format YYYY-MM.

avgnumberoptional

Durchschnittlicher Gesamt-Score über die berichtenden Standorte in diesem Monat.

locationsnumberoptional

Anzahl der Standorte mit einem Bericht in diesem Monat (der Nenner des Durchschnitts).

systemicFixesarray of objectoptional

Standortübergreifende Schwächen, die von mehreren Standorten geteilt werden, jeweils mit einer einzigen Sammelmaßnahme, sortiert nach Reichweite.

factorstringoptional

Maschinenlesbare Faktor-Kennung.

labelstringoptional

Für Menschen lesbarer Faktorname.

detailstringoptional

Erläuterung der systemischen Schwäche.

Auf welchen Bereich des Produkts die Maßnahme verweist.

countnumberoptional

Anzahl der betroffenen Standorte.

pctnumberoptional

Prozentsatz der betroffenen berichtenden Standorte.

Fehler

401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.

403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.

429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.

get/api/v1/aeo/rollup

Ihr API-Schlüssel

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
      }
    ]
  }
}