Quickstart

Haal je API Key op

Meld je aan en pak je API Key om Thunderbit te gaan gebruiken.

Probeer het in de Playground

Test de API direct zonder ook maar één regel code te schrijven.

Authenticatie

Alle API-requests vereisen een API Key in de request-Header:

Authorization: Bearer YOUR_API_KEY

Haal je API Key op vanuit het Thunderbit Dashboard. Keys zijn intrekbaar en per omgeving — sluit nooit een productiekey in clientcode in.

1. Distill een enkele pagina naar Markdown

cURL:

curl -X POST https://openapi.thunderbit.com/openapi/v1/distill \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://thunderbit.com/playground"}'

Python:

import httpx

resp = httpx.post(
    "https://openapi.thunderbit.com/openapi/v1/distill",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"url": "https://thunderbit.com/playground"},
    timeout=60.0,
)
resp.raise_for_status()
print(resp.json()["data"]["markdown"])

Node.js:

const r = await fetch("https://openapi.thunderbit.com/openapi/v1/distill", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://thunderbit.com/playground" }),
});
const { data } = await r.json();
console.log(data.markdown);

2. Haal gestructureerde data op met een JSON Schema

curl -X POST https://openapi.thunderbit.com/openapi/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/iphone-15-pro",
    "schema": {
      "type": "object",
      "properties": {
        "name":     { "type": "string" },
        "price":    { "type": "number" },
        "currency": { "type": "string" },
        "inStock":  { "type": "boolean" }
      },
      "required": ["name", "price"]
    }
  }'

3. Dien een batchtaak in met een Webhook-callback

curl -X POST https://openapi.thunderbit.com/openapi/v1/batch/distill \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://example.com/page1",
      "https://example.com/page2",
      "https://example.com/page3"
    ],
    "webhook": {
      "url": "https://your-server.com/api/webhook/distill",
      "secret": "whsec_your_secret_key"
    }
  }'