Thunderbit Open API home page
SoporteConsola API
Distill

Destilar Página Individual

POST
/distill
Destilar Página Individual

Convierte una página web en formato Markdown limpio, listo para LLM.

Casos de Uso:

  • Preparar contenido web para RAG (Generación Aumentada por Recuperación)
  • Extraer contenido de artículos para procesamiento con IA
  • Convertir páginas de documentación a markdown
  • Procesar aplicaciones web dinámicas

Qué Incluye:

  • Contenido markdown limpio con estructura preservada
  • Eliminación automática de anuncios, navegación y contenido repetitivo
  • Extracción de metadatos (título, descripción, idioma)
  • Renderizado JavaScript para contenido dinámico
  • Manejo automático de medidas anti-bot

Formato de Salida: Devuelve markdown optimizado para consumo por LLM con mínimo ruido y máxima señal.

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.

url*stringrequerido

La URL de la página web a destilar

Ejemplo:https://thunderbit.com/playground
timeoutnumberpredeterminado:30000

Tiempo de espera de solicitud en milisegundos (predeterminado: 30000, máx: 60000)

Rango requerido:5000 <= x <= 60000
Ejemplo:
30000
waitFornumberpredeterminado:0

Tiempo de espera (en milisegundos) después de cargar la página para que el contenido dinámico se renderice antes de extraer contenido

Rango requerido:0 <= x <= 10000
Ejemplo:
2000
includeTagsstring[]

Solo incluir contenido de estas etiquetas HTML (ej., ['article', 'main', 'div.content'])

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

Excluir contenido de estas etiquetas HTML (ej., ['nav', 'footer', 'aside'])

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

Headers HTTP personalizados para enviar con la solicitud

Ejemplo:
{
  "Accept-Language": "en-US"
}
countryCodestringpredeterminado:"US"

Código ISO de país de 2 letras para geolocalización (predeterminado: US). El tráfico se enruta a través de servidores proxy en el país especificado.

Ejemplo:US
renderModestringpredeterminado:"none"

Modo de renderizado JavaScript. none = sin renderizado JS (más rápido, predeterminado); basic = renderizado estándar; full = renderizado estándar con espera extendida para contenido dinámico

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

Omite la caché y fuerza una nueva obtención de la página (predeterminado: false)

formatsany[]

Formatos de salida. Las cadenas seleccionan formatos simples; los objetos parametrizan formatos LLM (summary, question, highlights).

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

Campos opcionales para incluir en la respuesta. Valores disponibles: metadata (título, descripción, idioma, etc.), html (HTML original), links (enlaces extraídos). Reemplaza a includeHtml y extractLinks.

Ejemplo:
[
  "metadata",
  "links"
]
includeHtmlbooleanpredeterminado:false

Si incluir el HTML original en la respuesta (predeterminado: false). Considera usar el parámetro include en su lugar.

extractLinksbooleanpredeterminado:false

Si extraer enlaces de la página (predeterminado: false). Considera usar el parámetro include en su lugar.

Respuesta

application/json

Respuesta exitosa

successboolean
Ejemplo:
true
dataobject
Mostrar atributos hijos
urlstring

La URL que fue destilada

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

Contenido markdown limpio extraído de la página

Ejemplo:# 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 hijos
titlestring

Título de página extraído de la etiqueta o Open Graph

Ejemplo:Understanding Web Distillation | Tech Blog
descriptionstring

Meta descripción o extracto

languagestring

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

Ejemplo:en
sourceUrlstring

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

statusCodeinteger

Código de estado HTTP de la respuesta

Ejemplo:
200
htmlstring

Contenido HTML sin procesar (opcional, solo si se solicita)

Ejemplo:
null
linksobject[]

Enlaces encontrados en el contenido

Mostrar atributos hijos
textstring

Visible link text as rendered in the page

Ejemplo:Read more
hrefstring

Resolved absolute URL of the link

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

Imágenes extraídas de la página.

Mostrar atributos hijos
srcstring

Image source URL.

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

Image alt text.

Ejemplo:Hero banner
widthinteger

Image width in pixels.

heightinteger

Image height in pixels.

summarystring

Resumen estructurado en Markdown (formato LLM).

answerstring

Respuesta a la pregunta proporcionada en el formato question.

highlightsstring[]

Pasajes destacados por el formato highlights.

errorobject
Ejemplo:
null