Crear
Elige una clave de solicitud por informe. Conserva la misma clave cuando reintentes una solicitud tras un tiempo de espera agotado o un error temporal.202 Accepted. Solo se requiere website_url. Los valores predeterminados de los campos opcionales
country y language son United States y English.
La investigación prepara el perfil de empresa, los competidores y las consultas antes de que se ejecute
el informe estándar del espacio de propuestas. Al principio, un informe en procesamiento puede mostrar
el dominio enviado y resultados vacíos.
Los informes investigan 20 consultas y consultan ChatGPT, Perplexity, Gemini y Copilot.
El informe muestra los 11 modelos compatibles y destaca los que tienen resultados.
Consultar el estado
pitch.status en la respuesta de detalle
existente. Detente cuando sea completed o failed. Los informes completados incluyen competidores,
consultas, fuentes, atributos y métricas.
Comparte report_url cuando se complete. Cualquier persona con ese enlace puede ver el informe.
La creación no envía correos electrónicos; tu aplicación decide cuándo y cómo entregarlo.
Reintentos y cuota
- Cada informe admitido consume una propuesta, incluso si su investigación o generación falla después. Las organizaciones ilimitadas no consumen una cuota finita.
- Reintentar con la misma clave y los mismos datos normalizados devuelve el mismo informe sin
un segundo cargo. Un cuerpo distinto con la misma clave devuelve
409. - Una clave nueva solicita un informe nuevo, incluso para el mismo sitio web.
- La creación permite tres informes de API simultáneos por organización y 10 solicitudes
por minuto. Respeta
Retry-Afteren las respuestas429. - Ante un
500temporal, reintenta con la misma clave de solicitud. No cambies de clave para sortear un error de facturación. Una operación de facturación sin resolver puede requerir que soporte la concilie; su cuota reservada permanece retenida para evitar un consumo duplicado.