v1Recursos/AEO/postEncolar la generación de un informe AEO
Encolar la generación de un informe AEO
Inicia la generación en segundo plano de un nuevo informe AEO para una ubicación. La generación del informe ejecuta varias llamadas a LLM por motor/prompt y nunca se ejecuta de forma síncrona dentro de la solicitud — esta llamada encola el trabajo y regresa de inmediato. No existe un recurso independiente de job-id o estado: sondea GET /api/v1/aeo/reports para la misma ubicación y observa el campo generating hasta que vuelva a false. No está disponible para ubicaciones anteriores a la caché de ubicaciones heredada de Synup (ubicaciones solo nativas).
post
aeo:write/api/v1/aeo/reports/enqueueCuerpo de la solicitud
locationIdstringobligatorio
La ubicación para la que generar un informe.
clientIdstringopcional
El cliente de la ubicación.
forcebooleanopcional
Cuando es true, inicia una nueva generación aunque ya se haya generado un informe este mes.
Respuesta
dataobjectopcional
enqueuedbooleanopcional
Siempre true — se encoló el trabajo de generación.
forcebooleanopcional
Repite el indicador force de la solicitud.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
post/api/v1/aeo/reports/enqueue
Su clave de API
Cuerpo de la solicitud*
{
"data": {
"enqueued": true,
"force": false
}
}Guías que usan 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.