Private Beta. Distill ist heute mit deinem normalen API-Schlüssel aufrufbar, in jedem Tarif einschließlich Founding, und zieht wie jeder andere Aufruf von deinem monatlichen Ops-Kontingent ab. Angekündigt oder allgemein verfügbar ist Distill nicht: Request- und Response-Formen können sich jederzeit ohne Vorankündigung ändern, und es gibt keine Stabilitäts- oder Supportzusage, baue also noch nichts Tragendes darauf. Die Roadmap steht unter
Demnächst, und jedes Release wird im
Changelog angekündigt.
`POST /v2/distill` ist eine API, um strukturierte Daten aus Websites zu
extrahieren: Sie zieht Felder aus einer oder mehreren URLs heraus, passend
zu einem von dir gelieferten Schema, entweder einem JSON-Schema-Objekt
oder einer flachen `{field: description}`-Map. Sie läuft als
Zwei-Pass-Engine: zuerst ein kostenloser CSS-Pass (Crawl4AIs
`JsonCssExtractionStrategy`, gesteuert von deinen Selektoren), dann ein
gedeckelter, LLM-gestützter Pass für die Felder, die der CSS-Pass leer
gelassen hat. Das `data`-Feld der Antwort kommt
garantiert exakt in der angeforderten Form zurück. Es wird EnConverts
Antwort auf Firecrawl `/extract` sein.
Hier der kleinste nützliche Aufruf. Sende eine URL und ein flaches
`{field: description}`-Schema und erhalte die extrahierten Felder zurück:
```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"
}
}'
```
Die Antwort enthält ein Ergebnis pro URL, die extrahierten `data` und
welche Stufe sie geliefert hat:
```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": []
}
```
---
## Endpunkte
| Methode | Pfad | Zweck |
|--------|------|---------|
| `POST` | `/v2/distill` | Führt distill für eine explizite URL-Liste aus, oder ermittelt zunächst mit discover die URLs einer Site und führt distill für jede aus, jeweils gegen ein Schema. |
**Content-Type:** `application/json`.
Anders als [perceive](/de/docs/endpoints/perceive.md) ist distill ein einzelner
synchroner Endpunkt: Es gibt keinen separaten GET-Re-Fetch oder
asynchronen Batch-Pfad. Jede URL wird sequenziell über das gemeinsam
genutzte Headless-Chrome-Singleton gerendert, und die vollständige
Ergebnismenge kommt in einer einzigen Antwort zurück.
---
## Authentifizierung
Authentifiziere dich mit einem privaten Schlüssel im `X-API-Key`-Header
für Server-zu-Server-Aufrufe. Diesen Weg verwenden die folgenden
Beispiele.
```http
X-API-Key: sk_your_private_key
```
Öffentliche Schlüssel mit einem JWT-Bearer-Token funktionieren ebenfalls,
nach demselben Ablauf wie bei jedem anderen Endpunkt: Erzeuge ein Token
mit deinem `pk_`-Schlüssel und sende es als `Authorization: Bearer