Google Images

SERP 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: countryAI|countryAQ的示例结果

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 ，编码位置(非必填)j

使用 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 - 大于 4 MP 4mp- 大于 6 MP 6mp- 大于 8mp8 MP - 大于 10 MP 10mp- 大于 12 12mpMP - 大于 15mp15 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,image_color:animated的示例

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,image_type: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- 知识共享许可 ol- 商业及其他许可

示例请求：

查询 q : pizza,licenses: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 ，通常情况下，Google会对露骨内容进行模糊处理。

示例请求：

查询 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 ，搜索“googl”不自动纠正为“google”

示例请求：

查询 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 ，结果筛选（非必填）

定义去重结果: 1 (启用), 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 (offset) = 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]联系我们。