v1Recursos/AEO/postEnfileirar a geração de relatório AEO
Enfileirar a geração de relatório AEO
Inicia uma geração em segundo plano de um novo relatório AEO para um local. A geração do relatório executa múltiplas chamadas de LLM por motor/prompt e nunca é executada de forma síncrona durante a requisição — esta chamada enfileira o job e retorna imediatamente. Não há um recurso separado de id de job ou status: consulte GET /api/v1/aeo/reports para o mesmo local e observe o campo generating até que volte a false. Não disponível para locais anteriores ao cache legado de locais do Synup (locais somente nativos).
post
aeo:write/api/v1/aeo/reports/enqueueCorpo da solicitação
locationIdstringobrigatório
O local para o qual gerar um relatório.
clientIdstringopcional
O cliente do local.
forcebooleanopcional
Quando true, inicia uma nova geração mesmo que um relatório já tenha sido gerado neste mês.
Resposta
dataobjectopcional
enqueuedbooleanopcional
Sempre true — o job de geração foi enfileirado.
forcebooleanopcional
Repete a flag force da solicitação.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/aeo/reports/enqueue
Sua chave de API
Corpo da solicitação*
{
"data": {
"enqueued": true,
"force": false
}
}Guias que usam este endpoint
- 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.