Google 图片搜索
Google 图片 SERP，支持图片检索、版权/尺寸/颜色等过滤参数。
本页给出 Google 图片搜索 的字段定义、参数分组、必填约束以及可用过滤参数。
元数据
| 字段 | 值 |
|---|---|
| 引擎名称 | Google 图片搜索 |
| 原始名称 | Google Images Search |
| 内部标识（scraper） | google_images |
| 接口标识（engine） | google_images_search |
| 网站 | |
| 网站地址 | googleimages.com |
| 输出格式 | json |
| 版本 | 1.0.0 |
| 参数数量 | 25 |
| 参数分组 | 搜索词 (1), 地区与语言 (4), 分页 (2), 高级筛选 (10), 地理位置 (2), 请求控制 (2), 时间范围 (4) |
必填参数
以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填，以 properties.<field>.must 为准，不以顶层 required 数组为准。
| 参数 | 类型 | 分组 | 说明 |
|---|---|---|---|
q | string | 搜索词 | 你想让搜索引擎检索的关键词或短语。 |
可用参数
以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明；默认值、可选值等附加约束会列在每个分组后。
搜索词
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 是 | 你想让搜索引擎检索的关键词或短语。 |
地区与语言
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
cr | string | 否 | 将结果限制在一个或多个国家范围内。 |
gl | string | 否 | 用于本地化搜索结果的国家或地区代码。 |
hl | string | 否 | 用于控制搜索界面和结果标签语言的参数。 |
google_domain | string | 否 | 要请求的 Google 域名，例如 google.com 或 google.co.uk。 |
附加约束
gl：默认值：us；可选值：244 个可选值，例如：af、al、dz、as、adhl：默认值：en；可选值：157 个可选值，例如：af、ak、sq、ws、amgoogle_domain：默认值：google.com；可选值：47 个可选值，例如：google.com、google.com.hk、google.co.uk、google.co.jp、google.us
分页
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
num | number | 否 | 希望返回的结果数量。 |
start | number | 否 | Google 风格分页使用的结果偏移量。 |
附加约束
num：默认值：0start：默认值：0
高级筛选
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
tbs | string | 否 | Google 的高级筛选字符串，常用于时间或内容过滤。 |
nfpr | boolean | 否 | 尽量关闭自动纠错结果，优先保留原始查询词。 |
safe | number | 否 | 用于控制成人内容过滤级别的安全搜索参数。 |
chips | string | 否 | 应用 Google 提供的图片建议筛选令牌。 |
imgar | string | 否 | 按长宽比筛选图片。 |
imgsz | string | 否 | 按尺寸或最低分辨率筛选图片。 |
filter | boolean | 否 | 控制是否启用相似结果或重复结果过滤。 |
licenses | string | 否 | 按使用权限筛选图片。 |
image_type | string | 否 | 按内容类型筛选图片，例如照片、人脸或剪贴画。 |
image_color | string | 否 | 按主色调或透明属性筛选图片。 |
附加约束
nfpr：默认值：falsesafe：默认值：1；可选值：2 个可选值，例如：1、2imgar：可选值：4 个可选值，例如：s、t、w、xwimgsz：可选值：17 个可选值，例如：l、m、i、qsvga、vgafilter：默认值：falselicenses：可选值：6 个可选值，例如：f、fc、fm、fmc、climage_type：可选值：5 个可选值，例如：face、photo、clipart、lineart、animatedimage_color：可选值：14 个可选值，例如：bw、trans、red、orange、yellow
地理位置
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
uule | string | 否 | Google 使用的编码位置字符串，可用于更精细的地理定向。 |
location | string | 否 | 用于让结果更贴近目标地区的地理位置提示。 |
附加约束
location：默认值：US；可选值：10 个可选值，例如：IN、US、BR、ID、MX
请求控制
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
device | string | 否 | 请求结果时使用的设备类型，例如桌面端或平板端。 |
no_cache | boolean | 否 | 跳过缓存结果并强制重新抓取。 |
附加约束
device：默认值：desktop；可选值：3 个可选值，例如：desktop、tablet、mobileno_cache：默认值：false
时间范围
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
end_date | string | 否 | 显式日期范围筛选的结束日期。 |
start_date | string | 否 | 显式日期范围筛选的开始日期。 |
period_unit | string | 否 | 与 period_value 搭配使用的时间单位，用于最近图片筛选。 |
period_value | string | 否 | 与 period_unit 搭配使用的数值时长。 |
附加约束
period_unit：可选值：7 个可选值，例如：Second、Minute、Hour、Day、Week