SDKs

Node.js / TypeScript

Idiomatic Node.js patterns for the Thunderbit Open API

The Thunderbit API works with built-in fetch (Node 18+) — no SDK required. For HTTP/2 and connection pooling at scale, swap to undici or axios.

Configure

const API = "https://openapi.thunderbit.com/openapi/v1";
const H = {
  "Authorization": `Bearer ${process.env.THUNDERBIT_API_KEY}`,
  "Content-Type": "application/json",
};

Distill a page

const r = await fetch(`${API}/distill`, {
  method: "POST",
  headers: H,
  body: JSON.stringify({ url: "https://thunderbit.com/playground" }),
});
const { data } = await r.json();
console.log(data.markdown);

Extract structured data

type Product = { name: string; price: number; currency?: string };

const r = await fetch(`${API}/extract`, {
  method: "POST",
  headers: H,
  body: JSON.stringify({
    url: "https://example.com/product/iphone-15-pro",
    schema: {
      type: "object",
      properties: {
        name:  { type: "string" },
        price: { type: "number" },
      },
      required: ["name", "price"],
    },
  }),
});
const { data } = await r.json() as { data: Product };

Batch + webhook (TypeScript)

const job = await fetch(`${API}/batch/distill`, {
  method: "POST",
  headers: H,
  body: JSON.stringify({
    urls: ["https://example.com/page1", "https://example.com/page2"],
    webhook: {
      url:    "https://your-server.com/webhook",
      secret: process.env.WEBHOOK_SECRET,
    },
  }),
}).then(r => r.json());

Verify the webhook signature in your handler — see Webhooks.

An official Node.js SDK is in development — check back soon.