Thunderbit Open API home page
SuporteConsole API
Distill

Destilar Múltiplas Páginas em Lote

POST
/batch/distill
Destilar Múltiplas Páginas em Lote

Destile múltiplas páginas web simultaneamente com processamento assíncrono.

Casos de Uso:

  • Processar seções ou categorias inteiras de sites
  • Importar conteúdo em lote para sua base de conhecimento
  • Migração de conteúdo em larga escala
  • Atualizações periódicas de conteúdo de múltiplas fontes

Como Funciona:

  1. Envie uma tarefa em lote com até 100 URLs
  2. Receba um ID de tarefa imediatamente
  3. Consulte o endpoint de status ou receba notificação via webhook
  4. Recupere todos os resultados quando concluído

Recursos:

  • Processamento assíncrono para alto throughput
  • Retry automático em falhas
  • Notificações via webhook quando concluído
  • Relatório detalhado de status e erros por URL

Autorização

YOUR_API_KEY
AutorizaçãoBearer <token>

Pegue sua API key no Thunderbit Dashboard. Formato do cabeçalho: Authorization: Bearer YOUR_API_KEY

Em: header

Corpo

application/json

TypeScript Definitions

Use the request body type in TypeScript.

urls*string[]obrigatório

Lista de URLs para destilar, máximo 100

Exemplo:
[
  "https://example.com/page1",
  "https://example.com/page2",
  "https://example.com/page3"
]
timeoutnumberpredefinido:30000

Tempo limite por requisição em milissegundos, padrão 30000

Intervalo necessário:5000 <= x <= 60000
countryCodestringpredefinido:"US"

Código ISO de país de 2 letras para geolocalização, aplicado a cada URL (padrão: US)

Exemplo:US
renderModestringpredefinido:"none"

Modo de renderização JavaScript aplicado a cada URL: none (padrão), basic ou full

Valor em"none" | "basic" | "full"
includeHtmlbooleanpredefinido:false

Se deve incluir o HTML original para cada URL (padrão: false). Prefira o parâmetro include.

extractLinksbooleanpredefinido:false

Se deve extrair links para cada URL (padrão: false). Prefira o parâmetro include.

includestring[]

Campos opcionais para incluir para cada URL. Valores disponíveis: metadata, html, links.

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

Configuração de callback webhook, notifica quando a tarefa é concluída. Consulte o guia de Webhooks para o formato do payload de callback, cabeçalhos e verificação de assinatura HMAC-SHA256.

Mostrar atributos filhos
urlstring

Webhook callback URL, must be HTTPS

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

Exemplo:whsec_your_secret_key
headersobject

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

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

Resposta

application/json

Success response

successboolean
Exemplo:
true
dataobject
Mostrar atributos filhos
idstring

ID da tarefa em lote

Exemplo:batch_abc123
statusstring
Valor em"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "UNKNOWN"
Exemplo:PROCESSING
totalinteger
Exemplo:
3
completedinteger
Exemplo:
0
creditsUsedinteger
Exemplo:
0
createdAtstring

Timestamp when the job was created

completedAtstring

Timestamp when the job completed (null if still processing)