Skip to content

Google 新闻 SERP 概览

Google 新闻 SERP API 用于获取指定、搜索引擎与地理位置下的 Google「新闻」标签页搜索结果,单个任务最多可返回前 100 条结果。

本接口返回的是 Google 垂直搜索中「新闻」标签页的结果,不 news.google.com 子域名中的。平台会尽可能模拟指定的位置和搜索环境;可通过响应中的 check_url 在浏览器无痕模式下核验结果。用户个人偏好、搜索历史及个性化因素不会影响返回数据。

> Google 新闻 SERP 支持 desktop 设备类型,可指定的操作系统为 WindowsmacOS

可用接口

接口方法路径说明
高级实时结果POST/v3/serp/google/news/live/advanced/实时获取指定的前 100 条新闻搜索结果及完整结构化数据。
实时 HTML 结果POST/v3/serp/google/news/live/html/实时获取指定的 Google 新闻搜索结果原始 HTML 页面。
创建标准任务POST/v3/serp/google/news/task_post/提交异步新闻 SERP 采集任务。
获取高级任务结果GET/v3/serp/google/news/task_get/advanced/获取已完成任务的结构化高级结果。
获取已完成任务列表GET/v3/serp/google/news/tasks_ready/获取尚未提取结果的已完成任务 ID 列表。

所有 POST 请求的请求体均应为 JSON 数组,即使只提交一个任务也需要使用数组:

json
[
  {
    "keyword": "人工智能新闻",
    "location_name": "China",
    "language_code": "zh",
    "device": "desktop",
    "os": "Windows",
    "depth": 100
  }
]

认证请求头示例:

http
Authorization: Bearer smt_live_YOUR_KEY

数据获取方式

实时方式(Live)

实时方式适用于需要立即取得新闻搜索结果的场景。

使用实时接口时,只需发起一次 POST 请求,接口会在采集完成后直接返回结果,无需分别创建任务和查询任务结果。

  • 高级结构化数据:POST /v3/serp/google/news/live/advanced/
  • 原始 HTML 数据:POST /v3/serp/google/news/live/html/

实时方式的执行速度最快,计费通常高于标准方式。

标准方式(Standard)

标准方式适用于无需即时返回结果、希望降低采集成本的场景。该方式分为两个步骤:

  1. 通过 POST /v3/serp/google/news/task_post/ 创建采集任务;
  2. 任务完成后,通过 GET /v3/serp/google/news/task_get/advanced/ 获取结果。

创建任务时还可以以下回调字段:

  • pingback_url:任务完成后通知指定地址;
  • postback_url:任务完成后主动将结果发送到指定地址。

使用 postback_url 时,还指定需要返回的数据类型,例如:

  • advanced
  • html

如果未 pingback_urlpostback_url,可通过「Tasks Ready」接口获取所有已完成但尚未提取的任务 ID,再调用对应的 Task GET 接口获取结果。

执行优级与计费

实时方式会在请求期间直接完成采集,因此通常最高的执行优级和计费标准。

标准方式支持以下两种执行优级:

  1. normal:普通优级,适合非紧急任务;
  2. high:高优级,适合需要更快完成的异步任务。

depth 参数会影响任务费用。默认深度通常为 100 条结果;当设置的深度默认值时,将按每 100 条结果为一个计费单位向上取整。

例如,默认深度为 100 时:

json
[
  {
    "keyword": "人工智能新闻",
    "depth": 150
  }
]

该任务将按 200 条结果对应的计费单位计算。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用限制

Google 新闻 SERP 接口的 平台限流以认证说明中的 30/60/120 次/分钟规则为准。

每个 POST 请求最多可 100 个任务。批量提交任务时,请确保请求体为 JSON 数组。

结果核验

响应中通常会 check_url 字段,可将该地址复制到浏览器无痕模式中打开,以核验指定、位置和搜索环境下的新闻搜索结果。

由于搜索结果会随时间变化,且搜索引擎可能存在区域性展示差异,建议将接口结果视为任务创建时刻对应搜索环境下的采集快。

实用场景

  • 监测品牌新闻:追踪品牌名、产品名或高管姓名在新闻搜索结果中的出现频率,评估品牌与媒体传播效果。
  • 发现行业热点事件:按行业采集新闻结果,识别近期高频事件、政策变化和竞争动态,为选题提供依据。
  • 分析竞品媒体覆盖:查询竞争对手名称及核心产品词,统计新闻来源、报道时间和排名位置,衡量竞品声量。
  • 预警负面舆风险:持续监控“品牌名 + 投诉”“品牌名 + 争议”等,及时发现可能影响声誉的新闻。
  • 验证区域化新闻可见性:切换国家、城市及语言参数,对比同一在不同市场中的新闻结果,为本地化 SEO 和投放提供参考。

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