主题
Google V2 SERP:图片搜索概览
本接口用于获取 Google 图片搜索(Images 标签页)的前 100 条自然搜索结果。可通过 /v3/serp/google/v2/live/advanced/ 获取结构化实时结果,或通过 /v3/serp/google/v2/live/html/ 获取原始 HTML 页面;标准异步模式则使用 /v3/serp/google/v2/task_post/ 提交任务,并通过 /v3/serp/google/v2/task_get/advanced/ 获取结果。
返回的数据与指定的、搜索引擎及地理位置,覆盖 Google 垂直搜索中的“图片”标签页结果。系统会尽可能模拟目标地区和搜索环境,以匹任务创建时该条件下的搜索结果。
可使用响应中的 check_url 在浏览器无痕模式下打开并核验搜索结果。请注意,系统不会模拟用户登录状态、搜索历史、个人偏好等个性化因素,因此返回结果不个性化排序影响。
> **注意:**Google 图片搜索支持桌面端结果。创建任务时可指定的操作系统 Windows 和 macOS。
可用接口
实时结构化结果
POST /v3/serp/google/v2/live/advanced/
返回指定、搜索引擎和地区下的 Google 图片搜索前 100 条结构化结果。结果通常图片在 SERP 中的位置、图片及来源页面 URL、标题以及搜索结果字段。
适用于需要同步获取图片搜索结果、即时展示或实时监控排名的场景。
实时 HTML 结果
POST /v3/serp/google/v2/live/html/
返回指定、搜索引擎和地区下 Google 图片搜索结果页的原始 HTML,最多 100 条结果。
适用于需要自行解析页面结构、提取未覆盖字段或保存原始页面快的场景。
数据获取方式
本接口支持实时(Live)和标准(Standard)两种结果获取方式。
Live 实时方式
Live 方式在单次请求中同步返回结果,无需额外轮询任务状态。
- 使用接口:
POST /v3/serp/google/v2/live/advanced/或POST /v3/serp/google/v2/live/html/ - 适用场景:需要即时返回数据的业务流程
- 特点:响应速度快,费用相对更高
Standard 标准方式
Standard 方式采用异步任务机制:提交任务,平台采集完成后再获取结果。
- 使用
POST /v3/serp/google/v2/task_post/提交任务; - 等任务完成;
- 使用
POST /v3/serp/google/v2/task_get/advanced/获取结构化结果。
与 Live 方式相比,Standard 方式的成本更低,适合不要求实时返回的批量采集任务。
创建任务时还可使用以下回调字段:
| 字段 | 说明 |
|---|---|
pingback_url | 任务完成后向指定地址发送完成通知。 |
postback_url | 任务完成后将结果直接推送至指定地址。使用该字段时,还指定结果获取类型,例如 advanced 或 html。 |
如果使用 Standard 方式且未设置 pingback_url 或 postback_url,可通过“Tasks Ready”接口获取已完成但尚未提取结果的任务 ID 列表,再使用对应的 Task GET 接口获取任务结果。
调用限制
| 限制项 | 说明 |
|---|---|
| P平台限流以认证说明中的 30/60/120 次/分钟规则为准 | |
| 单次 POST 请求任务数 | 最多 100 个任务 |
如需提高调用额度,请联系本平台技术支持。
任务优级与计费
Live 方式会实时返回结果,因此通常最高的计费标准。
Standard 方式支持以下两种任务优级:
normal:普通优级,适用于常规异步采集;high:高优级,可更快执行任务,费用相对更高。
depth 对计费的影响
depth 用于指定需要返回的结果数量。默认深度时,通常按结果区间向上取整计费。
例如,默认深度为 100:
- 指定
"depth": 100:按 100 条结果计费; - 指定
"depth": 150:按 200 条结果计费,即计费倍数为 2。
扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
实用场景
- 监控图片搜索排名:追踪品牌词、产品词或核心行业词在 Google 图片结果中的位置变化,及时发现图片 SEO 可见性波动。
- 挖掘竞品图片策略:采集竞品的图片结果,分析图片标题、落地页与素材布局,为优化提供依据。
- 优化电商商品素材:查询商品名称、型号和品类词的图片 SERP,识别高图片风格及页面特征,提升商品图片的自然搜索表现。
- 发现视觉机会:分析目标下的图片结果来源和主题分布,定位可新增的信息图、产品图或教程图片。
- 构建图片搜索监测报表:定期采集多个和地区的图片结果,生成图片排名、来源域名覆盖率及竞品占位趋势报表。