对于开发者而言,Brave 搜索 API 最显著的特点是其独立于大型科技公司;它是为数不多的完全基于第一方索引提供搜索结果、无需抓取数据的公开搜索 API 之一。 它也是利用实时搜索结果对 AI 模型进行接地的首选方案。 鲜为人知的是,这款 API 同时也是一款功能强大新闻 API,可通过单一 REST 端点,以简单、程序化的方式从整个网络中提取最新的结构化新闻。 如果您正在开发新闻聚合器、媒体监测工具或需要实时更新的 AI 助手,Brave 的新闻 API 可以为您提供帮助。
本文详细介绍了 Brave 搜索 API 如何作为新闻 API 进行运作:专用新闻端点的功能、返回的内容、适用的使用场景,以及如何进行首次 API 调用。
什么是新闻 API?
新闻 API 是一项允许开发者通过 REST 端点查询并获取结构化 JSON 格式新闻文章的服务。 它支持根据关键词、日期、来源、语言和国家/地区筛选实时全球新闻,无需使用脆弱的自定义代码来抓取新闻网站。
Brave 搜索 API 包含一个专门的新闻 API
除了网页、图片和视频端点外,Brave 搜索 API 还提供一个位于 /news/search 的专门新闻搜索 API。 您发送一个查询请求和几个可选的筛选条件,API 就会返回近期相关新闻文章的纯净 JSON 数据。 每篇文章将包含标题、URL、来源、描述、发布日期以及(可选)额外内容摘录。
它甚至包含诸如 is_news_breaking 和 is_live 之类的属性,有助于呈现最新鲜的突发新闻。
但真正让 Brave 的新闻 API 与众不同的是其结果的来源。 Brave 依托其自身独立的第一方索引(涵盖超过 400 亿个网页),而非在查询时抓取其他搜索引擎的结果或新闻网站的内容。 对于新闻 API 而言,这种独立性意味着结果更加稳定,并且无需依赖可能更改或切断访问权限的第三方。
Brave 的新闻搜索 API 运行机制
使用新闻搜索 API 只需几个步骤:
- 发送查询:您向
/news/search端点发送请求,其中包含搜索词和您的 API 密钥。 查询内容可以是一个话题、一家公司、一个事件,或者任何您希望获取最新报道的内容。 - 按日期、国家/地区和语言筛选:可选参数可让您通过精确的查询筛选条件来缩小搜索结果范围,例如时间范围(例如过去 24 小时或过去一周)、目标国家/地区和语言。 正是这一点将广泛的搜索转化成为了有针对性的新闻推送。
- 获取结构化结果:该端点会返回结构化的 JSON 有效载荷——即一个包含一致字段的文章列表,您的代码可据此进行处理。 这个过程无需解析 HTML,也无需维护数据抓取功能;您获得的数据可直接用于存储、显示,或传递给模型以生成面向最终用户的答案。
- 为 AI 使用额外摘要:每个结果均可包含数段额外摘录,从而为模型在每篇文章中提供多个段落以供处理。 这使得新闻 API 非常适合于摘要和检索增强生成(RAG),因为较丰富的上下文有助于找到更好的答案。
实时新鲜度与全球覆盖
Brave Search 索引会持续爬取网络内容,并通过其 Web Discovery Project (WDP)定期获取真实用户的贡献。 这些索引构建机制确保了索引始终保持最新状态,从而使 Brave 搜索 API 成为一个真正的实时新闻 API,而非仅提供缓存内容的低效信息流。 “新鲜度”筛选条件可让您获取过去 24 小时内的突发新闻,关注过去一周内的某个话题,或设置自定义时间范围,按发布日期进行筛选。 无论您需要的是今早的头条新闻,还是特定日期范围内的报道,时间范围均可由您自行设定。
覆盖面既及时又广泛。 Brave 的新闻搜索结果涵盖多种语言的全球知名媒体,并内置了针对国家/地区和语言的定向功能。 正是这种广泛的覆盖面使其成为了一款现代化的报纸 API:您无需将各地的新闻源或传统新闻联合发布内容拼凑在一起,只需通过一个接口即可直接获取全球数字新闻编辑室的内容;它兼具支持学术研究所需的归档深度以及即时突发新闻的时效性,涵盖了不同地域和语言。
新闻 API 常见用例
Brave 新闻 API 适用于各种实际项目,包括:
- 新闻聚合管道:构建一个新闻聚合器,抓取全球多语言新闻报道,并根据您的受众重新排序。 借助 Goggles,您还可以在查询时提升可信域名的权重或过滤其他域名,因此新闻聚合 API 的扩展功能是该平台原生支持的,而非事后附加的。
- 媒体监测:几乎实时地跨媒体平台追踪某个品牌、人物或话题,并利用时效性筛选功能,在相关报道发布的第一时间立即捕捉到最新动态。
- 趋势与时事分析:将结构化文章导入分析工具或仪表盘,以追踪新闻事件的发展动态。
- 研究与档案:利用日期筛选功能,研究针对某一主题的报道随时间推移发生的变化。
- AI 接地:向模型提供最新且可引用的新闻,使其给出的答案能反映当前的世界状况,而不仅仅局限于其训练数据。
隐私与独立性
Brave 的品牌承诺(隐私、独立性以及始终将用户放在首位)同样适用于 Brave 自己的新闻 API。 由于搜索结果源自第一方独立网络索引而非抓取,Brave 搜索 API 能够实现真正的零数据留存 (ZDR) 和更纯净的合规性。 当您的新闻 API 部署在受监管的产品或企业数据管道中时,这一点尤为重要;此外,“独立性”还意味着您的新闻源不受第三方条款的制约:为面向最终用户的 Brave 搜索引擎提供支持的同一套索引,也同样支撑着您的新闻 API 结果。
开始使用:您的新闻 API 密钥和首次请求
您只需几分钟即可开始使用。
- 获取新闻 API 密钥:在 Brave 搜索 API 控制面板 上注册并生成一个密钥。 每个套餐都包含每月 5 美元的免费额度,足以在您决定购买付费套餐前进行原型开发,这使其成为了真正适合开发者的免费新闻 API。
- 调用新闻搜索 API:向
/news/search发送包含您的查询和任何过滤条件的请求。
例如,使用 cURL 发送的极简请求示例如下:
curl "https://api.search.brave.com/res/v1/news/search?q=climate+summit&freshness=pd" \
-H "Accept: application/json" \
-H "X-Subscription-Token: <YOUR_API_KEY>"使用 Python 调用新闻 API 同样十分简短。 下方示例导入了 requests 库,将您的过滤条件作为参数传递,执行状态码检查,并通过 response.json() 解析 JSON 数据负载:
import requests
url = "https://api.search.brave.com/res/v1/news/search"
params = {"q": "artificial intelligence", "freshness": "pw", "country": "us"}
headers = {
"Accept": "application/json",
"X-Subscription-Token": "<YOUR_API_KEY>",
}
response = requests.get(url, params=params, headers=headers)
print(response.status_code) # 200 on success
data = response.json() # structured JSON payload
for article in data["results"]:
print(article["title"], article["url"])在此处,您可以调整查询筛选条件(时效性、国家/地区、语言),请求额外的摘要以获取更丰富的上下文信息,并使用 Goggles 重新排序。 而且,您可以在 Brave 独立索引的同一个低延迟 REST 端点上完成所有这些操作。
为什么 Brave 搜索 API 能作为新闻 API 使用
Brave 搜索 API 不仅仅是一个网络搜索工具:它是一个基于独立索引构建的实时、全球性且尊重隐私的新闻 API。 它提供结构化、可直接用于 AI 处理的搜索结果,涵盖全球多种语言的权威媒体,支持按日期、国家/地区和语言进行精确筛选,且数据源自值得信赖的第一方来源。 对于希望获取最新新闻数据,同时又不想进行数据抓取,也不愿将控制权交给第三方的团队而言,Brave 搜索 API 是完成此任务的最佳新闻 API。
准备好构建了吗? 欢迎探索 Brave 搜索 API,并使用您每月的免费额度试用新闻端点。
常见问题解答
Brave 提供免费的新闻 API 吗?
从某种意义上说,是的。 每个 Brave 搜索 API 套餐均包含每月 5 美元的免费额度,并提供可自定义的使用限额设置,确保您的每月使用量不超过该套餐包含的 5 美元免费额度。 这使得这款新闻 API 实际上可以作为一款免费的新闻 API,供希望免费构建原型的开发者使用。
Brave 的新闻 API 是实时的吗?
是. 由于 Brave 搜索会持续爬取网络内容,并通过 Web Discovery Project 接收来自真实浏览器用户的匿名贡献,因此 Brave 搜索新闻 API 能够作为实时新闻 API 运行,通常在热点事件在线出现后的几分钟内即可完成更新。 该 API 具备时效性筛选功能,支持获取过去 24 小时、过去一周或自定义时间范围内的相关报道。
我如何使用 Brave 搜索新闻 API 构建一个新闻聚合器?
如要使用 Brave 搜索新闻 API 构建新闻聚合器,您只需向 /news/search 发送查询请求,并设置国家/地区和语言筛选条件以实现广泛覆盖,然后使用 Goggles 根据首选网站对搜索结果进行重新排序。
Brave 能作为报纸 API 使用吗?
是. 凭借对全球媒体的覆盖以及支持按日期筛选以挖掘历史资料的能力,Brave 搜索 API 既可用于获取突发新闻,也能满足历史研究的需求,从而作为报纸 API 发挥作用。
我可以用 Python 调用新闻 API 吗?
是. 正如本页前面展示的 Python 示例那样,您只需几行使用 requests 库的代码,即可查询 API 端点并解析 JSON 数据负载。
是否有官方的 Google 新闻 API?
否. 由于 Google 并未提供官方的 Google 新闻 API,因此开发者通常会借助第三方工具获取 Google 新闻数据,和/或使用基于爬虫的 API。 Brave 搜索 API 是一款第一方替代方案,可直接从其自身的索引中提供新闻内容。
搜索 API 如何向 AI 提供有关时事的上下文信息?
由于 AI 模型是在一个固定的截止日期之前进行训练的,因此它们无法独立、可靠地回答有关时事的问题。 搜索 API 填补了这一空白:它能在查询时检索到最新的结构化新闻,从而为模型提供关于时事的最新上下文信息,因此其回答能反映当下正在发生的事情,而不仅仅是训练期间所学到的内容。 正因如此,像 Brave 搜索 API 这样的新闻 API 自然成为了接地和检索增强生成 (RAG) 的基石。