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

検索とディスティル

POST
/search
検索とディスティル

指定したクエリで Google ウェブ検索を実行し、各結果を要求された formats でディスティルします。各結果は独自の success フラグを返します。

認証

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.

query*string必須

検索クエリ（最大 500 文字）。

例：best web scraping tools 2026
limitintegerデフォルト：5

返す結果の数（1–10、デフォルト 5）。

範囲：1 <= x <= 10
例：
5
sitestring

検索を単一のドメインに制限します。

例：techcrunch.com
formatsany[]

各結果ページに適用される出力形式（Distill の formats 配列と同じ構造）。

例：
[
  "markdown",
  {
    "type": "summary"
  }
]
timeoutintegerデフォルト：30000

結果ごとの Distill タイムアウト（ミリ秒、デフォルト 30000、最大 60000）。

範囲：5000 <= x <= 60000

レスポンス

application/json

Search succeeded. Per-result Distill outcomes are reported individually in `data.results[].success`.

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

入力クエリのエコー。

totalinteger

返された結果の数。

successfulinteger

Distill 段階が成功した結果の数。

credits_usedinteger

このリクエストで請求された合計クレジット。

resultsobject[]
子属性を表示
urlstring

結果の URL。

titlestring

検索結果のタイトル。

snippetstring

Google からの検索結果スニペット。

positioninteger

検索結果における 1 始まりの順位。

successboolean

結果ごとに Distill が成功したかどうか。

markdownstring

この結果のディスティル済み Markdown（要求された場合）。

summarystring

結果の要約（要求された場合）。

answerstring

question 形式への回答（要求された場合）。

highlightsstring[]

ハイライトされた一節（要求された場合）。

linksobject[]

結果ページから抽出されたリンク（要求された場合）。

子属性を表示
textstring

Visible link text.

例：Read more
hrefstring

Resolved absolute URL.

例：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.

errorstring

この結果に対する Distill エラーメッセージ（success=false の場合のみ）。