Thunderbit Open API home page
SupportoConsole API
Extract

Estrai Piu Pagine in Batch

POST
/batch/extract
Estrai Piu Pagine in Batch

Estrai dati strutturati da piu URL simultaneamente utilizzando l'IA.

Casi d'Uso:

  • Estrarre cataloghi prodotti da piu pagine
  • Estrarre dati da pagine di risultati di ricerca
  • Elaborare in batch listing o pagine directory
  • Raccogliere intelligence competitiva su larga scala

Come Funziona:

  1. Invia fino a 50 URL con un singolo schema
  2. Ottieni risposta immediata con ID job
  3. Tutti gli URL vengono estratti usando lo stesso schema
  4. Interroga lo stato o ricevi notifica webhook
  5. Recupera tutti i risultati strutturati insieme

Funzionalita:

  • Stesso schema applicato a tutti gli URL
  • Elaborazione parallela per velocita
  • Gestione errori individuale per URL
  • Notifiche webhook disponibili

Autorizzazione

YOUR_API_KEY
AutorizzazioneBearer <token>

Ottieni la tua API key dal Thunderbit Dashboard. Formato header: Authorization: Bearer YOUR_API_KEY

In: header

Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

urls*string[]obbligatorio

Lista di URL da cui estrarre i dati, massimo 50

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

Definizione della struttura dati in formato JSON Schema

Esempio:
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "rating": {
      "type": "number"
    }
  }
}
timeoutnumberpredefinito:60000

Timeout per richiesta in millisecondi, predefinito 30000

webhookobject

Configurazione callback webhook, notifica al completamento del task. Consulta la guida Webhooks per il formato del payload di callback, gli header e la verifica della firma HMAC-SHA256.

Mostra attributi figli
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

Esempio:whsec_your_secret_key
headersobject

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

Esempio:
{
  "X-Custom-Auth": "your-token"
}
renderModestringpredefinito:"none"

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

Valore in"none" | "basic" | "full"

Risposta

application/json

Success response

successboolean
Esempio:
true
dataobject
Mostra attributi figli
idstring
Esempio:batch_ext_xyz789
statusstring
Valore in"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "UNKNOWN"
Esempio:PROCESSING
totalinteger
Esempio:
3
completedinteger
Esempio:
0
creditsUsedinteger
Esempio:
0
createdAtstring

Timestamp when the job was created

completedAtstring

Timestamp when the job completed (null if still processing)