用途:调用 Brave 新闻搜索接口,按关键词检索新闻文章。
主要能力:返回每条结果的标题、URL、描述、age(如“2 hours ago”)、page_age(ISO 发布时间)、缩略图、来源 profile(名称、URL、图标)等字段。支持 freshness 过滤(pd 过去 24 小时、pw 过去一周、pm 过去一月、py 过去一年,或 YYYY-MM-DDtoYYYY-MM-DD 自定义区间);country(两位国家代码或 ALL)、search_lang、ui_lang 多语言与地区;safesearch(默认 strict);count(1-50)、offset(0-9)分页;spellcheck、extra_snippets(每结果最多 5 段附加摘录)、operators、include_fetch_metadata。还支持 Goggles 自定义排序,可提升可信来源或舍弃指定来源,含托管(需 GitHub/GitLab 且注册)与内联两种方式。
使用方式:需在 https://api.search.brave.com 获取 API Key,请求头带 X-Subscription-Token。端点 GET/POST https://api.search.brave.com/res/v1/news/search。示例:curl -s "https://api.search.brave.com/res/v1/news/search?q=space+exploration" -H "Accept: application/json" -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"。q 必填,1-400 字符、最多 50 词。支持 site:、"精确短语"、-排除 等搜索符,operators=false 可关闭。
适用场景:突发新闻监控(freshness=pd)、自定义新闻源(Goggles)、历史新闻检索(日期范围)、多语言跨地区检索、数据管道(include_fetch_metadata=true 获取 fetched_content_timestamp)。
限制:需 API Key 且归入 Search 套餐;SafeSearch 默认 strict;分页 offset 上限 9;托管 Goggles 需满足格式与注册要求。具体计费与配额暂未提供。