Thunderbit Open API home page
SupportoConsole API
Distill

Distilla Pagina Singola

POST
/distill
Distilla Pagina Singola

Converti una pagina web in formato Markdown pulito e pronto per LLM.

Casi d'Uso:

  • Preparare contenuti web per RAG (Retrieval-Augmented Generation)
  • Estrarre contenuti di articoli per elaborazione IA
  • Convertire pagine di documentazione in markdown
  • Elaborare applicazioni web dinamiche

Cosa Include:

  • Contenuto markdown pulito con struttura preservata
  • Rimozione automatica di pubblicita, navigazione e elementi superflui
  • Estrazione metadati (titolo, descrizione, lingua)
  • Rendering JavaScript per contenuti dinamici
  • Gestione automatica delle misure anti-bot

Formato di Output: Restituisce markdown ottimizzato per il consumo LLM con minimo rumore e massimo segnale.

Autorizzazione

YOUR_API_KEY
AutorizzazioneBearer <token>

Ottieni la tua API key dal Thunderbit Dashboard. Formato header: Authorization: Bearer YOUR_API_KEY

In: header

Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

url*stringobbligatorio

L'URL della pagina web da distillare

Esempio:https://thunderbit.com/playground
timeoutnumberpredefinito:30000

Timeout della richiesta in millisecondi (predefinito: 30000, massimo: 60000)

Intervallo richiesto:5000 <= x <= 60000
Esempio:
30000
waitFornumberpredefinito:0

Tempo di attesa (in millisecondi) dopo il caricamento della pagina per il rendering del contenuto dinamico prima dell'estrazione

Intervallo richiesto:0 <= x <= 10000
Esempio:
2000
includeTagsstring[]

Includi solo contenuto da questi tag HTML (es. ['article', 'main', 'div.content'])

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

Escludi contenuto da questi tag HTML (es. ['nav', 'footer', 'aside'])

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

Header HTTP personalizzati da inviare con la richiesta

Esempio:
{
  "Accept-Language": "en-US"
}
countryCodestringpredefinito:"US"

Codice paese ISO a 2 lettere per il geo-targeting (predefinito: US). Il traffico viene instradato tramite server proxy nel paese specificato.

Esempio:US
renderModestringpredefinito:"none"

Modalità di rendering JavaScript. none = nessun rendering JS (più veloce, predefinito); basic = rendering standard; full = rendering standard con attesa estesa per contenuti dinamici

Valore in"none" | "basic" | "full"
forceRefreshbooleanpredefinito:false

Ignora la cache e forza un nuovo recupero della pagina (predefinito: false)

formatsany[]

Formati di output. Le stringhe selezionano formati semplici; gli oggetti parametrizzano i formati LLM (summary, question, highlights).

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

Campi opzionali da includere nella risposta. Valori disponibili: metadata (titolo, descrizione, lingua, ecc.), html (HTML originale), links (link estratti). Sostituisce includeHtml ed extractLinks.

Esempio:
[
  "metadata",
  "links"
]
includeHtmlbooleanpredefinito:false

Se includere l'HTML originale nella risposta (predefinito: false). È consigliato usare il parametro include.

extractLinksbooleanpredefinito:false

Se estrarre i link dalla pagina (predefinito: false). È consigliato usare il parametro include.

Risposta

application/json

Risposta di successo

successboolean
Esempio:
true
dataobject
Mostra attributi figli
urlstring

L'URL che e stato distillato

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

Contenuto markdown pulito estratto dalla pagina

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

Mostra attributi figli
titlestring

Titolo della pagina estratto dal tag o Open Graph

Esempio:Understanding Web Distillation | Tech Blog
descriptionstring

Meta description o estratto

languagestring

Codice lingua rilevato (ISO 639-1)

Esempio:en
sourceUrlstring

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

statusCodeinteger

Codice di stato HTTP della risposta

Esempio:
200
htmlstring

Contenuto HTML grezzo (opzionale, solo se richiesto)

Esempio:
null
linksobject[]

Link trovati nel contenuto

Mostra attributi figli
textstring

Visible link text as rendered in the page

Esempio:Read more
hrefstring

Resolved absolute URL of the link

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

Immagini estratte dalla pagina.

Mostra attributi figli
srcstring

Image source URL.

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

Image alt text.

Esempio:Hero banner
widthinteger

Image width in pixels.

heightinteger

Image height in pixels.

summarystring

Riepilogo Markdown strutturato (formato LLM).

answerstring

Risposta alla domanda fornita nel formato question.

highlightsstring[]

Passaggi evidenziati dal formato highlights.

errorobject
Esempio:
null