v1Ressourcen/AEO/postAEO-Berichtsgenerierung einreihen
AEO-Berichtsgenerierung einreihen
Startet eine Hintergrundgenerierung eines neuen AEO-Berichts für einen Standort. Die Berichtsgenerierung führt mehrere LLM-Aufrufe je Engine/Prompt aus und läuft nie synchron innerhalb der Anfrage — dieser Aufruf reiht den Job ein und kehrt sofort zurück. Es gibt keine separate Job-ID oder Statusressource: Fragen Sie GET /api/v1/aeo/reports für denselben Standort per Polling ab und beobachten Sie das Feld generating, bis es wieder false liefert. Nicht verfügbar für Standorte, die älter sind als Synups Legacy-Standort-Cache (rein native Standorte).
post
aeo:write/api/v1/aeo/reports/enqueueAnfragetext
locationIdstringerforderlich
Der Standort, für den ein Bericht generiert werden soll.
clientIdstringoptional
Der Kunde des Standorts.
forcebooleanoptional
Bei true wird eine neue Generierung gestartet, auch wenn diesen Monat bereits ein Bericht generiert wurde.
Antwort
dataobjectoptional
enqueuedbooleanoptional
Immer true — der Generierungsjob wurde eingereiht.
forcebooleanoptional
Gibt das force-Flag aus der Anfrage zurück.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
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.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/aeo/reports/enqueue
Ihr API-Schlüssel
Anfragetext*
{
"data": {
"enqueued": true,
"force": false
}
}Anleitungen, die diesen Endpunkt verwenden
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- What Is an AEO API?An AEO API measures how AI answer engines like ChatGPT, Gemini and Perplexity describe and recommend a business, and tracks that visibility over time.
- How to Build an AI Agent for Local SEOBuild an AI agent that audits and fixes listings, tracks local rankings, checks AI visibility and drafts review replies with Synup's MCP server or REST tools.
- How to Track AI and AEO Visibility ProgrammaticallyMeasure how ChatGPT, Gemini and Perplexity describe and recommend a business through an API, enqueue reports, poll for results and roll up a portfolio.