v1Ressourcen/AEO/getEine Prompt-Prüfung abrufen
Eine Prompt-Prüfung abrufen
Liefert eine Prüfung mit dem genauen Wortlaut, den sie bei ihrer Zulassung erfasst hat, und jeder aufgezeichneten Antwort, gelesen aus der Prüfung selbst statt aus den heutigen Prompts. Ein archivierter Altbericht liefert stattdessen seine Ergebnisse pro Keyword in legacyResults und seine Scores pro Engine in legacyEngines. Nur lesend. Eine Prüfung, die nicht zu dieser Website gehört, liefert 404.
get
aeo:read/api/v1/aeo/prompts/checks/{checkId}Query-Parameter
checkIdstringerforderlich
Die ID der Prüfung, aus der Prüfungsliste oder dem Verlauf eines Prompts.
locationIdstringerforderlich
Die Standort-ID der Website-Entität. Eine Website, die Sie nicht sehen können oder die nicht existiert, liefert 404; ein physischer Standort liefert 422 entity_type_not_supported.
Antwort
dataobjectoptional
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.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
503Der Dienst ist vorübergehend nicht verfügbar. Befolgen Sie die Hinweise zur Wiederholung für diesen Vorgang.
get/api/v1/aeo/prompts/checks/{checkId}
Ihr API-Schlüssel
checkId *
locationId *
{}Anleitungen, die diese Ressource verwenden
- What Is a Local SEO API?A local SEO API measures how a business ranks in local search, with geo-grid rank tracking, profile analytics and AI visibility, not just backlinks.
- 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 Build a Multi-Location Marketing DashboardBuild a multi-location marketing dashboard from the API's rollup endpoints, one call per panel, covering listings, reviews, rank, AI visibility and duplicates.
- Local SEO APIs: What Developers Actually NeedA practical checklist of what a local SEO API must cover, from listings and sync status to reviews, rank tracking and AI visibility, mapped to endpoints.
- How to Monitor Local SEO Across Multiple LocationsMonitor local SEO across hundreds of locations through rollup endpoints, with rank and AI visibility per location and the weakest surfaced first.
- 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.