# Google Images

**SERP  API 谷歌 Images 查询参数**

使用 Thordata的 SERP API 配置谷歌图片查询，包括本地化参数、地理位置、时间段、分页、以及“高级筛选”输出选项。

<details>

<summary><strong><code>q</code> ，搜索查询(必填)</strong></summary>

定义用于数据抓取的搜索查询（默认值：`q=pizza`）。支持任何语言的任意关键词。

**示例请求：**

使用`q`：<mark style="color:blue;">pizza</mark>参数的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1"
```

</details>

## 本土化

<details>

<summary><strong><code>google_domain</code>，域名(非必填)</strong></summary>

定义用于数据抓取的搜索引擎域名（默认值：google.com）。

您可在系统中修改此参数或参考[Google域名页面](https://domains.squarespace.com/)获取完整支持的域名列表。

**示例请求：**

查询  `q` ：<mark style="color:blue;">pizza</mark> ，`url` ：<mark style="color:blue;">google.co.ao</mark>的示例结果

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "google_domain=google.co.ao" \
 -d "json=1"
```

</details>

<details>

<summary><strong><code>gl</code> ，国家(非必填)</strong></summary>

指定搜索结果的定位国家/地区（默认值：`us`）。采用两位字母国家代码（如：`us`-美国，`ru`-俄罗斯，`uk`-英国）。

