> ## Documentation Index
> Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Generar un informe de propuesta

> Crea un informe de cliente potencial que puedas compartir a partir de la URL de un sitio web y consulta después los resultados.

Usa una clave de API global de la organización con acceso de administrador. Tu organización necesita
acceso al espacio de propuestas y propuestas disponibles en su cuota.

## 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.

```bash theme={null}
curl --request POST 'https://api.athenahq.ai/api/v1/pitches' \
  --header "x-api-key: $ATHENA_API_KEY" \
  --header 'Idempotency-Key: prospect-example-september-2026' \
  --header 'Content-Type: application/json' \
  --data '{"website_url":"https://example.com"}'
```

```json theme={null}
{
  "pitch_id": "600d2cf4-3419-4eaa-a077-e94c46c26939",
  "status": "processing",
  "report_url": "https://app.athenahq.ai/report/600d2cf4-3419-4eaa-a077-e94c46c26939"
}
```

La respuesta es `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

```bash theme={null}
curl 'https://api.athenahq.ai/api/v1/pitches/600d2cf4-3419-4eaa-a077-e94c46c26939' \
  --header "x-api-key: $ATHENA_API_KEY"
```

Consulta el estado cada 10 segundos y comprueba **`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-After` en las respuestas `429`.
* Ante un `500` temporal, 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.

Consulta [Crear un informe de propuesta](https://docs.athenahq.ai/es/api-reference/pitch-workspace/create-a-pitch-report.md)
para ver el esquema completo de solicitud y respuesta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.