Thunderbit Open API home page
サポートAPIコンソール
Distill

単一ページのディスティル

POST
/distill
単一ページのディスティル

WebページをクリーンなLLM対応Markdown形式に変換します。

ユースケース:

  • RAG（Retrieval-Augmented Generation）用のWebコンテンツ準備
  • AI処理用の記事コンテンツ抽出
  • ドキュメントページのMarkdown変換
  • 動的Webアプリケーションの処理

含まれる機能:

  • 構造を保持したクリーンなMarkdownコンテンツ
  • 広告、ナビゲーション、定型文の自動削除
  • メタデータ抽出（タイトル、説明、言語）
  • 動的コンテンツ用のJavaScriptレンダリング
  • アンチボット対策の自動処理

出力フォーマット: ノイズを最小限に抑え、信号を最大化したLLM消費に最適化されたMarkdownを返します。

認証

YOUR_API_KEY
認証Bearer <token>

Thunderbit Dashboard から API キーを取得してください。ヘッダー形式：Authorization: Bearer YOUR_API_KEY

位置: header

ボディ

application/json

TypeScript Definitions

Use the request body type in TypeScript.

url*string必須

ディスティルするWebページのURL

例：https://thunderbit.com/playground
timeoutnumberデフォルト：30000

リクエストタイムアウト（ミリ秒）（デフォルト: 30000、最大: 60000）

範囲：5000 <= x <= 60000
例：
30000
waitFornumberデフォルト：0

コンテンツ抽出前に動的コンテンツのレンダリングを待機する時間（ミリ秒）

範囲：0 <= x <= 10000
例：
2000
includeTagsstring[]

これらのHTMLタグからのコンテンツのみを含める（例: ['article', 'main', 'div.content']）

例：
[
  "article",
  "main"
]
excludeTagsstring[]

これらのHTMLタグからのコンテンツを除外する（例: ['nav', 'footer', 'aside']）

例：
[
  "nav",
  "footer",
  "aside"
]
headersobject

リクエストと共に送信するカスタムHTTPヘッダー

例：
{
  "Accept-Language": "en-US"
}
countryCodestringデフォルト："US"

ジオターゲティング用の 2 文字 ISO 国コード（デフォルト: US）。指定国のプロキシサーバー経由でトラフィックがルーティングされます。

例：US
renderModestringデフォルト："none"

JavaScript レンダリングモード。none = JS レンダリングなし（最速、デフォルト）、basic = 標準レンダリング、full = 動的コンテンツの待機時間を延長した標準レンダリング

値"none" | "basic" | "full"
forceRefreshbooleanデフォルト：false

キャッシュをバイパスし、ページを強制的に再取得します（デフォルト: false）

formatsany[]

出力形式。文字列はシンプルな形式を選択し、オブジェクトは LLM 形式（summary、question、highlights）をパラメータ化します。

例：
[
  "markdown",
  "links",
  "images"
]
includestring[]

レスポンスに含めるオプションフィールド。利用可能な値: metadata（タイトル、説明、言語など）、html（元の HTML）、links（抽出されたリンク）。includeHtml と extractLinks の代わりに使用できます。

例：
[
  "metadata",
  "links"
]
includeHtmlbooleanデフォルト：false

レスポンスに元の HTML を含めるかどうか（デフォルト: false）。代わりに include パラメータの使用を検討してください。

extractLinksbooleanデフォルト：false

ページからリンクを抽出するかどうか（デフォルト: false）。代わりに include パラメータの使用を検討してください。

レスポンス

application/json

成功レスポンス

successboolean
例：
true
dataobject
子属性を表示
urlstring

ディスティルされたURL

例：https://thunderbit.com/playground
markdownstring

ページから抽出されたクリーンなMarkdownコンテンツ

例：# 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)

子属性を表示
titlestring
例：Understanding Web Distillation | Tech Blog
descriptionstring

メタ説明または抜粋

languagestring

検出された言語コード（ISO 639-1）

例：en
sourceUrlstring

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

statusCodeinteger

レスポンスのHTTPステータスコード

例：
200
htmlstring

生のHTMLコンテンツ（オプション、リクエストされた場合のみ）

例：
null
linksobject[]

コンテンツ内で見つかったリンク

子属性を表示
textstring

Visible link text as rendered in the page

例：Read more
hrefstring

Resolved absolute URL of the link

例：https://example.com/article
imagesobject[]

ページから抽出された画像。

子属性を表示
srcstring

Image source URL.

例：https://example.com/hero.png
altstring

Image alt text.

例：Hero banner
widthinteger

Image width in pixels.

heightinteger

Image height in pixels.

summarystring

構造化された Markdown 要約（LLM 形式）。

answerstring

question 形式で指定された質問への回答。

highlightsstring[]

highlights 形式で抽出されたハイライト一節。

errorobject
例：
null