Thunderbit Open API home page
SupportConsole API
Extract

Extraction par Lots de Plusieurs Pages

POST
/batch/extract
Extraction par Lots de Plusieurs Pages

Extrayez des données structurées à partir de plusieurs URLs simultanément en utilisant l'IA.

Cas d'Utilisation :

  • Scraper des catalogues de produits depuis plusieurs pages
  • Extraire des données depuis des pages de résultats de recherche
  • Traiter par lots des listings ou pages d'annuaire
  • Collecter de la veille concurrentielle à grande échelle

Comment Ça Fonctionne :

  1. Soumettez jusqu'à 50 URLs avec un schéma unique
  2. Obtenez une réponse immédiate avec l'ID de tâche
  3. Toutes les URLs sont extraites en utilisant le même schéma
  4. Interrogez le statut ou recevez une notification webhook
  5. Récupérez tous les résultats structurés en une fois

Fonctionnalités :

  • Même schéma appliqué à toutes les URLs
  • Traitement parallèle pour la rapidité
  • Gestion individuelle des erreurs par URL
  • Notifications webhook disponibles

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 à partir desquelles extraire les données, maximum 50

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

Définition de la structure de données au format schéma JSON

Exemple :
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "rating": {
      "type": "number"
    }
  }
}
timeoutnumberdéfaut :60000

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

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

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"
}
renderModestringdéfaut :"none"

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

Valeur dans"none" | "basic" | "full"

Réponse

application/json

Success response

successboolean
Exemple :
true
dataobject
Afficher les attributs enfants
idstring
Exemple :batch_ext_xyz789
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)