Thunderbit Open API home page
SuporteConsole API
Extract

Extrair Múltiplas Páginas em Lote

POST
/batch/extract
Extrair Múltiplas Páginas em Lote

Extraia dados estruturados de múltiplas URLs simultaneamente usando IA.

Casos de Uso:

  • Coletar catálogos de produtos de múltiplas páginas
  • Extrair dados de páginas de resultados de busca
  • Processar em lote listagens ou páginas de diretórios
  • Coletar inteligência competitiva em escala

Como Funciona:

  1. Envie até 50 URLs com um único esquema
  2. Receba resposta imediata com ID da tarefa
  3. Todas as URLs são extraídas usando o mesmo esquema
  4. Consulte o status ou receba notificação via webhook
  5. Recupere todos os resultados estruturados de uma vez

Recursos:

  • Mesmo esquema aplicado a todas as URLs
  • Processamento paralelo para velocidade
  • Tratamento individual de erros por URL
  • Notificações via webhook disponíveis

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 das quais extrair dados, máximo 50

Exemplo:
[
  "https://example.com/product/1",
  "https://example.com/product/2",
  "https://example.com/product/3"
]
schema*objectobrigatório

Definição da estrutura de dados em formato JSON Schema

Exemplo:
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "rating": {
      "type": "number"
    }
  }
}
timeoutnumberpredefinido:60000

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

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

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"
}
renderModestringpredefinido:"none"

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

Valor em"none" | "basic" | "full"

Resposta

application/json

Success response

successboolean
Exemplo:
true
dataobject
Mostrar atributos filhos
idstring
Exemplo:batch_ext_xyz789
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)