Thunderbit Open API home page
SupportConsole API
Distill

Distiller une Page Unique

POST
/distill
Distiller une Page Unique

Convertissez une page web en format Markdown propre et prêt pour les LLM.

Cas d'Utilisation :

  • Préparer le contenu web pour le RAG (Génération Augmentée par Récupération)
  • Extraire le contenu d'articles pour le traitement par IA
  • Convertir des pages de documentation en markdown
  • Traiter des applications web dynamiques

Ce Qui Est Inclus :

  • Contenu markdown propre avec structure préservée
  • Suppression automatique des publicités, navigation et contenu superflu
  • Extraction de métadonnées (titre, description, langue)
  • Rendu JavaScript pour le contenu dynamique
  • Gestion automatique des mesures anti-bot

Format de Sortie : Retourne du markdown optimisé pour la consommation par les LLM avec un minimum de bruit et un maximum de signal.

Autorisation

YOUR_API_KEY
AutorisationBearer <token>

Récupère ta clé API depuis le Thunderbit Dashboard. Format d'en-tête : Authorization: Bearer YOUR_API_KEY

Dans: header

Corps

application/json

TypeScript Definitions

Use the request body type in TypeScript.

url*stringrequis

L'URL de la page web à distiller

Exemple :https://thunderbit.com/playground
timeoutnumberdéfaut :30000

Délai d'expiration de la requête en millisecondes (par défaut : 30000, max : 60000)

Plage requise :5000 <= x <= 60000
Exemple :
30000
waitFornumberdéfaut :0

Temps d'attente (en millisecondes) après le chargement de la page pour que le contenu dynamique soit rendu avant l'extraction du contenu

Plage requise :0 <= x <= 10000
Exemple :
2000
includeTagsstring[]

Inclure uniquement le contenu de ces balises HTML (ex. : ['article', 'main', 'div.content'])

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

Exclure le contenu de ces balises HTML (ex. : ['nav', 'footer', 'aside'])

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

En-têtes HTTP personnalisés à envoyer avec la requête

Exemple :
{
  "Accept-Language": "en-US"
}
countryCodestringdéfaut :"US"

Code pays ISO à 2 lettres pour le ciblage géographique (par défaut : US). Le trafic est routé via des serveurs proxy dans le pays spécifié.

Exemple :US
renderModestringdéfaut :"none"

Mode de rendu JavaScript. none = pas de rendu JS (le plus rapide, par défaut) ; basic = rendu standard ; full = rendu standard avec attente prolongée pour le contenu dynamique

Valeur dans"none" | "basic" | "full"
forceRefreshbooleandéfaut :false

Ignore le cache et force une nouvelle récupération de la page (par défaut : false)

formatsany[]

Formats de sortie. Les chaînes sélectionnent des formats simples ; les objets paramètrent les formats LLM (summary, question, highlights).

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

Champs optionnels à inclure dans la réponse. Valeurs disponibles : metadata (titre, description, langue, etc.), html (HTML original), links (liens extraits). Remplace includeHtml et extractLinks.

Exemple :
[
  "metadata",
  "links"
]
includeHtmlbooleandéfaut :false

Indique si le HTML original doit être inclus dans la réponse (par défaut : false). Privilégier le paramètre include.

extractLinksbooleandéfaut :false

Indique si les liens doivent être extraits de la page (par défaut : false). Privilégier le paramètre include.

Réponse

application/json

Réponse de succès

successboolean
Exemple :
true
dataobject
Afficher les attributs enfants
urlstring

L'URL qui a été distillée

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

Contenu markdown propre extrait de la page

Exemple :# 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)

Afficher les attributs enfants
titlestring

Titre de la page extrait de la balise ou Open Graph

Exemple :Understanding Web Distillation | Tech Blog
descriptionstring

Méta-description ou extrait

languagestring

Code de langue détecté (ISO 639-1)

Exemple :en
sourceUrlstring

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

statusCodeinteger

Code de statut HTTP de la réponse

Exemple :
200
htmlstring

Contenu HTML brut (optionnel, uniquement si demandé)

Exemple :
null
linksobject[]

Liens trouvés dans le contenu

Afficher les attributs enfants
textstring

Visible link text as rendered in the page

Exemple :Read more
hrefstring

Resolved absolute URL of the link

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

Images extraites de la page.

Afficher les attributs enfants
srcstring

Image source URL.

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

Image alt text.

Exemple :Hero banner
widthinteger

Image width in pixels.

heightinteger

Image height in pixels.

summarystring

Résumé Markdown structuré (format LLM).

answerstring

Réponse à la question fournie dans le format question.

highlightsstring[]

Passages mis en évidence par le format highlights.

errorobject
Exemple :
null