Beta privata. Distill è già chiamabile oggi con la tua normale chiave API, su qualsiasi piano compreso Founding, e scala dalla tua quota mensile di ops come ogni altra chiamata. Non è annunciato né disponibile in generale: le forme di richiesta e risposta possono cambiare senza preavviso e non c'è alcun impegno di stabilità o di supporto, quindi non costruirci ancora sopra nulla di critico. La roadmap è su
In arrivo, e ogni rilascio viene annunciato nel
changelog.
`POST /v2/distill` è un'API per estrarre dati strutturati dai siti web:
estrae campi da uno o più URL per farli corrispondere a uno schema che
fornisci tu, cioè un oggetto JSON-Schema oppure una mappa piatta
`{field: description}`. Funziona con un motore a due passate: prima una
passata CSS gratuita (la `JsonCssExtractionStrategy` di Crawl4AI, guidata
dai tuoi selettori), poi una passata assistita da LLM, limitata, per i
campi che la passata CSS ha lasciato vuoti. Il campo `data` della
risposta è garantito tornare esattamente
nella forma richiesta. Sarà la risposta di EnConvert a `/extract` di
Firecrawl.
Ecco la chiamata utile più semplice. Invia un URL e uno schema piatto
`{field: description}` e ricevi indietro i campi estratti:
```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 risposta contiene un risultato per URL, i dati estratti (`data`) e
quale livello li ha prodotti:
```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": []
}
```
---
## Endpoint
| Metodo | Percorso | Scopo |
|--------|------|---------|
| `POST` | `/v2/distill` | Distilla un elenco esplicito di URL, oppure scopri prima gli URL di un sito e distilla ciascuno, rispetto a uno schema. |
**Content-Type:** `application/json`.
A differenza di [perceive](/it/docs/endpoints/perceive.md), distill è un endpoint
sincrono singolo: non esiste un percorso separato di ri-fetch GET o di
batch asincrono. Ogni URL viene renderizzato in sequenza tramite il
singleton condiviso di Chrome headless e l'intero set di risultati torna
in un'unica risposta.
---
## Autenticazione
Autenticati con una chiave privata nell'header `X-API-Key` per le
chiamate server-to-server. Questo è il percorso usato negli esempi
seguenti.
```http
X-API-Key: sk_your_private_key
```
Funzionano anche le chiavi pubbliche con un token bearer JWT, seguendo lo
stesso flusso di ogni altro endpoint: genera un token con la tua chiave
`pk_`, poi invialo come `Authorization: Bearer