Bêta privée. Distill est appelable dès aujourd'hui avec votre clé d'API habituelle, sur tous les forfaits y compris Founding, et décompte votre quota mensuel d'ops comme n'importe quel autre appel. Ce n'est ni annoncé ni disponible de façon générale : les formes de requête et de réponse peuvent changer sans préavis, et il n'y a aucun engagement de stabilité ni de support, donc ne construisez rien de critique dessus pour l'instant. La feuille de route est sur
Bientôt disponible, et chaque publication est annoncée dans
le changelog.
`POST /v2/distill` est une API pour extraire des données structurées de sites
web : elle récupère des champs à partir d'une ou plusieurs URLs pour
correspondre à un schéma que vous fournissez, soit un objet JSON-Schema, soit
une carte plate `{field: description}`. Elle exécute un moteur à deux passes :
d'abord une passe CSS gratuite (le `JsonCssExtractionStrategy` de Crawl4AI
piloté par vos sélecteurs), puis une passe plafonnée assistée par LLM
pour les champs que la passe CSS a laissés vides. La réponse `data`
est garantie de revenir dans la forme exacte que vous avez demandée.
Ce sera la réponse d'EnConvert à `/extract` de Firecrawl.
Voici le plus petit appel utile. Envoyez une URL et un schéma plat
`{field: description}`, et récupérez les champs extraits :
```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 réponse contient un résultat par URL, les `data` extraites, et quel
niveau les a produites :
```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": []
}
```
---
## Points de terminaison
| Method | Path | Purpose |
|--------|------|---------|
| `POST` | `/v2/distill` | Distille une liste explicite d'URLs, ou découvre d'abord les URLs d'un site puis distille chacune, selon un schéma unique. |
**Content-Type :** `application/json`.
Contrairement à [perceive](/fr/docs/endpoints/perceive.md), distill est un unique
endpoint synchrone : il n'y a pas de re-fetch GET séparé ni de chemin batch
asynchrone. Chaque URL se rend séquentiellement via le singleton Chrome
headless partagé et l'ensemble complet des résultats revient dans une
seule réponse.
---
## Authentification
Authentifiez-vous avec une clé privée dans l'en-tête `X-API-Key` pour les
appels serveur à serveur. C'est le chemin qu'utilisent les exemples
ci-dessous.
```http
X-API-Key: sk_your_private_key
```
Les clés publiques avec un jeton bearer JWT fonctionnent aussi, en suivant
le même flux que tous les autres endpoints : générez un jeton avec votre
clé `pk_`, puis envoyez-le en tant que `Authorization: Bearer