> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/api-reference/cn/zhuan-yong-zhua-qu-qi/sou-suo-yin-qing-zhua-qu-qi.md).

# 搜索引擎抓取器

Web API 的 Google 和 Bing 抓取器端点参考：每个端点的参数和交付模式。

<table><thead><tr><th width="108">抓取器</th><th>端点</th></tr></thead><tbody><tr><td><a href="#google">Google</a></td><td><code>/google/search</code>, <code>/google/ads</code>, <code>/google/aimode</code>, <code>/google/shopping/search</code>, <code>/google/shopping/product</code>, <code>/google/maps</code>, <code>/google/travel/hotels</code>, <code>/google/lens</code>, <code>/google/trends/explore</code>, <code>/google</code></td></tr><tr><td><a href="#bing">Bing</a></td><td><code>/bing/search</code>, <code>/bing</code></td></tr></tbody></table>

### Google

#### `POST /v1/scrape/google/search`

返回某个查询的自然结果、广告以及出现的 SERP 功能。

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="157.5">名称</th><th width="98.5">类型</th><th width="89">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>query</code></td><td>字符串</td><td>是</td><td>搜索词，按用户输入的方式</td></tr><tr><td><code>aomd</code></td><td>字符串</td><td>否</td><td>Google 未公开。按发送内容原样转发</td></tr><tr><td><code>cr</code></td><td>字符串</td><td>否</td><td>国家限制。按原样转发</td></tr><tr><td><code>disable_scripts</code></td><td>布尔值</td><td>否</td><td>阻止页面脚本</td></tr><tr><td><code>domain</code></td><td>字符串</td><td>否</td><td>要搜索的 Google TLD： <code>com</code>, <code>co.uk</code>, <code>de</code>. 选择国家索引</td></tr><tr><td><code>expand_aio</code></td><td>布尔值</td><td>否</td><td>展开 AI Overview 模块，而不是以折叠状态返回它</td></tr><tr><td><code>filter</code></td><td>整数</td><td>否</td><td>Google 的重复内容过滤器。 <code>0</code> 关闭它并返回近似重复结果</td></tr><tr><td><code>fpstate</code></td><td>字符串</td><td>否</td><td>页面状态。按原样转发</td></tr><tr><td><code>limit_per_page</code></td><td>对象数组</td><td>否</td><td>每页结果数量，例如 <code>[{"page": 1, "limit": 20}]</code>。替代 <code>pages</code> ，当只关心第 1 页时</td></tr><tr><td><code>locale</code></td><td>字符串</td><td>否</td><td>界面语言，例如 <code>en_US</code>。影响 SERP 功能的措辞，不影响排名</td></tr><tr><td><code>nfpr</code></td><td>字符串</td><td>否</td><td>禁止 Google 的拼写自动纠正</td></tr><tr><td><code>pages</code></td><td>整数</td><td>否</td><td>要连续获取的页数 <code>start_page</code>。每一页都是单独获取并计费</td></tr><tr><td><code>results_language</code></td><td>字符串</td><td>否</td><td>将结果限制为一种语言，例如 <code>lt</code>。只过滤，不翻译</td></tr><tr><td><code>safe_search</code></td><td>布尔值</td><td>否</td><td>Google 的 SafeSearch 过滤器。这里为布尔值，在 Bing 中为字符串</td></tr><tr><td><code>start_page</code></td><td>整数</td><td>否</td><td>要获取的第一页。默认 <code>1</code></td></tr><tr><td><code>tbm</code></td><td>字符串</td><td>否</td><td>搜索垂直领域：图片、购物、视频、图书。按原样转发</td></tr><tr><td><code>tbs</code></td><td>字符串</td><td>否</td><td>时间和质量筛选器，例如过去 24 小时。按原样转发</td></tr><tr><td><code>udm</code></td><td>字符串</td><td>否</td><td>Google 的 UI 模式选择器。按原样转发</td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>自定义提取： <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用。覆盖内置解析器</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>请求来源的两字母国家代码。与 <code>domain</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>否</td><td>在捕获前执行页面 JavaScript。较慢——请使用 120 秒或更长的客户端超时</td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>

