Thunderbit Open API home page
支持API 控制台
Search

搜索并蒸馏

POST
/search
搜索并蒸馏

针对提供的查询执行 Google 网页搜索，并使用请求的 formats 对每个结果进行蒸馏。每个结果都会报告自己的 success 标志。

授权

YOUR_API_KEY
授权Bearer <token>

在 Thunderbit Dashboard 获取 API key。请求头格式：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 时）。