Quickstart

Récupère ta clé API

Inscris-toi et récupère ton API Key pour commencer à utiliser Thunderbit.

Essaie dans le Playground

Teste l'API instantanément sans écrire une ligne de code.

Authentification

Toutes les requêtes API exigent une API Key dans le Header de la requête :

Authorization: Bearer YOUR_API_KEY

Récupère ta clé depuis le Dashboard Thunderbit. Les clés sont révocables et propres à chaque environnement — n'intègre jamais une clé de production dans du code côté client.

1. Distill une page en 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. Extract des données structurées avec un 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. Soumettre une tâche batch avec un callback Webhook

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"
    }
  }'