#### `POST /v1/scrape/google/ads`

仅返回付费模块：广告主、顺序和广告文案。

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="159">名称</th><th width="96.5">类型</th><th width="91.5">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>query</code></td><td>字符串</td><td>是</td><td>获取广告所用的搜索词</td></tr><tr><td><code>adstest</code></td><td>布尔值</td><td>否</td><td>返回来自 Google 测试广告网络的广告，而不是实时库存</td></tr><tr><td><code>disable_scripts</code></td><td>布尔值</td><td>否</td><td>阻止页面脚本</td></tr><tr><td><code>domain</code></td><td>字符串</td><td>否</td><td>要搜索的 Google TLD： <code>com</code>, <code>co.uk</code>, <code>de</code>. 选择国家索引</td></tr><tr><td><code>expand_aio</code></td><td>布尔值</td><td>否</td><td>展开 AI Overview 模块，而不是以折叠状态返回它</td></tr><tr><td><code>locale</code></td><td>字符串</td><td>否</td><td>界面语言，例如 <code>en_US</code>。影响 SERP 功能的措辞，不影响排名</td></tr><tr><td><code>pages</code></td><td>整数</td><td>否</td><td>要连续获取的页数 <code>start_page</code>。每一页都是单独获取并计费</td></tr><tr><td><code>start_page</code></td><td>整数</td><td>否</td><td>要获取的第一页。默认 <code>1</code></td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>自定义提取： <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用。覆盖内置解析器</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>请求来源的两字母国家代码。与 <code>domain</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>否</td><td>在捕获前执行页面 JavaScript。较慢——请使用 120 秒或更长的客户端超时</td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>

#### `POST /v1/scrape/google/aimode`

返回 Google 的 AI Mode 答案，与由 `/google/search`.

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="134.5">名称</th><th width="96">类型</th><th width="94">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>query</code></td><td>字符串</td><td>是</td><td>要向 Google AI Mode 提出的问题</td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>自定义提取： <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用。覆盖内置解析器</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>请求来源的两字母国家代码。与 <code>domain</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>是</td><td>必填： <code>true</code></td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>

相同请求之间的响应可能不同。

#### `POST /v1/scrape/google/shopping/search`

返回带价格的 Google Shopping 列表。

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="132">名称</th><th width="104.5">类型</th><th width="93">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>query</code></td><td>字符串</td><td>是</td><td>搜索词</td></tr><tr><td><code>domain</code></td><td>字符串</td><td>否</td><td>要搜索的 Google TLD： <code>com</code>, <code>co.uk</code>, <code>de</code>. 选择国家索引</td></tr><tr><td><code>limit</code></td><td>整数</td><td>否</td><td>要返回的结果数量</td></tr><tr><td><code>locale</code></td><td>字符串</td><td>否</td><td>界面语言，例如 <code>en_US</code>。影响 SERP 功能的措辞，不影响排名</td></tr><tr><td><code>max_price</code></td><td>整数</td><td>否</td><td>要包含的最高价格，按商店货币计算</td></tr><tr><td><code>min_price</code></td><td>整数</td><td>否</td><td>要包含的最低价格，按商店货币计算</td></tr><tr><td><code>pages</code></td><td>整数</td><td>否</td><td>要连续获取的页数 <code>start_page</code>。每一页都是单独获取并计费</td></tr><tr><td><code>sort_by</code></td><td>字符串</td><td>否</td><td><code>r</code> 相关性（默认）， <code>rv</code> 评分从高到低， <code>p</code> 价格从低到高， <code>pd</code> 价格从高到低</td></tr><tr><td><code>start_page</code></td><td>整数</td><td>否</td><td>要获取的第一页。默认 <code>1</code></td></tr><tr><td><code>tbs</code></td><td>字符串</td><td>否</td><td>时间和质量筛选器，例如过去 24 小时。按原样转发</td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>自定义提取： <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用。覆盖内置解析器</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>请求来源的两字母国家代码。与 <code>domain</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>否</td><td>在捕获前执行页面 JavaScript。较慢——请使用 120 秒或更长的客户端超时</td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>

