# Google Images

**ERP 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;">countryFR|countryDE</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>的示例結果

```
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>(非必填)</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參數一起使用。&#x20;

**示例請求：**

&#x20;查詢 `q` : pizza,`period_unit`:h的示例

```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` : pizza,`period_value`:178 day 的示例

```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` 參數一起使用。&#x20;

**示例請求：**&#x20;

查詢 `q` : pizza,`start_date`:20250801 的示例

<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` 參數一起使用。&#x20;

**示例请求：**

**示例請求：**&#x20;

查詢 `q` : pizza,`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` : pizza`,ludocid`:size的示例

```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` : pizza,`tbs`:sur:f 的示例

```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` : pizza,`imgar`:s 的示例

```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
\
`4mp` - 大於 4 MP
\
`6mp` - 大於 6 MP
\
`8mp` - 大於 8 MP
\
`10mp` - 大於 10 MP
\
`12mp` - 大於 12 MP
\
`15mp` - 大於 15 MP
\
`20mp` - 大於 20 MP
\
`40mp` - 大於 40 MP
\
`70mp` - 大於 70 MP

\
**示例請求：**

\
查詢 `q` : pizza,`imgsz`:qsvga 的示例

```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` : pizza,`imgcolor`:red 的示例

```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` : pizza,`imgtype`: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` - 創用CC授權\
`ol` - 商業及其他授權

**示例請求：**

\
查詢 `q` : pizza,`rights`:f 的示例

```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></summary>

參數定義是否過濾成人內容。\
選項：\
`active` - 啟用安全搜尋（屏蔽成人內容）\
`off` - 關閉安全搜尋

示例請求：\
查詢 `q` : pizza`,safe`:active 的示例

```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` - 禁用自動糾正（嚴格匹配關鍵字）\
`nfpr=0` - 啟用自動糾正（預設值）

**示例請求：**

\
查詢 `q : pizza,nfpr: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 "nfpr=1"
```

</details>

<details>

<summary><strong><code>filter</code> ，結果篩選（非必填）</strong></summary>

**参数定义搜索结果去重功能**\
选项：\
`filter=1` - 启用去重（移除相似结果）\
`filter=0` - 禁用去重（显示所有结果）

**示例请求：**

\
查询 `q : pizza,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=N` - 跳过前N张图片（N必须为100的倍数）\
\*等效关系：页码ijn对应的偏移量=ijn×100\*

**示例请求：**

\
查询 `q : pizza,start:100` 的示例

```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>** 聯繫我們。


---

# 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-hk/pa-qu/serp-api/cha-xun-can-shu/gu-ge/google-images.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.