Thunderbit Open API home page
SoporteConsola API
Distill

Destilar Múltiples Páginas por Lotes

POST
/batch/distill
Destilar Múltiples Páginas por Lotes

Destila múltiples páginas web simultáneamente con procesamiento asíncrono.

Casos de Uso:

  • Procesar secciones o categorías completas de sitios web
  • Importar contenido por lotes a tu base de conocimientos
  • Migración de contenido a gran escala
  • Actualizaciones periódicas de contenido desde múltiples fuentes

Cómo Funciona:

  1. Envía un trabajo por lotes con hasta 100 URLs
  2. Recibe un ID de trabajo inmediatamente
  3. Consulta el endpoint de estado o recibe notificación por webhook
  4. Recupera todos los resultados cuando esté completo

Características:

  • Procesamiento asíncrono para alto rendimiento
  • Reintento automático en fallos
  • Notificaciones por webhook cuando está completo
  • Informe detallado de estado y errores por URL

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 a destilar, máximo 100

Ejemplo:
[
  "https://example.com/page1",
  "https://example.com/page2",
  "https://example.com/page3"
]
timeoutnumberpredeterminado:30000

Tiempo de espera por solicitud en milisegundos, predeterminado 30000

Rango requerido:5000 <= x <= 60000
countryCodestringpredeterminado:"US"

Código ISO de país de 2 letras para geolocalización, aplicado a cada URL (predeterminado: US)

Ejemplo:US
renderModestringpredeterminado:"none"

Modo de renderizado JavaScript aplicado a cada URL: none (predeterminado), basic, o full

Valor en"none" | "basic" | "full"
includeHtmlbooleanpredeterminado:false

Si incluir el HTML original para cada URL (predeterminado: false). Se prefiere el parámetro include.

extractLinksbooleanpredeterminado:false

Si extraer enlaces para cada URL (predeterminado: false). Se prefiere el parámetro include.

includestring[]

Campos opcionales para incluir para cada URL. Valores disponibles: metadata, html, links.

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

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

Ejemplo:whsec_your_secret_key
headersobject

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

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

Respuesta

application/json

Success response

successboolean
Ejemplo:
true
dataobject
Mostrar atributos hijos
idstring

ID de tarea por lotes

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