完整国家代码支持列表请参阅：[Google官方国家代码表](https://developers.google.com/adwords/api/docs/appendix/geotargeting)

**示例请求：**

查询 `q` ：<mark style="color:blue;">pizza</mark>,`gl`<mark style="color:blue;">：ru</mark>的示例结果

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "gl=ru" \
 -d "json=1"
```

</details>

<details>

<summary><strong><code>hl</code> ，语言(非必填)</strong></summary>

设置搜索结果的界面语言（默认值：`en`）。采用标准语言代码格式（如：`en`-英文，`es`-西班牙文，`zh-CN`-简体中文）。

完整语言代码支持列表请参阅：[Google官方语言代码表](https://developers.google.com/google-ads/api/docs/start)

**示例请求：**

查询`q` ：<mark style="color:blue;">pizza</mark>,`hl`： <mark style="color:blue;">es</mark>的示例结果

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"
```

</details>

<details>

<summary><strong><code>cr</code>，设置多个国家/地区(非必填)</strong></summary>

限制结果至特定国家，使用 `|` 作为分隔符（例如：`countryFR|countryDE`）。可与 `gl` 参数配合使用以确保界面/内容语言一致。

`gl` 和 `cr` 参数可组合使用，但实际效果以 `cr` 参数为优先。

**示例请求：**

查询`q` : <mark style="color:blue;">pizza</mark>,`cr`: <mark style="color:blue;">countryAI|countryAQ</mark>的示例结果

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "cr=countryAI|countryAQ"
```

</details>

## 地理位置

<details>

<summary><strong><code>location</code>，地理位置(非必填)</strong></summary>

模拟从精确位置发起搜索，必须与 **`uule`** 参数搭配使用。若未指定，则可能采用代理服务器的地理位置。

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`location`:<mark style="color:blue;">India</mark>,`uule`:<mark style="color:blue;">w+CAIQICIFSW5kaWE</mark>的示例结果

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"
```

</details>

<details>

<summary><strong><code>uule</code> ，</strong>编码位置<strong>(非必填)j</strong></summary>

使用 Base64 编码目标地理位置，需与 **`location`** 参数配合使用。

**示例请求：**

查询  `q` : <mark style="color:blue;">pizza</mark>,`location`:<mark style="color:blue;">India</mark>,`uule`:<mark style="color:blue;">w+CAIQICIFSW5kaWE</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"
```

</details>

## 时间段

<details>

<summary><strong><code>period_unit</code> ，时间段（非必填）</strong></summary>

定义搜索最近图像的时间段单位，例如，从过去的分钟、小时、日期等。

`s` - 秒

`n` - 分钟

`h` - 小时

`d` - 天

`w` - 周

`m` - 月

`y` - 年

此参数不能与`start_date/end_date`参数一起使用。

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`period_unit`:<mark style="color:blue;">h</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "period_unit=h"
```

</details>

<details>

<summary><strong><code>period_value</code>，时间段值（非必填）</strong></summary>

定义一个可选的时间段值，该值可与 `period_unit` 一起使用，以描述 15 秒 、42 小时 、178 天等时间段。

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`period_value`:<mark style="color:$primary;">178 day</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "period_value=178 day"
```

</details>

<details>

<summary><strong><code>start_date</code> ，开始日期（非必填）</strong></summary>

定义要将图像搜索限制到的时间段的开始日期 格式：YYYYMMDD 例如：20250801

此参数不能与`period_unit/period_value`参数一起使用。

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`start_date`:<mark style="color:$primary;">20250801</mark>的示例

<pre class="language-sh"><code class="lang-sh"><strong>curl -X POST https://scraperapi.thordata.com/request \
</strong> -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "start_date=20250801"
</code></pre>

</details>

<details>

<summary><strong><code>end_date</code> ，结束日期（非必填）</strong></summary>

定义要将图像搜索限制到的时间段的结束日期 格式：YYYYMMDD 例如：20250801

此参数不能与`period_unit/period_value`参数一起使用。

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`end_date`:20250801的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "end_date=20250801"
```

</details>

## 高级参数

<details>

<summary><strong><code>chips</code>，图像搜索筛选器 （替代）（非必填）</strong></summary>

参数用于筛选图像搜索。

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`ludocid`:<mark style="color:blue;">size</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "end_date=20250801" \
 -d "chips=size"
```

</details>

<details>

<summary><strong><code>tbs</code> ，高级搜索条件（非必填）</strong></summary>

时间/类型筛选（支持复杂条件），比如`tbs=qdr:d qdr:d=24`小时内的内容；再比如`tbs=sur:f`,表示结果仅展示图片

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`tbs`:<mark style="color:blue;">sur:f</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "tbs=sur:f"
```

</details>

<details>

<summary><strong><code>imgar</code>，纵横比过滤（非必填）</strong></summary>

参数定义图像的设置纵横比。

选项：

`s` - 方形

`t` - 高

`w` - 宽

`xw` - 全景

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,**`imgar`**:<mark style="color:blue;">s</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "imgar=s"
```

</details>

<details>

<summary><strong><code>imgsz</code> ，图像大小筛选（非必填）</strong></summary>

参数定义图像的大小。\
选项：\
`l` - 大\
`m`- 中\
`i`- 图标\
`qsvga`- 大于 400×300\
`vga`- 大于 640×480\
`svga`- 大于 800×600\
`xga`- 大于 1024×768\
`2mp`- 大于 2 MP - 大于 4 MP\
`4mp`- 大于 6 MP\
`6mp`- 大于\
`8mp`8 MP - 大于 10 MP\
`10mp`- 大于 12\
`12mp`MP - 大于\
`15mp`15 MP -\
`20mp`大于 20 MP\
`40mp`- 大于 40 MP\
`70mp`- 大于 70 MP

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,**`imgsz`**:<mark style="color:$primary;">qsvga</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "imgsz=qsvga"
```

</details>

<details>

<summary><strong><code>image_color</code> ，图像颜色过滤（非必填）</strong></summary>

定义图像的类型。

选项：\
`bw` - 黑白\
`trans`- 透明\
`red`- 红色\
`orange`- 橙色\
`yellow`- 黄色\
`green`- 绿色\
`teal`-青色\
`blue`- 蓝色\
`purple`- 紫色\
`pink`- 粉色\
`white`- 白色\
`gray`- 灰色\
`black`- 黑色\
`brown`- 棕色

**示例请求：**

查询  `q` : <mark style="color:blue;">pizza</mark>,**`image_color`**:<mark style="color:$success;">animated</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "image_type=animated"
```

</details>

<details>

<summary><strong><code>image_type</code>，图像类型筛选（非必填）</strong></summary>

参数定义图像类型。\
选项：\
`face` - 人脸\
`photo`- 照片\
`clipart`- 剪贴画\
`lineart`- 线条画\
`animated`- 动画

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`image_type`:face的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "image_type=face"
```

</details>

<details>

<summary><strong><code>licenses</code> ，使用权限筛选（非必填）</strong></summary>

参数定义图像的许可范围。\
选项：\
`f` - 免费使用或共享\
`fc`- 免费使用或共享，甚至用于商业用途\
`fm`- 免费使用、共享或修改\
`fmc`- 免费使用、共享或修改，甚至用于商业用途\
`cl`- 知识共享许可\
`ol`- 商业及其他许可

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`licenses`:<mark style="color:blue;">f</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "licenses=f"
```

</details>

<details>

<summary><strong><code>safe</code> ，</strong>成人内容过滤<strong>（非必填）</strong></summary>

该参数定义了搜索结果是否屏蔽成人内容。您可设置为 `active` 或者 `off` ，通常情况下，Google会对露骨内容进行模糊处理。

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`safe`:<mark style="color:blue;">active</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "safe=active"
```

</details>

<details>

<summary><strong><code>nfpr</code> ，排除自动更正结果（非必填）</strong></summary>

定义是否禁用自动纠正拼写，比如：`nfpr=1` ，搜索“googl”不自动纠正为“google”

**示例请求：**

查询  `q` : <mark style="color:blue;">pizza</mark>,`nfpr`:<mark style="color:blue;">1</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "nfpr=1"
```

</details>

<details>

<summary><strong><code>filter</code> ，结果筛选（非必填）</strong></summary>

定义去重结果: `1` (启用), `0` (禁用).

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`filter`:1的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "filter=1"
```

</details>

## 分页

<details>

<summary><code>ijn</code><strong>，页码（非必填）</strong></summary>

每页包含 100 张图片。此参数相当于`start (offset) = ijn * 100`。

**示例请求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`start`:<mark style="color:blue;">100</mark>的示例

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "ijn=100"
```

</details>

如果您需要更多帮助，请通过邮箱<support@thordata.com>联系我们。