Thunderbit Open API home page
SupportConsole API
Distill

Distillation par Lots de Plusieurs Pages

POST
/batch/distill
Distillation par Lots de Plusieurs Pages

Distillez plusieurs pages web simultanément avec un traitement asynchrone.

Cas d'Utilisation :

  • Traiter des sections ou catégories entières de sites web
  • Importer du contenu en masse dans votre base de connaissances
  • Migration de contenu à grande échelle
  • Mises à jour périodiques de contenu depuis plusieurs sources

Comment Ça Fonctionne :

  1. Soumettez une tâche par lots avec jusqu'à 100 URLs
  2. Recevez immédiatement un ID de tâche
  3. Interrogez l'endpoint de statut ou recevez une notification webhook
  4. Récupérez tous les résultats une fois terminé

Fonctionnalités :

  • Traitement asynchrone pour un haut débit
  • Réessai automatique en cas d'échec
  • Notifications webhook à la fin
  • Rapports détaillés de statut et d'erreurs par URL

Autorisation

YOUR_API_KEY
AutorisationBearer <token>

Récupère ta clé API depuis le Thunderbit Dashboard. Format d'en-tête : Authorization: Bearer YOUR_API_KEY

Dans: header

Corps

application/json

TypeScript Definitions

Use the request body type in TypeScript.

urls*string[]requis

Liste des URLs à distiller, maximum 100

Exemple :
[
  "https://example.com/page1",
  "https://example.com/page2",
  "https://example.com/page3"
]
timeoutnumberdéfaut :30000

Délai d'expiration par requête en millisecondes, par défaut 30000

Plage requise :5000 <= x <= 60000
countryCodestringdéfaut :"US"

Code pays ISO à 2 lettres pour le ciblage géographique, appliqué à chaque URL (par défaut : US)

Exemple :US
renderModestringdéfaut :"none"

Mode de rendu JavaScript appliqué à chaque URL : none (par défaut), basic ou full

Valeur dans"none" | "basic" | "full"
includeHtmlbooleandéfaut :false

Indique si le HTML original doit être inclus pour chaque URL (par défaut : false). Préférer le paramètre include.

extractLinksbooleandéfaut :false

Indique si les liens doivent être extraits pour chaque URL (par défaut : false). Préférer le paramètre include.

includestring[]

Champs optionnels à inclure pour chaque URL. Valeurs disponibles : metadata, html, links.

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

Configuration du callback webhook, notifie lorsque la tâche est terminée. Consultez le guide Webhooks pour le format du payload de callback, les en-têtes et la vérification de signature HMAC-SHA256.

Afficher les attributs enfants
urlstring

Webhook callback URL, must be HTTPS

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

Exemple :whsec_your_secret_key
headersobject

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

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

Réponse

application/json

Success response

successboolean
Exemple :
true
dataobject
Afficher les attributs enfants
idstring

ID de la tâche par lots

Exemple :batch_abc123
statusstring
Valeur dans"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "UNKNOWN"
Exemple :PROCESSING
totalinteger
Exemple :
3
completedinteger
Exemple :
0
creditsUsedinteger
Exemple :
0
createdAtstring

Timestamp when the job was created

completedAtstring

Timestamp when the job completed (null if still processing)