Thunderbit Open API home page
SuporteConsole API
Distill

Destilar Página Única

POST
/distill
Destilar Página Única

Converta uma página web em formato Markdown limpo, pronto para LLM.

Casos de Uso:

  • Preparar conteúdo web para RAG (Geração Aumentada por Recuperação)
  • Extrair conteúdo de artigos para processamento por IA
  • Converter páginas de documentação para markdown
  • Processar aplicações web dinâmicas

O Que Está Incluído:

  • Conteúdo markdown limpo com estrutura preservada
  • Remoção automática de anúncios, navegação e elementos repetitivos
  • Extração de metadados (título, descrição, idioma)
  • Renderização JavaScript para conteúdo dinâmico
  • Tratamento automático de medidas anti-bot

Formato de Saída: Retorna markdown otimizado para consumo por LLM com mínimo ruído e máximo sinal.

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.

url*stringobrigatório

A URL da página web a ser destilada

Exemplo:https://thunderbit.com/playground
timeoutnumberpredefinido:30000

Tempo limite da requisição em milissegundos (padrão: 30000, máx: 60000)

Intervalo necessário:5000 <= x <= 60000
Exemplo:
30000
waitFornumberpredefinido:0

Tempo de espera (em milissegundos) após o carregamento da página para o conteúdo dinâmico renderizar antes de extrair o conteúdo

Intervalo necessário:0 <= x <= 10000
Exemplo:
2000
includeTagsstring[]

Incluir apenas conteúdo destas tags HTML (ex.: ['article', 'main', 'div.content'])

Exemplo:
[
  "article",
  "main"
]
excludeTagsstring[]

Excluir conteúdo destas tags HTML (ex.: ['nav', 'footer', 'aside'])

Exemplo:
[
  "nav",
  "footer",
  "aside"
]
headersobject

Cabeçalhos HTTP personalizados para enviar com a requisição

Exemplo:
{
  "Accept-Language": "en-US"
}
countryCodestringpredefinido:"US"

Código ISO de país de 2 letras para geolocalização (padrão: US). O tráfego é roteado por servidores proxy no país especificado.

Exemplo:US
renderModestringpredefinido:"none"

Modo de renderização JavaScript. none = sem renderização JS (mais rápido, padrão); basic = renderização padrão; full = renderização padrão com espera estendida para conteúdo dinâmico

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

Ignora o cache e força uma nova busca da página (padrão: false)

formatsany[]

Formatos de saída. Strings selecionam formatos simples; objetos parametrizam formatos LLM (summary, question, highlights).

Exemplo:
[
  "markdown",
  "links",
  "images"
]
includestring[]

Campos opcionais para incluir na resposta. Valores disponíveis: metadata (título, descrição, idioma, etc.), html (HTML original), links (links extraídos). Substitui includeHtml e extractLinks.

Exemplo:
[
  "metadata",
  "links"
]
includeHtmlbooleanpredefinido:false

Se deve incluir o HTML original na resposta (padrão: false). Considere usar o parâmetro include em vez disso.

extractLinksbooleanpredefinido:false

Se deve extrair links da página (padrão: false). Considere usar o parâmetro include em vez disso.

Resposta

application/json

Resposta de sucesso

successboolean
Exemplo:
true
dataobject
Mostrar atributos filhos
urlstring

A URL que foi destilada

Exemplo:https://thunderbit.com/playground
markdownstring

Conteúdo markdown limpo extraído da página

Exemplo:# Understanding Web Distillation Web distillation is the process of converting raw HTML into clean, structured content... ## Key Benefits - **LLM-Ready Format**: Optimized for AI consumption - **Noise Removal**: Automatic filtering of ads and boilerplate - **Structure Preservation**: Maintains semantic hierarchy
metadataobject

Page metadata (only returned when include contains metadata)

Mostrar atributos filhos
titlestring

Título da página extraído da tag ou Open Graph

Exemplo:Understanding Web Distillation | Tech Blog
descriptionstring

Meta descrição ou resumo

languagestring

Código de idioma detectado (ISO 639-1)

Exemplo:en
sourceUrlstring

Original URL (may differ from requested URL due to redirects)

statusCodeinteger

Código de status HTTP da resposta

Exemplo:
200
htmlstring

Conteúdo HTML bruto (opcional, apenas se solicitado)

Exemplo:
null
linksobject[]

Links encontrados no conteúdo

Mostrar atributos filhos
textstring

Visible link text as rendered in the page

Exemplo:Read more
hrefstring

Resolved absolute URL of the link

Exemplo:https://example.com/article
imagesobject[]

Imagens extraídas da página.

Mostrar atributos filhos
srcstring

Image source URL.

Exemplo:https://example.com/hero.png
altstring

Image alt text.

Exemplo:Hero banner
widthinteger

Image width in pixels.

heightinteger

Image height in pixels.

summarystring

Resumo estruturado em Markdown (formato LLM).

answerstring

Resposta à pergunta fornecida no formato question.

highlightsstring[]

Trechos destacados pelo formato highlights.

errorobject
Exemplo:
null