Private beta. Distill is callable today with your normal API key, on every plan including Founding, and it draws on your monthly ops allowance like any other call. It is not announced or generally available: the request and response shapes can change without notice, and there is no stability or support commitment, so do not build anything load-bearing on it yet. The roadmap is on
Coming Soon, and every release is announced in
the changelog.
`POST /v2/distill` is an API to extract structured data from websites: it
pulls fields out of one or more URLs to match a schema you supply, either
a JSON-Schema object or a flat `{field: description}` map. It runs a
two-pass engine: a free CSS pass first (Crawl4AI's
`JsonCssExtractionStrategy` driven by your selectors), then a capped LLM
pass for the fields the CSS pass left empty. The response `data` is
guaranteed to come back in the exact shape
you asked for. It will be EnConvert's answer to Firecrawl `/extract`.
Here is the smallest useful call. Send one URL and a flat
`{field: description}` schema, and get the extracted fields back:
```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"
}
}'
```
The response carries one result per URL, the extracted `data`, and which
tier produced it:
```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
| Method | Path | Purpose |
|--------|------|---------|
| `POST` | `/v2/distill` | Distill an explicit URL list, or discover a site's URLs first and distill each, against one schema. |
**Content-Type:** `application/json`.
Unlike [perceive](/docs/endpoints/perceive.md), distill is a single synchronous
endpoint: there is no separate GET re-fetch or async batch path. Every
URL renders sequentially through the shared headless Chrome singleton and
the full result set comes back in one response.
---
## Authentication
Authenticate with a private key in the `X-API-Key` header for
server-to-server calls. This is the path the examples below use.
```http
X-API-Key: sk_your_private_key
```
Public keys with a JWT bearer token also work, using the same flow as
every other endpoint: generate a token with your `pk_` key, then send it
as `Authorization: Bearer