# SERP API Google 查询参数

了解 Thordata 的 SERP API - Google 搜索的查询参数。

**搜索词**\
示例：

```sh
curl -k "https://www.google.com/search?q=pizza" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="66">参数</th><th width="114">名称</th><th width="237">作用</th><th>参数值</th></tr></thead><tbody><tr><td>q</td><td>搜索词</td><td>指定搜索关键词</td><td>q=pizza</td></tr></tbody></table>

**本土化**\
用于指定搜索结果的语言和习惯。示例：

```sh
curl -k "https://www.google.ac/search?q=pizza&gl=af&hl=ach" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="66">参数</th><th width="106">名称</th><th width="247">作用</th><th>参数值</th></tr></thead><tbody><tr><td>hl</td><td>语言</td><td>指定搜索结果的界面语言</td><td>hl=en（英语），hl=zh-CN（简体中文）...</td></tr><tr><td>gl</td><td>国家</td><td>指定搜索结果按照该国家用户的习惯展示</td><td>gl=US（美国），gl=CN（中国）...</td></tr></tbody></table>

**地理位置**\
用于用户想要搜索的编码位置，会更改搜索地理位置。您可以在此处下载包含所有可用值的文件。示例：

```sh
curl -k "https://www.google.ac/search?q=pizza&uule=w+CAIQICIXS2FidWwsS2FidWwsQWZnaGFuaXN0YW4" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="66">参数</th><th width="104">名称</th><th width="271">作用</th><th>参数值</th></tr></thead><tbody><tr><td>uule</td><td>地理位置</td><td>指定基于坐标的精准地理位置 ( Base64编码 )</td><td>uule=w+CAIQICINVW5pdGVkIFN0YXRlcw      <a href="https://developers.google.com/google-ads/api/data/geotargets">下载地址</a></td></tr></tbody></table>

**搜索类型**\
用于定义搜索类型。常规搜索无需使用tbm参数，其他类型则具有唯一tbm值。示例：

```sh
curl -k "https://www.google.ac/search?q=pizza&tbm=isch" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="66">参数</th><th width="106">名称</th><th width="260">作用</th><th>参数值</th></tr></thead><tbody><tr><td>tbm</td><td>搜索类型</td><td>指定搜索类型</td><td>tbm=nws（新闻）<br>tbm=vid（视频）<br>tbm=isch（图片）<br>tbm=shop（购物）</td></tr></tbody></table>

**分页**\
用于定义结果偏移量（结果从选定值开始的偏移量）和要返回的结果数。示例：

```sh
curl -k "https://www.google.ac/search?q=pizza&start=10&num=100" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="66">参数</th><th width="120">名称</th><th width="250">作用</th><th>参数值</th></tr></thead><tbody><tr><td>start</td><td>分页</td><td>指定搜索页数（ 偏移量 ）</td><td>start=10（显示第 2 页）/00/10.../100</td></tr><tr><td>num</td><td>每页结果数</td><td>指定搜索结果每页结果数量</td><td>num=100（最多 100 条）1....100</td></tr></tbody></table>

**安全性**\
用于决定搜索结果是否屏蔽露骨等成人内容。示例：

```sh
curl -k "https://www.google.ac/search?q=pizza&safe=active" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="66">参数</th><th width="106">名称</th><th width="260">作用</th><th>参数值</th></tr></thead><tbody><tr><td>safe</td><td>安全</td><td>主要用于屏蔽露骨的成人内容（如色情、暴力等）</td><td>safe=active（安全搜索开启）<br>safe=off（关闭）</td></tr></tbody></table>

**解析**\
Thordata 自定义的参数，允许返回解析后的 JSON 而不是原始 HTML。示例：

```sh
curl -k "https://www.google.ac/search?q=pizza&json=1" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="66">参数</th><th width="106">名称</th><th width="260">作用</th><th>参数值</th></tr></thead><tbody><tr><td>json</td><td>解析</td><td>指定输出结果格式</td><td>无json值（返回HTML值）<br>json=1（返回JSON值）<br>json=2（返回JSON+HTML值）</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.thordata.com/doc/zh/pa-qu/serp-api/serp-api-google-cha-xun-can-shu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