#### `POST /v1/scrape/google/shopping/product`

返回一个 Google Shopping 商品。

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="134.5">名称</th><th width="94">类型</th><th width="93.5">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>query</code></td><td>字符串</td><td>是</td><td>Google Shopping 商品 ID</td></tr><tr><td><code>domain</code></td><td>字符串</td><td>否</td><td>要搜索的 Google TLD： <code>com</code>, <code>co.uk</code>, <code>de</code>. 选择国家索引</td></tr><tr><td><code>locale</code></td><td>字符串</td><td>否</td><td>界面语言，例如 <code>en_US</code>。影响 SERP 功能的措辞，不影响排名</td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>自定义提取： <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用。覆盖内置解析器</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>请求来源的两字母国家代码。与 <code>domain</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>否</td><td>在捕获前执行页面 JavaScript。较慢——请使用 120 秒或更长的客户端超时</td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>

#### `POST /v1/scrape/google/maps`

返回 Google Maps 本地列表。

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="161">名称</th><th width="95">类型</th><th width="93.5">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>query</code></td><td>字符串</td><td>是</td><td>地点或类别搜索词，例如 <code>dentist vilnius</code></td></tr><tr><td><code>domain</code></td><td>字符串</td><td>否</td><td>要搜索的 Google TLD： <code>com</code>, <code>co.uk</code>, <code>de</code>. 选择国家索引</td></tr><tr><td><code>hotel_dates</code></td><td>字符串</td><td>否</td><td>入住日期。没有它时，将使用 Google 的默认入住窗口</td></tr><tr><td><code>hotel_occupancy</code></td><td>整数</td><td>否</td><td>房间内的客人</td></tr><tr><td><code>locale</code></td><td>字符串</td><td>否</td><td>界面语言，例如 <code>en_US</code>。影响 SERP 功能的措辞，不影响排名</td></tr><tr><td><code>pages</code></td><td>整数</td><td>否</td><td>要连续获取的页数 <code>start_page</code>。每一页都是单独获取并计费</td></tr><tr><td><code>start_page</code></td><td>整数</td><td>否</td><td>要获取的第一页。默认 <code>1</code></td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>需与 <code>output: ["json"]</code> — 该端点没有内置解析器。 <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>请求来源的两字母国家代码。与 <code>domain</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>否</td><td>在捕获前执行页面 JavaScript。较慢——请使用 120 秒或更长的客户端超时</td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>

#### `POST /v1/scrape/google/travel/hotels`

返回按给定日期和入住人数定价的酒店列表。

