您需要发布一个功能,以提取最新的、特定部分的新闻(例如:“技术 → 人工智能”或“世界 → 中东”),而无需构建自定义抓取器或处理多个源。在本文结束时,您将确切知道要调用哪个端点以按部分提取主题新闻,如何按国家和语言进行过滤,以及如何使用可复制粘贴的 curl 或 Python 代码将其集成到您的应用中。
此 API 的功能及其用途
Zyla API Hub 上的实时新闻数据 API 提供了可以通过三种方式查询的结构化新闻数据:
- 搜索:基于关键字的新闻文章搜索。
- 头条新闻:按国家(可选语言/限制)获取最新头条故事。
- 按部分主题新闻:特定主题(例如,技术)或出版物(例如,CNN、BBC)内的文章。
这些端点返回标准化字段,如标题、链接、摘要、媒体 URL、作者、来源详细信息和 UTC 时间戳。典型的用例包括个性化新闻小部件、编辑仪表板、自动警报或内容推荐系统的丰富。
如果您是 Zyla 的新用户,它是一个拥有超过 10,000 个公共 API 的 API 市场,并提供一种标准化的身份验证和订阅方式。您可以直接在 Zyla API Hub 上浏览类别和提供者,然后将相同的 API 密钥插入您订阅的任何列表中。
在 Zyla API Hub 上入门
打开实时新闻数据 API 页面并开始试用。Zyla 使用订阅 + 配额模型(不是按调用付费)。对于您的第一个 API,您可以开始 7 天的试用或 50 次请求。没有免费计划。订阅后,您将收到一个可在此 API 的端点中使用的 API 密钥。
- 前往列表: 在实时新闻数据 API 上开始 7 天的试用
- 点击订阅(或如果可用则点击开始免费试用)并获取您的 API 密钥。
- 在每个请求中使用 Authorization: Bearer YOUR_API_KEY。
需要稍后评估其他数据集吗?您可以在 zylalabs.com 上使用相同的帐户和标准身份验证浏览和订阅更多列表。
您将使用的端点
1) 按部分主题新闻
使用此功能获取特定主题(如“世界、体育、技术”)或出版物(如 CNN、BBC)内的文章。这是实现“按部分主题新闻的 API”的最直接方式。
- 方法:GET
- URL:https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section
- 描述:获取特定主题(世界、体育、技术等)或出版物(CNN、BBC 等)内的新闻文章。
- 请求参数:
- topic(字符串,必填):例如,TECHNOLOGY
- section(字符串,必填):不透明的部分标识符
- limit(数字,可选):例如,500
- country(字符串,可选):例如,US
- language(字符串,可选):例如,en
示例 curl(复制粘贴并替换 YOUR_API_KEY):
curl -s -X GET "https://zylalabs.com/api/7339/real-time-news-data-api/11653/search?query=Elon+Musk" \
-H "Authorization: Bearer YOUR_API_KEY"
注意:
- published_datetime_utc 值为 ISO-8601 时间戳,采用 UTC 格式。
- 如果您需要本地化部分或想要缩小结果范围,请按国家和语言进行过滤。
- 部分参数是必需的不透明标识符。使用您打算针对所选主题或出版物的值。
2) 搜索
通过搜索词查找文章。对于验证基于部分的源或填补关键字匹配内容的空白非常有用。
- 方法:GET
- URL:https://zylalabs.com/api/7339/real-time-news-data-api/11653/search
- 描述:通过查询搜索新闻文章,并可以选择将结果限制在特定时间范围内。
- 请求参数:
- query(字符串,必填):例如,Elon Musk
官方示例 curl(准确复制粘贴):
官方响应示例(您可以解析的字段,如标题、链接、published_datetime_utc、作者、source_name):
{
"status": "OK",
"request_id": "1254b56e-7238-4807-9fa7-bd9256c0b66c",
"data": [
{
"title": "‘PayPal 黑手党’的根源如何延伸到南非种族隔离",
"link": "https://www.theguardian.com/technology/2025/jan/26/elon-musk-peter-thiel-apartheid-south-africa",
"snippet": "马斯克是与南非白人统治下的自由主义亿万富翁的“PayPal 黑手党”一部分,现在在美国科技界影响巨大……",
"photo_url": "https://i.guim.co.uk/img/media/01d10e660767815cd5799030b4ff658664343b13/1_0_2998_1800/master/2998.jpg?width=465&dpr=1&s=none&crop=none",
"thumbnail_url": "https://news.google.com/api/attachments/CC8iL0NnNXphbFpzWm10S09YQnVSWGxTVFJDWEFoalJBeWdLTWdrQklKcEdIcWtXWndJ=-w200-h200-p-df-rw",
"published_datetime_utc": "2025-01-26T16:00:00.000Z",
"authors": [
"Chris McGreal"
],
"source_url": "https://www.theguardian.com",
"source_name": "卫报",
"source_logo_url": "https://lh3.googleusercontent.com/SU8FywVNtcrG-wgjvZ_0D1-3JR_pN9LNSgjULFH74N748KVyEdkF1jdbvP4Lr7_ClbPZxL-iPw",
"source_favicon_url": "https://encrypted-tbn0.gstatic.com/faviconV2?url=https://www.theguardian.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"source_publication_id": "CAAqBggKMJeqezDfswk",
"related_topics": [
{
"topic_id": "CAAqIggKIhxDQkFTRHdvSkwyMHZNR1ppWm13MUVnSmxiaWdBUAE",
"topic_name": "Chris McGreal"
}
]
},
{
"title": "比尔·盖茨表示,他认为允许埃隆·马斯克在其他国家“破坏”政治是“疯狂的”",
"link": "https://www.businessinsider.com/gates-its-insane-that-musk-can-destabilize-foreign-politics-2025-1",
"snippet": "比尔·盖茨不喜欢埃隆·马斯克如何参与英国和德国等外国的政治。",
"photo_url": "https://i.insider.com/679751e2eb4be2fff9a22f97?width=700",
"thumbnail_url": "https://news.google.com/api/attachments/CC8iI0NnNVpaRXhyYlRkVE9WRXhTbnB3VFJEZ0F4aUFCU2dLTWdB=-w200-h200-p-df-rw",
"published_datetime_utc": "2025-01-27T09:36:00.000Z",
"authors": [
"Kevin Tan"
],
"source_url": "https://www.businessinsider.com",
"source_name": "商业内幕",
"source_logo_url": "https://lh3.googleusercontent.com/MD0yHuvt1mX8YyHUcdTCsQqMKGubFCwbWmpxzkT1xnE5wZ4aDRmb2zvkgfgG_b0mHNhaSxqO2A",
"source_favicon_url": "https://encrypted-tbn3.gstatic.com/faviconV2?url=https://www.businessinsider.com&c…
您可能会使用的字段说明:
- title、link、snippet:用于渲染卡片或预览。
- photo_url、thumbnail_url:可用时的图像资产。
- published_datetime_utc:您可以转换为当地时间的 ISO-8601 UTC 时间戳。
- authors、source_name:归属和标记。
3) 头条新闻
快速按国家获取最新头条新闻,带有可选的语言和限制参数。
- 方法:GET
- URL:https://zylalabs.com/api/7339/real-time-news-data-api/11654/top-headlines
- 描述:获取某个国家的最新新闻头条/头条故事。
- 请求参数:
- limit(数字,可选):例如,500
- country(字符串,可选):例如,US
- lang(字符串,可选):例如,en
示例 curl:
Python 示例:按部分提取主题新闻
此脚本调用按部分主题新闻端点,然后打印基本字段。将 YOUR_API_KEY 替换为您的密钥,并根据您的用例调整主题/部分/国家/语言。
import os
import requests
API_KEY = os.getenv("ZylaApiKey", "YOUR_API_KEY")
url = "https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section"
params = {
"topic": "TECHNOLOGY",
"section": "CAQiSkNCQVNNUW9JTDIwdk1EZGpNWFlTQldWdUxVZENHZ0pKVENJT0NBUWFDZ29JTDIwdk1ETnliSFFxQ2hJSUwyMHZNRE55YkhRb0FBKi4IACoqCAoiJENCQVNGUW9JTDIwdk1EZGpNWFlTQldWdUxVZENHZ0pKVENnQVABUAE",
"limit": 50,
"country": "US",
"language": "en",
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
if data.get("status") == "OK":
for item in data.get("data", []):
title = item.get("title")
link = item.get("link")
published = item.get("published_datetime_utc")
source = item.get("source_name")
print(f"[{published}] {title} — {source} :: {link}")
else:
print("非 OK 状态:", data)
实施提示:
- 根据您的 UI 需求缓存响应,以避免用户频繁刷新时的冗余提取。
- 遵循订阅 + 配额模型;避免在每次页面查看时进行不必要的轮询。根据需要在服务器端进行扩展。
- 时间戳为 UTC;在您的 API/服务层中进行一次转换,以防止客户端上重复的时区逻辑。
您本周可以部署的实际用例
- 主题着陆页:通过按部分主题新闻端点驱动“技术 → 人工智能”或“体育 → 足球”部分,并使用国家/语言过滤器进行本地化。
- 编辑补充:当某个部分的故事少于预期时,运行搜索作为特定关键字的后备,并将结果合并到源中。
- 市场/行业监控:将技术部分文章与搜索结合,针对命名公司为投资者仪表板提供支持。
- 警报/通知:轮询与您的用户相关的部分,并在新文章出现时推送更新(将链接或标题与您最后看到的集合进行比较)。
从 AI 代理调用 API(MCP)
您还可以通过与 MCP 兼容的客户端(例如,Claude Code、Cursor、Windsurf)使用 MCP 端点调用 Zyla API。将您的代理或工具指向:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
从那里,发出与上面显示的相同的 HTTP GET 请求,并带有授权头。有关 MCP 传输的更多信息,请参见 MCP。
节省时间的操作细节
- 身份验证:在每个请求中使用 HTTP 头 Authorization: Bearer YOUR_API_KEY。
- 时间戳:published_datetime_utc 采用 UTC(ISO-8601)格式。尽早在您的管道中进行标准化。
- 过滤:对于按部分主题新闻,主题和部分是必需的。国家和语言是可选的细化;使用限制来限制有效负载大小。
- 配额:Zyla 计费为订阅 + 配额。对于第一个 API,您可以开始 7 天的试用或 50 次请求。试用后,请查看 API 页面以获取当前访问选项和定价。
- 数据模型:文章对象包括 source_name、source_url 和作者列表,以支持您 UI 中的适当归属。
端到端流程以发布功能
- 开始实时新闻数据 API 的试用并获取您的 API 密钥: 在实时新闻数据 API 上开始 7 天的试用。
- 选择您想要支持的主题和部分标识符(例如,TECHNOLOGY + 所需的部分值)。
- 在服务器端调用按部分主题新闻端点,使用 Authorization: Bearer YOUR_API_KEY。
- 渲染标题、链接、摘要、photo_url/thumbnail_url 和 source_name。将 published_datetime_utc 转换为用户的时区。
- 在您的端添加轻量级缓存或 ETag 等效项,以消除刷新时的冗余调用。
- 可选地,分层搜索以填补空白或通过关键字创建深入分析。
常见问题
我如何进行身份验证?
在每个请求中包含头 Authorization: Bearer YOUR_API_KEY。
哪个端点返回按部分主题新闻?
GET https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section,带有必需的主题和部分参数。可选参数包括限制、国家和语言。
出版日期的时区是什么?
published_datetime_utc 以 UTC(ISO-8601)格式提供。根据需要在客户端或服务器层中进行转换。
我可以按国家获取一般头条新闻吗?
可以。使用 GET https://zylalabs.com/api/7339/real-time-news-data-api/11654/top-headlines,带有可选的限制、国家和语言参数。
我如何从 AI 代码助手或代理调用此功能?
在与 MCP 兼容的客户端中使用 MCP 传输,网址为 https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY,然后发出相同的 GET 请求,并带有授权头。请参见 MCP。
准备好今天实现基于部分的新闻吗?开始您的试用,获取您的密钥,并在此处插入按部分主题新闻的端点: 在实时新闻数据 API 上开始 7 天的试用。