Google 反向图片搜索
Google 反向图片搜索接口,使用 image_url 查询相似图片与来源页面。
本页给出 Google 反向图片搜索 的字段定义、参数分组、必填约束以及可用过滤参数。
元数据
| 字段 | 值 |
|---|---|
| 引擎名称 | Google 反向图片搜索 |
| 原始名称 | Google Reverse Image Search |
| 内部标识(scraper) | google_reverse_image |
| 接口标识(engine) | google_reverse_image |
| 网站 | |
| 网站地址 | 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、adhl:可选值:157 个可选值,例如:af、ak、sq、ws、amgoogle_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 | 否 | 用于让结果更贴近目标地区的地理位置提示。 |
附加约束
location:可选值:10 个可选值,例如:India、United States、Brazil、Indonesia、Mexico
分页
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
start | string | 否 | Google 风格分页使用的结果偏移量。 |
请求控制
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
no_cache | boolean | 否 | 跳过缓存结果并强制重新抓取。 |
附加约束
no_cache:默认值:false
高级参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
image_url | string | 是 | Image url 参数。 |
