POST
/batch/extract
Mehrere Seiten stapelweise extrahieren

Strukturierte Daten aus mehreren URLs gleichzeitig mithilfe von KI extrahieren.

Anwendungsfälle:

  • Produktkataloge von mehreren Seiten scrapen
  • Daten aus Suchergebnisseiten extrahieren
  • Listings oder Verzeichnisseiten stapelweise verarbeiten
  • Wettbewerbsinformationen im großen Maßstab sammeln

So funktioniert es:

  1. Bis zu 50 URLs mit einem einzelnen Schema einreichen
  2. Sofort Auftrags-ID als Antwort erhalten
  3. Alle URLs werden mit demselben Schema extrahiert
  4. Status abfragen oder Webhook-Benachrichtigung erhalten
  5. Alle strukturierten Ergebnisse auf einmal abrufen

Funktionen:

  • Gleiches Schema für alle URLs angewendet
  • Parallele Verarbeitung für Geschwindigkeit
  • Individuelle Fehlerbehandlung pro URL
  • Webhook-Benachrichtigungen verfügbar

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 URLs, aus denen Daten extrahiert werden sollen, maximal 50

Beispiel:
[
  "https://example.com/product/1",
  "https://example.com/product/2",
  "https://example.com/product/3"
]
schema*objecterforderlich

Datenstrukturdefinition im JSON-Schema-Format

Beispiel:
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "rating": {
      "type": "number"
    }
  }
}
timeoutnumberStandard:60000

Timeout pro Anfrage in Millisekunden, Standard 30000

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

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"
}
renderModestringStandard:"none"

JavaScript rendering mode applied to every URL: none (default, fastest), basic, or full.

Wert aus"none" | "basic" | "full"

Antwort

application/json

Success response

successboolean
Beispiel:
true
dataobject
Untergeordnete Attribute anzeigen
idstring
Beispiel:batch_ext_xyz789
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)