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

複数ページのバッチディスティル

POST
/batch/distill
複数ページのバッチディスティル

非同期処理で複数のWebページを同時にディスティルします。

ユースケース:

  • Webサイト全体のセクションやカテゴリの処理
  • ナレッジベースへのコンテンツの一括インポート
  • 大規模なコンテンツ移行
  • 複数ソースからの定期的なコンテンツ更新

動作の仕組み:

  1. 最大100個のURLでバッチジョブを送信
  2. ジョブIDを即座に受信
  3. ステータスエンドポイントをポーリングするか、Webhook通知を受信
  4. 完了時にすべての結果を取得

機能:

  • 高スループットのための非同期処理
  • 失敗時の自動リトライ
  • 完了時のWebhook通知
  • URLごとの詳細なステータスとエラーレポート

認証

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.

urls*string[]必須

ディスティルするURLのリスト、最大100件

例：
[
  "https://example.com/page1",
  "https://example.com/page2",
  "https://example.com/page3"
]
timeoutnumberデフォルト：30000

リクエストごとのタイムアウト（ミリ秒）、デフォルト30000

範囲：5000 <= x <= 60000
countryCodestringデフォルト："US"

ジオターゲティング用の 2 文字 ISO 国コード。各 URL に適用されます（デフォルト: US）

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

各 URL に適用される JavaScript レンダリングモード: none（デフォルト）、basic、または full

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

各 URL の元の HTML を含めるかどうか（デフォルト: false）。代わりに include パラメータを推奨します。

extractLinksbooleanデフォルト：false

各 URL のリンクを抽出するかどうか（デフォルト: false）。代わりに include パラメータを推奨します。

includestring[]

各 URL に含めるオプションフィールド。利用可能な値: metadata、html、links。

例：
[
  "metadata",
  "links"
]
webhookobject

Webhookコールバック設定、タスク完了時に通知。コールバックペイロードの形式、ヘッダー、HMAC-SHA256 署名検証については Webhooks ガイドを参照してください。

子属性を表示
urlstring

Webhook callback URL, must be HTTPS

例：https://your-server.com/api/webhook/distill
secretstring

HMAC-SHA256 secret for signature verification. When set, each webhook request includes an X-Webhook-Signature header

例：whsec_your_secret_key
headersobject

Custom headers (reserved for future use, not yet implemented by the server).

例：
{
  "X-Custom-Auth": "your-token"
}

レスポンス

application/json

Success response

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

バッチタスクID

例：batch_abc123
statusstring
値"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "UNKNOWN"
例：PROCESSING
totalinteger
例：
3
completedinteger
例：
0
creditsUsedinteger
例：
0
createdAtstring

Timestamp when the job was created

completedAtstring

Timestamp when the job completed (null if still processing)