Thunderbit Open API home page
SupportoConsole API
Distill

Distilla Piu Pagine in Batch

POST
/batch/distill
Distilla Piu Pagine in Batch

Distilla piu pagine web simultaneamente con elaborazione asincrona.

Casi d'Uso:

  • Elaborare intere sezioni o categorie di siti web
  • Importazione batch di contenuti nella tua knowledge base
  • Migrazione di contenuti su larga scala
  • Aggiornamenti periodici di contenuti da piu fonti

Come Funziona:

  1. Invia un job batch con fino a 100 URL
  2. Ricevi immediatamente un ID job
  3. Interroga l'endpoint di stato o ricevi notifica webhook
  4. Recupera tutti i risultati al completamento

Funzionalita:

  • Elaborazione asincrona per alto throughput
  • Retry automatico in caso di errori
  • Notifiche webhook al completamento
  • Report dettagliato di stato ed errori per ogni URL

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 distillare, massimo 100

Esempio:
[
  "https://example.com/page1",
  "https://example.com/page2",
  "https://example.com/page3"
]
timeoutnumberpredefinito:30000

Timeout per richiesta in millisecondi, predefinito 30000

Intervallo richiesto:5000 <= x <= 60000
countryCodestringpredefinito:"US"

Codice paese ISO a 2 lettere per il geo-targeting, applicato a ogni URL (predefinito: US)

Esempio:US
renderModestringpredefinito:"none"

Modalità di rendering JavaScript applicata a ogni URL: none (predefinito), basic o full

Valore in"none" | "basic" | "full"
includeHtmlbooleanpredefinito:false

Se includere l'HTML originale per ogni URL (predefinito: false). Si preferisce il parametro include.

extractLinksbooleanpredefinito:false

Se estrarre i link per ogni URL (predefinito: false). Si preferisce il parametro include.

includestring[]

Campi opzionali da includere per ogni URL. Valori disponibili: metadata, html, links.

Esempio:
[
  "metadata",
  "links"
]
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

Esempio: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

Esempio:whsec_your_secret_key
headersobject

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

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

Risposta

application/json

Success response

successboolean
Esempio:
true
dataobject
Mostra attributi figli
idstring

ID del task batch

Esempio:batch_abc123
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)