Google 反向图片搜索

Google 反向图片搜索接口，使用 image_url 查询相似图片与来源页面。

本页给出 Google 反向图片搜索的字段定义、参数分组、必填约束以及可用过滤参数。

元数据

字段	值
引擎名称	Google 反向图片搜索
原始名称	Google Reverse Image Search
内部标识（scraper）	`google_reverse_image`
接口标识（engine）	`google_reverse_image`
网站	Google
网站地址	googlereverseimage.com
输出格式	`json`
版本	`1.0.0`
参数数量	`11`
参数分组	地区与语言 (4), 高级筛选 (2), 地理位置 (2), 分页 (1), 请求控制 (1), 高级参数 (1)

请求示例

下面的请求体是本次文档更新时实际用于验证 google_reverse_image 的请求。对于 /v1/serp，engine 字段应传当前引擎的 scraper 值。

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"google_reverse_image","image_url":"https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"}'

响应示例

下面的 JSON 片段来自同一次真实响应。为了避免页面被超长字段淹没，超长字符串、data URL 和大型数组做了裁剪。

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:19:38 UTC",
    "id": "01KMMKM8QE4TZ8YFFV9NKEJGVM",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKM8QE4TZ8YFFV9NKEJGVM.json",
    "processed_at": "2026-03-26 08:19:38 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKM8QE4TZ8YFFV9NKEJGVM.html",
    "status": "completed",
    "total_time_taken": 9
  },
  "search_parameters": {
    "engine": "google_reverse_image",
    "image_url": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"
  },
  "total_credits_used": 1,
  "image_results": [
    {
      "displayed_link": "https://www.google.com",
      "favicon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAMAAABEpIrGAAAA7VBMVEVHcE... [truncated data URL, 1046 chars]",
      "position": 1,
      "redirect_link": "https://www.google.com/",
      "snippet": "Search the world's information, including webpages, images, videos and more.Googlehas many special features to help you find exactly what you're looking ...",
      "source": "Google",
      "title": "Google"
    },
    {
      "_note": "6 more items omitted"
    }
  ],
  "image_sizes": [
    {
      "link": "https://www.google.com/search?sca_esv=3087728c2f704245&q=google&sa=X&ved=2ahUKEwia7ePbkL2TAxWkHkQIHXJxLZwQvQ56BAgJEAA",
      "title": "google"
    }
  ]
}

必填参数

以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填，以 properties.<field>.must 为准，不以顶层 required 数组为准。

参数	类型	分组	说明
`image_url`	`string`	高级参数	Image url 参数。

可用参数

以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明；默认值、可选值等附加约束会列在每个分组后。

地区与语言

参数	类型	必填	说明
`gl`	`string`	否	用于本地化搜索结果的国家或地区代码。
`hl`	`string`	否	用于控制搜索界面和结果标签语言的参数。
`lr`	`string`	否	将结果限制在一个或多个语言范围内。
`google_domain`	`string`	否	要请求的 Google 域名，例如 `google.com` 或 `google.co.uk`。

附加约束

gl：可选值：244 个可选值，例如：af、al、dz、as、ad
hl：可选值：157 个可选值，例如：af、ak、sq、ws、am
google_domain：可选值：185 个可选值，例如：google.com、google.ad、google.ae、google.com.af、google.com.ag

高级筛选

参数	类型	必填	说明
`tbs`	`string`	否	Google 的高级筛选字符串，常用于时间或内容过滤。
`safe`	`string`	否	用于控制成人内容过滤级别的安全搜索参数。

附加约束

safe：可选值：2 个可选值，例如：active、off

地理位置

参数	类型	必填	说明
`uule`	`string`	否	Google 使用的编码位置字符串，可用于更精细的地理定向。
`location`	`string`	否	用于让结果更贴近目标地区的地理位置提示。