{% hint style="success" %}
**要获取单个酒店的详情和预订网站价格**，请将返回的 Google Travel 酒店 URL 与 `property_token` 值（例如 `https://www.google.com/travel/hotels/entity/<property_token>`）到 [`POST /v1/scrape/google`](#post-v1-scrape-google) 并附带 `output: ["json"]`。使用内置解析器，不需要 `JSON` prompt 或 schema。
{% endhint %}

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="146.5">名称</th><th width="104">类型</th><th width="95">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>query</code></td><td>字符串</td><td>是</td><td>酒店名称或目的地</td></tr><tr><td><code>adults</code></td><td>整数</td><td>否</td><td>成人客人</td></tr><tr><td><code>children</code></td><td>整数</td><td>否</td><td>儿童客人</td></tr><tr><td><code>domain</code></td><td>字符串</td><td>否</td><td>要搜索的 Google TLD： <code>com</code>, <code>co.uk</code>, <code>de</code>. 选择国家索引</td></tr><tr><td><code>hotel_classes</code></td><td>整数数组</td><td>否</td><td>要包含的星级，例如 <code>[4, 5]</code></td></tr><tr><td><code>hotel_dates</code></td><td>字符串</td><td>否</td><td>入住日期。没有它时，将使用 Google 的默认入住窗口</td></tr><tr><td><code>hotel_occupancy</code></td><td>整数</td><td>否</td><td>房间内的客人</td></tr><tr><td><code>locale</code></td><td>字符串</td><td>否</td><td>界面语言，例如 <code>en_US</code>。影响 SERP 功能的措辞，不影响排名</td></tr><tr><td><code>pages</code></td><td>整数</td><td>否</td><td>要连续获取的页数 <code>start_page</code>。每一页都是单独获取并计费</td></tr><tr><td><code>start_page</code></td><td>整数</td><td>否</td><td>要获取的第一页。默认 <code>1</code></td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>自定义提取： <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用。覆盖内置解析器</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>请求来源的两字母国家代码。与 <code>domain</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>否</td><td>在捕获前执行页面 JavaScript。较慢——请使用 120 秒或更长的客户端超时</td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>

#### `POST /v1/scrape/google/lens`

返回图片 URL 的视觉匹配结果。

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="132">名称</th><th width="98">类型</th><th width="99">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>query</code></td><td>字符串</td><td>是</td><td>要匹配的图片 URL。不是搜索文本</td></tr><tr><td><code>keywords</code></td><td>字符串</td><td>否</td><td>用于缩小视觉匹配范围的文本提示</td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>自定义提取： <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用。覆盖内置解析器</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>请求来源的两字母国家代码。与 <code>domain</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>否</td><td>在捕获前执行页面 JavaScript。较慢——请使用 120 秒或更长的客户端超时</td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>

#### `POST /v1/scrape/google/trends/explore`

返回某个词随时间变化的相对搜索热度。

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="135">名称</th><th width="93">类型</th><th width="97.5">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>query</code></td><td>字符串</td><td>是</td><td>要绘制的词</td></tr><tr><td><code>category_id</code></td><td>字符串</td><td>否</td><td>Google Trends 类别 ID</td></tr><tr><td><code>date_from</code></td><td>字符串</td><td>否</td><td>窗口开始，例如 <code>2026-01-01</code></td></tr><tr><td><code>date_to</code></td><td>字符串</td><td>否</td><td>窗口结束，例如 <code>2026-06-30</code></td></tr><tr><td><code>search_type</code></td><td>字符串</td><td>否</td><td>Trends 垂直领域，例如 web、image、news、YouTube 或 shopping</td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>需与 <code>output: ["json"]</code> — 该端点没有内置解析器。 <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>请求来源的两字母国家代码。与 <code>domain</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>否</td><td>在捕获前执行页面 JavaScript。较慢——请使用 120 秒或更长的客户端超时</td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>

热度值是相对值，会在请求窗口内归一化：扩展 `date_from` 会重新缩放每个点。

#### `POST /v1/scrape/google`

返回你提供的 URL 对应的 Google 页面解析字段。

{% hint style="info" %}
此端点也可以采集并解析 **Travel: Hotels** 详情。参见 [`/google/travel/hotels`](/api-reference/cn/zhuan-yong-zhua-qu-qi/sou-suo-yin-qing-zhua-qu-qi.md#post-v1-scrape-google-travel-hotels).
{% endhint %}

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="156.5">名称</th><th width="100.5">类型</th><th width="99.5">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>url</code></td><td>字符串</td><td>是</td><td>一个 Google URL</td></tr><tr><td><code>adstest</code></td><td>布尔值</td><td>否</td><td>返回来自 Google 测试广告网络的广告，而不是实时库存</td></tr><tr><td><code>adults</code></td><td>整数</td><td>否</td><td>成人客人</td></tr><tr><td><code>aomd</code></td><td>字符串</td><td>否</td><td>Google 未公开。按发送内容原样转发</td></tr><tr><td><code>category_id</code></td><td>字符串</td><td>否</td><td>Google Trends 类别 ID</td></tr><tr><td><code>children</code></td><td>整数</td><td>否</td><td>儿童客人</td></tr><tr><td><code>cr</code></td><td>字符串</td><td>否</td><td>国家限制。按原样转发</td></tr><tr><td><code>date_from</code></td><td>字符串</td><td>否</td><td>窗口开始，例如 <code>2026-01-01</code></td></tr><tr><td><code>date_to</code></td><td>字符串</td><td>否</td><td>窗口结束，例如 <code>2026-06-30</code></td></tr><tr><td><code>disable_scripts</code></td><td>布尔值</td><td>否</td><td>阻止页面脚本</td></tr><tr><td><code>expand_aio</code></td><td>布尔值</td><td>否</td><td>展开 AI Overview 模块，而不是以折叠状态返回它</td></tr><tr><td><code>filter</code></td><td>整数</td><td>否</td><td>Google 的重复内容过滤器。 <code>0</code> 关闭它并返回近似重复结果</td></tr><tr><td><code>fpstate</code></td><td>字符串</td><td>否</td><td>页面状态。按原样转发</td></tr><tr><td><code>hotel_classes</code></td><td>整数数组</td><td>否</td><td>要包含的星级，例如 <code>[4, 5]</code></td></tr><tr><td><code>hotel_dates</code></td><td>字符串</td><td>否</td><td>入住日期。没有它时，将使用 Google 的默认入住窗口</td></tr><tr><td><code>hotel_occupancy</code></td><td>整数</td><td>否</td><td>房间内的客人</td></tr><tr><td><code>limit</code></td><td>整数</td><td>否</td><td>要返回的结果数量</td></tr><tr><td><code>limit_per_page</code></td><td>对象数组</td><td>否</td><td>每页结果数量，例如 <code>[{"page": 1, "limit": 20}]</code>。替代 <code>pages</code> ，当只关心第 1 页时</td></tr><tr><td><code>locale</code></td><td>字符串</td><td>否</td><td>界面语言，例如 <code>en_US</code>。影响 SERP 功能的措辞，不影响排名</td></tr><tr><td><code>max_price</code></td><td>整数</td><td>否</td><td>要包含的最高价格，按商店货币计算</td></tr><tr><td><code>min_price</code></td><td>整数</td><td>否</td><td>要包含的最低价格，按商店货币计算</td></tr><tr><td><code>nfpr</code></td><td>字符串</td><td>否</td><td>禁止 Google 的拼写自动纠正</td></tr><tr><td><code>pages</code></td><td>整数</td><td>否</td><td>要连续获取的页数 <code>start_page</code>。每一页都是单独获取并计费</td></tr><tr><td><code>results_language</code></td><td>字符串</td><td>否</td><td>将结果限制为一种语言，例如 <code>lt</code>。只过滤，不翻译</td></tr><tr><td><code>safe_search</code></td><td>布尔值</td><td>否</td><td>Google 的 SafeSearch 过滤器。这里为布尔值，在 Bing 中为字符串</td></tr><tr><td><code>search_type</code></td><td>字符串</td><td>否</td><td>Trends 垂直领域，例如 web、image、news、YouTube 或 shopping</td></tr><tr><td><code>sort_by</code></td><td>字符串</td><td>否</td><td><code>r</code> 相关性（默认）， <code>rv</code> 评分从高到低， <code>p</code> 价格从低到高， <code>pd</code> 价格从高到低</td></tr><tr><td><code>start_page</code></td><td>整数</td><td>否</td><td>要获取的第一页。默认 <code>1</code></td></tr><tr><td><code>tbm</code></td><td>字符串</td><td>否</td><td>搜索垂直领域：图片、购物、视频、图书。按原样转发</td></tr><tr><td><code>tbs</code></td><td>字符串</td><td>否</td><td>时间和质量筛选器，例如过去 24 小时。按原样转发</td></tr><tr><td><code>udm</code></td><td>字符串</td><td>否</td><td>Google 的 UI 模式选择器。按原样转发</td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>自定义提取： <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用。覆盖内置解析器</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>请求来源的两字母国家代码。与 <code>domain</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>否</td><td>在捕获前执行页面 JavaScript。较慢——请使用 120 秒或更长的客户端超时</td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>

在 body 中或 URL 的 query string 中设置参数，不要同时设置两者。

### Bing

#### `POST /v1/scrape/bing/search`

返回某个查询的 Bing 自然结果。

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="139.5">名称</th><th width="93.5">类型</th><th width="97">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>query</code></td><td>字符串</td><td>是</td><td>搜索词</td></tr><tr><td><code>domain</code></td><td>字符串</td><td>否</td><td>Bing TLD</td></tr><tr><td><code>locale</code></td><td>字符串</td><td>否</td><td>界面语言，例如 <code>en_US</code></td></tr><tr><td><code>pages</code></td><td>整数</td><td>否</td><td>要连续获取的页数 <code>start_page</code>。每一页都是单独获取并计费</td></tr><tr><td><code>safe_search</code></td><td>字符串</td><td>否</td><td>安全搜索级别。这里为字符串，在 Google 中为布尔值</td></tr><tr><td><code>start_page</code></td><td>整数</td><td>否</td><td>要获取的第一页。默认 <code>1</code></td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>自定义提取： <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用。覆盖内置解析器</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>要获取的两字母国家代码，例如 <code>DE</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>否</td><td>在捕获前执行页面 JavaScript。较慢——请使用 120 秒或更长的客户端超时</td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>

#### `POST /v1/scrape/bing`

返回你提供的 URL 对应的 Bing 页面解析字段。

**模式：** `sync`, `async`, `batch`

<table><thead><tr><th width="134">名称</th><th width="97.5">类型</th><th width="92.5">必填</th><th>描述</th></tr></thead><tbody><tr><td><code>url</code></td><td>字符串</td><td>是</td><td>一个 Bing URL</td></tr><tr><td><code>locale</code></td><td>字符串</td><td>否</td><td>界面语言，例如 <code>en_US</code></td></tr><tr><td><code>输出</code></td><td>字符串数组</td><td>否</td><td>返回格式： <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>截图</code>。默认 <code>["html"]</code>. <code>JSON</code> 返回解析后的字段。 <code>截图</code> 需要 <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>对象</td><td>否</td><td>自定义提取： <code>{"prompt": string}</code> 或 <code>{"schema": object}</code>，不能同时使用。覆盖内置解析器</td></tr><tr><td><code>location</code></td><td>字符串</td><td>否</td><td>要获取的两字母国家代码，例如 <code>DE</code></td></tr><tr><td><code>device</code></td><td>字符串</td><td>否</td><td><code>desktop</code> （默认）或 <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>布尔值</td><td>否</td><td>在捕获前执行页面 JavaScript。较慢——请使用 120 秒或更长的客户端超时</td></tr><tr><td><code>callback_url</code></td><td>字符串</td><td>否</td><td>用于完成任务的 Webhook URL。仅限异步。格式错误的 URL 会被拒绝，返回 <code>400</code></td></tr><tr><td><code>storage</code></td><td>对象</td><td>否</td><td>将结果发送到存储桶，而不是响应： <code>{"type": string, "url": string}</code>. <code>type</code> 为 <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>，或 <code>tos</code>。仅限异步。 <code>url</code> 不做校验</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/api-reference/cn/zhuan-yong-zhua-qu-qi/sou-suo-yin-qing-zhua-qu-qi.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.