SeerMarTech API 文档

主题

Google 图片搜索 SERP：概览 ​

本组接口通过 POST /v3/serp/google/search_by_image/task_post/ 创建图片搜索任务，并通过 GET /v3/serp/google/search_by_image/task_get/advanced/ 获取结构化结果，或通过 GET /v3/serp/google/v2/task_get/html/ 获取原始 HTML。接口支持 desktop 设备类型。

功能简介 ​

本接口用于获取 Google Lens 针对指定图片返回的搜索结果。

返回结果与以下条件：

  • 指定的图片
  • 搜索引擎
  • 搜索位置
  • 任务创建时的搜索环境

接口将返回 Google Lens 可获取的搜索结果，以及与指定图片的。结构化结果通常搜索结果中的图片、排名位置、URL、标题及结果项。

本平台会尽可能准确地模拟指定的搜索位置和搜索引擎环境，使返回结果接近任务创建时该条件下的搜索结果。你可以在隐身模式下访问响应中的 check_url，核验结果是否符合预期。

> 用户偏好、搜索历史及个性化因素不会被纳模拟环境，因此不会反映在返回的 SERP 结果中。

可用接口 ​

获取结构化结果 ​

POST /v3/serp/google/search_by_image/task_post/

创建图片搜索任务。任务完成后，可通过任务获取接口查询结果，或使用回调地址接收通知和结果。

GET /v3/serp/google/search_by_image/task_get/advanced/

获取指定图片、搜索引擎和位置对应的前 100 条 Google 图片搜索结果及详细信息：

  • 结果排名
  • 图片或页面 URL
  • 标题
  • 结果类型
  • SERP 结果项

获取原始 HTML ​

GET /v3/serp/google/v2/task_get/html/

获取指定图片、搜索引擎和位置对应的 Google 图片搜索结果原始 HTML 页面。

设备限制 ​

Google 图片搜索接口支持：

text
desktop

不支持移动端设备类型。

任务执行方式 ​

本组接口支持 Standard（标准） 任务执行方式。使用该方式时，需要分别调用任务创建接口和结果获取接口。

型流程如下：

  1. 调用 POST /v3/serp/google/search_by_image/task_post/ 创建任务。
  2. 等任务完成。
  3. 调用 GET /v3/serp/google/search_by_image/task_get/advanced/ 获取结构化结果，或调用 GET /v3/serp/google/v2/task_get/html/ 获取原始 HTML。
  4. 根据返回的 check_url 对搜索结果进行人工核验。

使用回调地址 ​

创建任务时，可以指定以下字段：

  • pingback_url：任务完成后向指定地址发送完成通知。
  • postback_url：任务完成后向指定地址推送任务结果。

如果使用 postback_url，还需要指定要返回的结果类型：

  • advanced
  • html

查询已完成任务 ​

如果使用标准方式创建任务，且未设置 pingback_url 或 postback_url，可以通过 Tasks Ready 接口获取所有已完成但尚未领取的任务 ID。

获取任务 ID 后，再调用对应的 Task GET 接口获取任务结果。

调用限制 ​

平台限流以认证说明中的 30/60/120 次/分钟规则为准。

  • 每次 POST 请求最多提交 100 个任务。
  • 如需提高调用上限，请联系平台技术支持。

优级与计费 ​

标准任务方式支持以下两种执行优级：

  1. Normal：普通优级。
  2. High：高优级。

优级会影响任务的相对执行速度，且对应不同的计费标准。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

请求示例 ​

创建图片搜索任务 ​

bash
curl --location --request POST 'https://api.seermartech.cn/v3/serp/google/search_by_image/task_post/' \
  --header 'Authorization: Bearer smt_live_YOUR_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '[
    {
      "image_url": "https://example.com/image.jpg",
      "location_code": 2840,
      "language_code": "en",
      "device": "desktop",
      "priority": 1
    }
  ]'

> 上述请求展示了标准任务提交方式。可用字段及字段格式请以对应任务创建接口的参数定义为准。

获取结构化结果 ​

bash
curl --location --request GET 'https://api.seermartech.cn/v3/serp/google/search_by_image/task_get/advanced/TASK_ID' \
  --header 'Authorization: Bearer smt_live_YOUR_KEY'

获取原始 HTML ​

bash
curl --location --request GET 'https://api.seermartech.cn/v3/serp/google/v2/task_get/html/TASK_ID' \
  --header 'Authorization: Bearer smt_live_YOUR_KEY'

结果核验 ​

响应中可能 check_url 字段。建议使用浏览器隐身模式访问该地址，以便在不受登录状态、历史记录和个性化设置影响的，核对对应图片搜索结果。

核验时应重点：

  • 搜索位置是否正确
  • 图片搜索结果是否与目标图片匹
  • 结果排名是否符合预期
  • 返回结果与实时页面之间是否存在时间差异

实用场景 ​

  • 识别竞品图片的搜索：通过同一图片在不同地区获取 Google Lens 结果，评估竞品视觉素材的自然搜索覆盖范围。
  • 追踪品牌图片的外部引用：分析图片搜索结果中的页面 URL 和标题，发现未经授权的转载、镜像页面或品牌扩散渠道。
  • 验证图片 SEO 优化效果：定期检查核心产品图、封面图在图片搜索中的排名和，评估图片优化策略的表现。
  • 开展视觉竞品分析：比较相似产品图片在不同搜索位置下的结果分布，为产品、素材制作和落地页优化提供依据。
  • 采集图片搜索原始页面数据：获取原始 HTML 并结合自有解析流程，构建图片搜索结果监控、归档和变化检测系统。

统一入口：官网 · LLM API · 控制台

© 2026 SeerMarTech · GEO · SEO 营销数据 API