Thunderbit Open API home page
SupportAPI-Konsole
Distill

Mehrere Seiten stapelweise destillieren

POST
/batch/distill
Mehrere Seiten stapelweise destillieren

Mehrere Webseiten gleichzeitig mit asynchroner Verarbeitung destillieren.

Anwendungsfälle:

  • Ganze Website-Bereiche oder Kategorien verarbeiten
  • Inhalte stapelweise in Ihre Wissensdatenbank importieren
  • Großangelegte Inhaltsmigration
  • Periodische Inhaltsaktualisierungen aus mehreren Quellen

So funktioniert es:

  1. Einen Stapelauftrag mit bis zu 100 URLs einreichen
  2. Sofort eine Auftrags-ID erhalten
  3. Den Status-Endpunkt abfragen oder Webhook-Benachrichtigung erhalten
  4. Alle Ergebnisse nach Abschluss abrufen

Funktionen:

  • Asynchrone Verarbeitung für hohen Durchsatz
  • Automatische Wiederholung bei Fehlern
  • Webhook-Benachrichtigungen bei Abschluss
  • Detaillierte Status- und Fehlerberichte pro URL

Autorisierung

YOUR_API_KEY
AutorisierungBearer <token>

Hol deinen API-Key aus dem Thunderbit Dashboard. Header-Format: Authorization: Bearer YOUR_API_KEY

In: header

Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

urls*string[]erforderlich

Liste der zu destillierenden URLs, maximal 100

Beispiel:
[
  "https://example.com/page1",
  "https://example.com/page2",
  "https://example.com/page3"
]
timeoutnumberStandard:30000

Timeout pro Anfrage in Millisekunden, Standard 30000

Erforderlicher Bereich:5000 <= x <= 60000
countryCodestringStandard:"US"

2-Buchstaben-ISO-Ländercode für Geo-Targeting, auf jede URL angewendet (Standard: US)

Beispiel:US
renderModestringStandard:"none"

JavaScript-Rendering-Modus, auf jede URL angewendet: none (Standard), basic oder full

Wert aus"none" | "basic" | "full"
includeHtmlbooleanStandard:false

Ob das Original-HTML für jede URL enthalten sein soll (Standard: false). Bevorzuge den Parameter include.

extractLinksbooleanStandard:false

Ob Links für jede URL extrahiert werden sollen (Standard: false). Bevorzuge den Parameter include.

includestring[]

Optionale Felder für jede URL. Mögliche Werte: metadata, html, links.

Beispiel:
[
  "metadata",
  "links"
]
webhookobject

Webhook-Callback-Konfiguration, benachrichtigt bei Auftragsabschluss. Siehe den Webhooks-Leitfaden für das Callback-Payload-Format, Header und HMAC-SHA256-Signaturverifizierung.

Untergeordnete Attribute anzeigen
urlstring

Webhook callback URL, must be HTTPS

Beispiel:https://your-server.com/api/webhook/distill
secretstring

HMAC-SHA256 secret for signature verification. When set, each webhook request includes an X-Webhook-Signature header

Beispiel:whsec_your_secret_key
headersobject

Custom headers (reserved for future use, not yet implemented by the server).

Beispiel:
{
  "X-Custom-Auth": "your-token"
}

Antwort

application/json

Success response

successboolean
Beispiel:
true
dataobject
Untergeordnete Attribute anzeigen
idstring

Stapelauftrags-ID

Beispiel:batch_abc123
statusstring
Wert aus"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "UNKNOWN"
Beispiel:PROCESSING
totalinteger
Beispiel:
3
completedinteger
Beispiel:
0
creditsUsedinteger
Beispiel:
0
createdAtstring

Timestamp when the job was created

completedAtstring

Timestamp when the job completed (null if still processing)