Forfaits payants uniquement. Distill est disponible de façon générale et exige un forfait payant ; sur l'offre gratuite, la requête est rejetée avec
402. Il entame votre quota mensuel d'ops comme n'importe quel autre appel, une op par URL aboutie, et la passe LLM dépense des crédits IA mensuels plutôt que des ops. Voir
les tarifs.
`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.
C'est 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