Google 新闻搜索
Google News 新闻 SERP,覆盖新闻检索及地区/语言定向参数。
本页给出 Google 新闻搜索 的字段定义、参数分组、必填约束以及可用过滤参数。
元数据
| 字段 | 值 |
|---|---|
| 引擎名称 | Google 新闻搜索 |
| 原始名称 | Google News Search |
| 内部标识(scraper) | google_news |
| 接口标识(engine) | google_news_search |
| 网站 | |
| 网站地址 | googlenews.com |
| 输出格式 | json |
| 版本 | 1.0.0 |
| 参数数量 | 3 |
| 参数分组 | 搜索词 (1), 地区与语言 (2) |
请求示例
下面的请求体是本次文档更新时实际用于验证 google_news 的请求。对于 /v1/serp,engine 字段应传当前引擎的 scraper 值。
curl -X POST "https://run.xcrawl.com/v1/serp" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"engine":"google_news","q":"AI"}'响应示例
下面的 JSON 片段来自同一次真实响应。为了避免页面被超长字段淹没,超长字符串、data URL 和大型数组做了裁剪。
{
"search_metadata": {
"cached": true,
"created_at": "2026-03-26 08:22:36 UTC",
"id": "01KMMKSV752TC2NJASSTKHERWS",
"json_endpoint": "https://serp.xcrawl.com/01KMMKSV752TC2NJASSTKHERWS.json",
"processed_at": "2026-03-26 08:22:36 UTC",
"raw_html_file": "https://serp.xcrawl.com/01KMMKSV752TC2NJASSTKHERWS.html",
"status": "completed",
"total_time_taken": 5
},
"search_parameters": {
"engine": "google_news",
"q": "AI"
},
"total_credits_used": 1,
"menu_links": [
{
"link": "https://news.google.com/topics/CAAqIggKIhxDQkFTRHdvSkwyMHZNRGxqTjNjd0VnSmxiaWdBUAE?hl=en-US&gl=US&ceid=US%3Aen",
"title": "U.S.",
"topic_token": "CAAqIggKIhxDQkFTRHdvSkwyMHZNRGxqTjNjd0VnSmxiaWdBUAE"
},
{
"_note": "8 more items omitted"
}
],
"news_results": [
{
"date": "2026-03-24T16:19:00Z",
"link": "https://news.google.com/read/CBMi1wFBVV95cUxQcHJCaG1oOHZ5OHBMSWRBNnVlTHNaWUp0MmdZdFhfYjdlVDlLN3hvdElZbzBoWjNTa3JBcF9XcmpxM2RPTk9XY29NNzRwUVF2LWVVV3I2VmhNZW9MaEl4MTFLTnJQeUoyV0tzblNVT3lwS21LNXdERVNxaW4tU3ZLb1JXWklMVjZhSmE... [truncated, 351 chars]",
"position": 0,
"source": {
"authors": [
{
"name": "Preston Fore"
}
],
"icon": "https://encrypted-tbn3.gstatic.com/faviconV2?url=https://fortune.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"name": "Fortune"
},
"thumbnail": "https://news.google.com/api/attachments/CC8iK0NnNHdhVkJ4VkhGcWRuVlFaM0JsVFJERUF4aW1CU2dLTWdhUldKaUhwZ2c=-w400-h224-p-df-rw",
"thumbnail_small": "https://news.google.com/api/attachments/CC8iK0NnNHdhVkJ4VkhGcWRuVlFaM0JsVFJERUF4aW1CU2dLTWdhUldKaUhwZ2c=-w200-h112-p-df-rw",
"title": "Palantir’s billionaire CEO says only two kinds of people will succeed in the AI era: trade workers — ‘or you’re neurodivergent’"
},
{
"_note": "101 more items omitted"
}
],
"related_publications": [
{
"link": "https://news.google.com/publications/CAAqIQgKIhtDQklTRGdnTWFnb0tDR0ZtYlM1aFpYSnZLQUFQAQ?hl=en-US&gl=US&ceid=US%3Aen",
"publication_token": "CAAqIQgKIhtDQklTRGdnTWFnb0tDR0ZtYlM1aFpYSnZLQUFQAQ",
"thumbnail": "https://encrypted-tbn3.gstatic.com/faviconV2?url=http://afm.aero&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"title": "AFM.aero"
}
]
}必填参数
以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填,以 properties.<field>.must 为准,不以顶层 required 数组为准。
| 参数 | 类型 | 分组 | 说明 |
|---|---|---|---|
q | string | 搜索词 | 你想让搜索引擎检索的关键词或短语。 |
可用参数
以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明;默认值、可选值等附加约束会列在每个分组后。
搜索词
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 是 | 你想让搜索引擎检索的关键词或短语。 |
地区与语言
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
gl | string | 否 | 用于本地化搜索结果的国家或地区代码。 |
hl | string | 否 | 用于控制搜索界面和结果标签语言的参数。 |
附加约束
gl:默认值:us;可选值:244 个可选值,例如:af、al、dz、as、adhl:默认值:en;可选值:157 个可选值,例如:af、ak、sq、ws、am
