主题
Google 新闻 SERP 概览
Google 新闻 SERP API 用于获取指定、搜索引擎与地理位置下的 Google「新闻」标签页搜索结果,单个任务最多可返回前 100 条结果。
本接口返回的是 Google 垂直搜索中「新闻」标签页的结果,不 news.google.com 子域名中的。平台会尽可能模拟指定的位置和搜索环境;可通过响应中的 check_url 在浏览器无痕模式下核验结果。用户个人偏好、搜索历史及个性化因素不会影响返回数据。
> Google 新闻 SERP 支持 desktop 设备类型,可指定的操作系统为 Windows 或 macOS。
可用接口
| 接口 | 方法 | 路径 | 说明 |
|---|---|---|---|
| 高级实时结果 | 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)
标准方式适用于无需即时返回结果、希望降低采集成本的场景。该方式分为两个步骤:
- 通过
POST /v3/serp/google/news/task_post/创建采集任务; - 任务完成后,通过
GET /v3/serp/google/news/task_get/advanced/获取结果。
创建任务时还可以以下回调字段:
pingback_url:任务完成后通知指定地址;postback_url:任务完成后主动将结果发送到指定地址。
使用 postback_url 时,还指定需要返回的数据类型,例如:
advancedhtml
如果未 pingback_url 或 postback_url,可通过「Tasks Ready」接口获取所有已完成但尚未提取的任务 ID,再调用对应的 Task GET 接口获取结果。
执行优级与计费
实时方式会在请求期间直接完成采集,因此通常最高的执行优级和计费标准。
标准方式支持以下两种执行优级:
normal:普通优级,适合非紧急任务;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 和投放提供参考。