SerpBase

Google News Search — API 参考文档

POST
可调用
/google/news/search

新闻搜索

按主题或关键词搜索 Google 新闻。文章和发布者字段取决于上游结果。

type
news
result
news
计费
1 点

按主题或关键词搜索 Google 新闻。文章和发布者字段取决于上游结果。

参数
q
必填
string

必填

搜索查询字符串。

hl
可选
string

可选

语言代码，默认 en。

gl
可选
string

可选

国家代码，默认 us。

page
可选
number

可选

从 1 开始的页码，默认 1。

query
示例
string

目录示例；必填规则由接口校验。

示例: "semiconductor supply"

json
{
  "query": "semiconductor supply"
}
在 Playground 中调用
响应字段
query
必填
string

必填

请求中的标准化 query。

page
必填
number

必填

当前页码，从 1 开始。

news
可选
NewsResult[]

解析到新闻结果时返回。

Google 新闻结果。

NewsResult 结果项字段
rank
必填
number

必填

当前响应里的 1-based 排名。

position
可选
number

可用时作为 rank 的别名。

给客户端使用的标准化排名别名。

title
必填
string

必填

结果标题。

link
必填
string

必填

parser 返回的主链接。

url
可选
string

结果链接可归一化时返回。

规范化目标 URL，通常和 link 相同。

source_url
可选
string

只有观测到 Google 跳转/来源 URL 时返回。

保留的原始 Google URL，用于调试和溯源。

display_url
可选
string

当 Google 展示文本或域名可解析时返回。

展示 URL 或来源域名。

source
可选
string

解析到发布方文本时返回。

发布方或来源名称。

time
可选
string

Google 暴露时间文本时返回。

原始发布时间文本。

published_at
可选
string

解析到 time 时返回的发布时间别名。

标准化发布时间别名。

snippet
可选
string

解析到摘要时返回。

新闻摘要。

thumbnail_url
可选
string

Google 暴露缩略图时返回。

缩略图 URL。

thumbnail
可选
string

可用时作为 thumbnail_url 的别名。

标准化缩略图别名。

代码与响应示例
bash
curl -X POST 'https://api.serpbase.dev/google/news/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"semiconductor supply"}'
现有 Google 请求示例
bash
curl -X POST https://api.serpbase.dev/google/news/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "apple event",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
说明

品牌监控、趋势跟踪、媒体发现。

source 和 time 来自 Google 紧凑元数据文本，客户端应按可选字段处理。