Google Lens 搜索

Google Lens 视觉搜索接口，使用图片 URL 作为输入参数。

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

元数据

字段	值
引擎名称	Google Lens 搜索
原始名称	Google Lens Search
内部标识（scraper）	`google_lens`
接口标识（engine）	`google_lens_search`
网站	Google
网站地址	googlelens.com
输出格式	`json`
版本	`1.0.0`
参数数量	`5`
参数分组	地区与语言 (2), 图片输入 (1), 高级参数 (1), 请求控制 (1)

请求示例

下面的请求体是本次文档更新时实际用于验证 google_lens 的请求。对于 /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_lens","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:52 UTC",
    "id": "01KMMKMM84QVKW53F8CATYGTN6",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKMM84QVKW53F8CATYGTN6.json",
    "processed_at": "2026-03-26 08:19:52 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKMM84QVKW53F8CATYGTN6.html",
    "status": "completed",
    "total_time_taken": 11
  },
  "search_parameters": {
    "engine": "google_lens",
    "url": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"
  },
  "total_credits_used": 1,
  "visual_matches": [
    {
      "link": "https://www.youtube.com/watch?v=RVUXtS1iFNM",
      "position": 1,
      "source": "YouTube",
      "source_icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAABr0lEQVRYhe... [truncated data URL, 674 chars]",
      "title": "Google unveils its new logo - YouTube"
    },
    {
      "_note": "58 more items omitted"
    }
  ]
}