SerpBase

Google Images Search — API 参考文档

POST
可调用
/google/image/search

图片搜索

按查询搜索 Google 图片与来源链接；返回链接不授予图片使用权。

type
images
result
images
计费
1 点

按查询搜索 Google 图片与来源链接；返回链接不授予图片使用权。

参数
q
必填
string

必填

搜索查询字符串。

hl
可选
string

可选

语言代码，默认 en。

gl
可选
string

可选

国家代码，默认 us。

page
可选
number

可选

从 1 开始的页码，默认 1。

query
示例
string

目录示例；必填规则由接口校验。

示例: "red pandas"

json
{
  "query": "red pandas"
}
在 Playground 中调用
响应字段
query
必填
string

必填

请求中的标准化 query。

page
必填
number

必填

当前页码，从 1 开始。

images
可选
ImageResult[]

解析到图片结果时返回。

Google 图片结果。

ImageResult 结果项字段
rank
必填
number

必填

当前响应里的 1-based 排名。

position
可选
number

可用时作为 rank 的别名。

给客户端使用的标准化排名别名。

title
可选
string

解析到图片标题或 alt 文本时返回。

结果标题。

link
必填
string

必填

parser 返回的主链接。

url
可选
string

结果链接可归一化时返回。

规范化目标 URL，通常和 link 相同。

source_url
可选
string

只有观测到 Google 跳转/来源 URL 时返回。

保留的原始 Google URL，用于调试和溯源。

display_url
可选
string

当 Google 展示文本或域名可解析时返回。

展示 URL 或来源域名。

image_url
必填
string

必填

完整图片 URL。

thumbnail_url
可选
string

Google 暴露缩略图时返回。

缩略图 URL。

thumbnail
可选
string

可用时作为 thumbnail_url 的别名。

标准化缩略图别名。

source
可选
string

解析到来源文本时返回。

图片来源名称。

domain
可选
string

能从来源页面解析域名时返回。

来源页面域名。

代码与响应示例
bash
curl -X POST 'https://api.serpbase.dev/google/image/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"red pandas"}'
现有 Google 请求示例
bash
curl -X POST https://api.serpbase.dev/google/image/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "iphone 15 pro blue",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
说明

视觉搜索、商品监控、图片来源发现。

Google 图片存在多种页面结构，有些样本只稳定暴露 rank/link，不一定都有 url、display_url、source_url、position、thumbnail 这些别名，客户端应按可选字段处理。