Beta privada. Distill 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/distill` es una API para extraer datos estructurados de sitios
web: extrae campos de una o más URLs para que coincidan con un esquema
que tú proporcionas, ya sea un objeto JSON-Schema o un mapa plano
`{field: description}`. Ejecuta un motor de dos pasadas: primero una
pasada CSS gratuita (`JsonCssExtractionStrategy` de Crawl4AI, controlada
por tus selectores), y luego una pasada limitada asistida por LLM
para los campos que la pasada CSS dejó vacíos. La respuesta `data`
está garantizada a devolverse exactamente
en la forma que pediste. Será la respuesta de EnConvert a `/extract` de
Firecrawl.
Aquí tienes la llamada útil más pequeña. Envía una URL y un esquema plano
`{field: description}`, y recibe de vuelta los campos extraídos:
```bash
curl -X POST https://api.enconvert.com/v2/distill \
-H "X-API-Key: sk_your_private_key" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://example.com/product/widget"],
"schema": {
"name": "the product name",
"price": "the listed price",
"in_stock": "whether it is in stock"
}
}'
```
La respuesta trae un resultado por URL, los `data` extraídos, y qué nivel
los produjo:
```json
{
"operation_id": "dst_3f9a2c1b8e7d4a6f90b1c2d3e4f5a6b7",
"total": 1,
"completed": 1,
"failed": 0,
"results": [
{
"url": "https://example.com/product/widget",
"url_final": "https://example.com/product/widget",
"status": "completed",
"data": {
"name": "Widget Pro",
"price": "$49.00",
"in_stock": "yes"
},
"extraction_tier": "llm",
"fields_from_css": 0,
"fields_from_llm": 3,
"render_quality": 0.91,
"tokens": {"input": 4120, "output": 38},
"cost_cents": 0.45,
"warnings": []
}
],
"total_cost_cents": 0.45,
"warnings": []
}
```
---
## Endpoints
| Método | Ruta | Propósito |
|--------|------|---------|
| `POST` | `/v2/distill` | Ejecuta distill sobre una lista explícita de URLs, o usa discover para descubrir primero las URLs de un sitio y aplica distill a cada una, contra el mismo esquema. |
**Content-Type:** `application/json`.
A diferencia de [perceive](/es/docs/endpoints/perceive.md), distill es un único
endpoint síncrono: no hay una ruta separada de reobtención GET ni un
camino asíncrono por lotes. Cada URL se renderiza secuencialmente a
través del singleton compartido de Chrome headless y el conjunto
completo de resultados vuelve en una sola respuesta.
---
## Autenticación
Autentícate con una clave privada en el encabezado `X-API-Key` para
llamadas servidor a servidor. Este es el camino que usan los ejemplos de
abajo.
```http
X-API-Key: sk_your_private_key
```
Las claves públicas con un token bearer JWT también funcionan, usando el
mismo flujo que cualquier otro endpoint: genera un token con tu clave
`pk_`, y luego envíalo como `Authorization: Bearer