Thunderbit Open API home page
SoporteConsola API
Extract

Extraer Múltiples Páginas por Lotes

POST
/batch/extract
Extraer Múltiples Páginas por Lotes

Extrae datos estructurados de múltiples URLs simultáneamente usando IA.

Casos de Uso:

  • Extraer catálogos de productos de múltiples páginas
  • Extraer datos de páginas de resultados de búsqueda
  • Procesar por lotes listados o páginas de directorios
  • Recopilar inteligencia competitiva a escala

Cómo Funciona:

  1. Envía hasta 50 URLs con un solo esquema
  2. Obtén respuesta inmediata con ID de trabajo
  3. Todas las URLs se extraen usando el mismo esquema
  4. Consulta el estado o recibe notificación por webhook
  5. Recupera todos los resultados estructurados de una vez

Características:

  • Mismo esquema aplicado a todas las URLs
  • Procesamiento paralelo para velocidad
  • Manejo de errores individual por URL
  • Notificaciones por webhook disponibles

Autorización

YOUR_API_KEY
AutorizaciónBearer <token>

Obtén tu API key del Thunderbit Dashboard. Formato del encabezado: Authorization: Bearer YOUR_API_KEY

En: header

Cuerpo

application/json

TypeScript Definitions

Use the request body type in TypeScript.

urls*string[]requerido

Lista de URLs de las cuales extraer datos, máximo 50

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

Definición de estructura de datos en formato JSON Schema

Ejemplo:
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "rating": {
      "type": "number"
    }
  }
}
timeoutnumberpredeterminado:60000

Tiempo de espera por solicitud en milisegundos, predeterminado 30000

webhookobject

Configuración de callback webhook, notifica cuando la tarea se completa. Consulta la guía de Webhooks para el formato del payload de callback, los encabezados y la verificación de firma HMAC-SHA256.

Mostrar atributos hijos
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

Ejemplo:whsec_your_secret_key
headersobject

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

Ejemplo:
{
  "X-Custom-Auth": "your-token"
}
renderModestringpredeterminado:"none"

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

Valor en"none" | "basic" | "full"

Respuesta

application/json

Success response

successboolean
Ejemplo:
true
dataobject
Mostrar atributos hijos
idstring
Ejemplo:batch_ext_xyz789
statusstring
Valor en"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "UNKNOWN"
Ejemplo:PROCESSING
totalinteger
Ejemplo:
3
completedinteger
Ejemplo:
0
creditsUsedinteger
Ejemplo:
0
createdAtstring

Timestamp when the job was created

completedAtstring

Timestamp when the job completed (null if still processing)