Beta privada. Discover ya se puede llamar hoy con tu clave de API habitual, en cualquier plan incluido Founding, y descuenta de tu cuota mensual de ops igual que cualquier otra llamada. No está anunciado ni disponible de forma general: las formas de la solicitud y de la respuesta pueden cambiar sin avisar, y no hay ningún compromiso de estabilidad ni de soporte, así que todavía no montes nada crítico encima. La hoja de ruta está en
Próximamente, y cada versión se anuncia en
el changelog.
`POST /v2/discover` es una API de rastreo de sitemaps que lista las URLs
de un sitio web de la forma económica: un rastreo que prioriza HTTP más
el análisis del sitemap, con un fallback opcional de renderizado de
JavaScript para aplicaciones de una sola página (SPA). No hay captura de
pantalla, ni PDF, ni artefacto almacenado. Devuelve una lista plana y sin
duplicados de URLs junto con un recuento de la procedencia de cada
una, de forma síncrona en una sola llamada. Será la primitiva ligera
para "mapear el sitio": apúntala a un dominio, obtén de vuelta las
páginas que vale la pena procesar y luego pasa esa lista a
[el endpoint perceive](/es/docs/endpoints/perceive.md) o a un trabajo de ingesta en
modo crawl.
Aquí está la llamada mínima útil. Envía una URL, obtén su mapa de vuelta:
```bash
curl -X POST https://api.enconvert.com/v2/discover \
-H "X-API-Key: sk_your_private_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com"
}'
```
La respuesta es una lista plana de URLs con contadores de procedencia:
sin URLs firmadas, sin ID de operación, sin sondeo:
```json
{
"url": "https://example.com",
"mode": "hybrid",
"total": 47,
"urls": [
"https://example.com/",
"https://example.com/pricing",
"https://example.com/docs",
"https://example.com/blog/launch"
],
"pages_crawled": 12,
"truncated": false,
"robots_respected": false,
"sources": {"sitemap": 42, "crawl": 30},
"warnings": []
}
```
---
## Endpoints
| Método | Ruta | Propósito |
|--------|------|---------|
| `POST` | `/v2/discover` | Mapea las URLs de un sitio solo por HTTP y devuelve una lista plana con recuentos por fuente. |
`/v2/discover` expone una única ruta. No tiene estado: no hay una fila
de operación que volver a consultar ni un trabajo que sondear, así que
no existe un endpoint `GET` complementario como sí
[lo tiene perceive](/es/docs/endpoints/perceive.md).
**Content-Type:** `application/json` en el `POST`.
---
## Autenticación
Autentícate con una clave privada en el encabezado `X-API-Key` para
llamadas de servidor a servidor. Este es el método que usan los
ejemplos siguientes.
```http
X-API-Key: sk_your_private_key
```
Las claves públicas con un token JWT bearer también funcionan, usando
el mismo flujo que el resto de los endpoints: genera un token con tu
clave `pk_` y luego envíalo como `Authorization: Bearer