Google Images

ERP API 谷歌 Images 查詢參數 使用 Thordata 的 SERP API 配置谷歌圖片搜尋，支援以下參數設定：

q ，搜索查詢(必填)

定義用於數據抓取的搜索查詢（默認值：q=pizza）。支持任何語言的任意關鍵詞。

示例請求：

使用q：pizza參數的示例

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"

本土化

google_domain， 域名（非必填）

定義用於資料抓取的搜尋引擎網域（預設值：google.com）。 您可在系統中修改此參數，或參考 Google 網域頁面 取得完整支援的網域列表。

示例請求：

查询q ：pizza ，url ：google.co.ao的示例結果

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"

gl ，國家（非必填）

指定搜尋結果的定位國家/地區（預設值：us）。採用兩位字母國家代碼（例如：us-美國，ru-俄羅斯，uk-英國）。 完整國家代碼支援清單請參閱：Google官方國家代碼表

示例請求：

查询 q ：pizza,gl：ru的示例結果

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"

hl ，語言（非必填）

設定搜尋結果的介面語言（預設值：en）。採用標準語言代碼格式（例如：en-英文，es-西班牙文，zh-CN-簡體中文）。 完整語言代碼支援清單請參閱：Google官方語言代碼表

示例請求：

查询q ：pizza,hl： es的示例結果

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"

cr，设置多个国家/地区(非必填)

限制結果至特定國家，使用 | 作為分隔符（例如：countryFR|countryDE）。

可與 gl 參數配使用以確保介面/內容語言一致。

gl 和 cr 參數可組合使用，但實際效果以cr 參數為優先。

示例請求：

查询q : pizza,cr: countryFR|countryDE的示例結果

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"

地理位置

location，地理位置(非必填)

模擬從精確位置發起搜尋（需搭配 uule 參數使用）。若未指定，系統可能採用代理伺服器的地理位置。

示例請求：

查询 q : pizza,location:India,uule:w+CAIQICIFSW5kaWE的示例結果

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"

uule ，編碼位置(非必填)

使用 Base64 編碼目標地理位置（需配合 location 參數使用）

示例請求：

查询 q : pizza,location:India,uule:w+CAIQICIFSW5kaWE的示例結果

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"

時間段

period_unit ，時間段（非必填）

定義搜尋最近圖像的時間段單位，例如，從過去的分鐘、小時、日期等。 s - 秒 n - 分鐘 h - 小時 d - 天 w - 週 m - 月 y - 年 此參數不能與start_date/end_date參數一起使用。

示例請求：

查詢 q : pizza,period_unit:h的示例

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"

period_value，時間段值（非必填）

定義一個可選的時間段值，該值可與 period_unit 一起使用，以描述 15 秒、42 小時、178 天等時間段。

示例請求：

查詢 q : pizza,period_value:178 day 的示例

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"

start_date ，開始日期（非必填）

定義要將圖像搜索限制到的時間段的開始日期。 格式：YYYYMMDD，例如：20250801 此參數不能與 period_unit/period_value 參數一起使用。

示例請求：

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

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 "start_date=20250801"

end_date ，結束日期（非必填）

定義要將圖像搜索限制到的時間段的開始日期。 格式：YYYYMMDD，例如：20250801 此參數不能與 period_unit/period_value 參數一起使用。

示例请求：

示例請求：

查詢 q : pizza,end_date:20250801 的示例

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"

高级参数

chips，圖像搜索篩選器 （替代）（非必填）

數用於篩選圖像搜索。

示例請求：

查詢 q : pizza,ludocid:size的示例

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"

tbs ，高級搜索條件（非必填）

時間/類型篩選（支持複雜條件），比如 tbs=qdr:d，qdr:d=24 小時內的內容；再比如 tbs=sur:f，表示結果僅展示圖片。

示例請求：

查詢 q : pizza,tbs:sur:f 的示例

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"

imgar，縱橫比過濾（非必填）

參數定義圖像的設置縱橫比。 選項： s - 方形 t - 高 w - 寬 xw - 全景

示例請求：

查詢 q : pizza,imgar:s 的示例

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"

imgsz ，圖像大小篩選（非必填）

參數定義圖像的大小。 選項： 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 的示例

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"

image_color ，圖像顔色過濾（非必填）

參數定義圖像的類型。 選項： bw - 黑白 trans - 透明 red - 紅色 orange - 橙色 yellow - 黃色 green - 綠色 teal - 青色 blue - 藍色 purple - 紫色 pink - 粉色 white - 白色 gray - 灰色 black - 黑色 brown - 棕色

示例請求：

查詢 q : pizza,imgcolor:red 的示例

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"

image_type，圖像類型篩選（非必填）

參數定義圖像類型。 選項： face - 人臉 photo - 照片 clipart - 剪貼畫 lineart - 線條畫 animated - 動畫

示例請求：

查詢 q : pizza,imgtype:face 的示例

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"

licenses ，使用權限篩選（非必填）

參數定義圖像的授權範圍。 選項： f - 免費使用或分享 fc - 免費使用或分享，甚至用於商業用途 fm - 免費使用、分享或修改 fmc - 免費使用、分享或修改，甚至用於商業用途 cl - 創用CC授權 ol - 商業及其他授權

示例請求：

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

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"

safe ，成人內容過濾（非必填）

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

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

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"

nfpr ，排除自動更正結果（非必填）

參數定義是否禁用自動糾正拼寫。 選項： nfpr=1 - 禁用自動糾正（嚴格匹配關鍵字） nfpr=0 - 啟用自動糾正（預設值）

示例請求：

查詢 q : pizza,nfpr:1 的示例

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"

filter ，結果篩選（非必填）

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

示例请求：

查询 q : pizza,filter:1 的示例

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"

分頁

ijn，頁碼（非必填）

参数定义分页偏移量（每页100张图片） 选项： start=N - 跳过前N张图片（N必须为100的倍数） *等效关系：页码ijn对应的偏移量=ijn×100*

示例请求：

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

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"

如需進一步幫助，請透過 [email protected] 聯繫我們。