Brave Search API

the Brave Web Search API. It accepts query parameters like q, country, count, and others via GET request, forwards them to Brave’s search endpoint, and returns the JSON response. Ideal for integrating search results into your own applications

Brave 网页搜索应用程序编程接口（Brave Web Search API）。该接口支持通过GET请求传入q、country、count等查询参数，将其转发至Brave的搜索端点，并返回JSON格式的响应结果，非常适合将搜索结果集成至您的自有应用程序中。

原始信息汇总

Brave Search API 数据集概述

基本信息

• API名称: Brave Search API
• 提供商: Mahmudul Hasan
• 订阅人数: 1
• 类别: Search
• 流行度: 8.3
• 服务级别: 100%
• 延迟: 2214ms
• 版本: v1 (current)

定价计划

• BASIC: $0.00 / mo
• PRO: $10.00 / mo
• ULTRA: $49.00 / mo
• MEGA: $299.00 / mo

API概述

Brave Search API 提供对Brave隐私优先搜索引擎的编程访问，提供带有丰富元数据的网页和视频结果。专为开发者设计，可在应用程序、工具或研究项目中集成Brave的搜索功能，同时优先考虑用户隐私和数据透明度。

基础URL

https://brave-search-api3.p.rapidapi.com/search

认证

每个请求需包含以下头部：

• x-rapidapi-host: brave-search-api3.p.rapidapi.com
• x-rapidapi-key: 您的RapidAPI订阅密钥。

请求参数

参数	类型	是否必需	描述	示例
q	String	是	搜索查询（最多400字符，50个单词）。需URL编码。	q=dr%20muhammad%20yunus
country	String	否	使用ISO 2字母国家代码的区域结果。默认：US。	country=BD
count	Number	否	结果数量（最多20）。与offset结合用于分页。默认：20。	count=5
offset	String	否	分页偏移量。按count值递增以导航页面。	offset=1（当count=20时为第2页）
search_lang	String	否	结果语言（2+字符代码，如en表示英语）。	search_lang=es
ui_lang	String	否	用于本地化响应的UI语言（如en-US）。	ui_lang=fr-CA
safesearch	String	否	成人内容过滤：<br>- off: 不过滤<br>- moderate: 移除显式媒体<br>- strict: 阻止所有成人内容。	safesearch=strict
freshness	String	否	结果年龄过滤：<br>- pd: 过去24小时<br>- pw: 过去一周<br>- pm: 过去一个月<br>- py: 过去一年<br>- 自定义日期范围：2024-01-01to2024-03-30。	freshness=pw
text_decorations	Boolean	否	在摘要中高亮标记（如<em>query term</em>）。	text_decorations=true
spellcheck	Boolean	否	自动纠正查询。修改后的查询在query.altered中返回。	spellcheck=true
result_filter	String	否	过滤结果类型（逗号分隔）：<br>discussions, faq, infobox, news, videos, web, locations等。	result_filter=news,videos
goggles	Array	否	自定义排名规则（URL或JSON）。	goggles=https://example.com/goggle.json
units	String	否	测量系统：metric（公里，°C）或imperial（英里，°F）。默认根据区域偏好。	units=metric
extra_snippets	Boolean	否	为每个结果获取5个替代摘要。需要特定的RapidAPI计划。	extra_snippets=true
summary	Boolean	否	为网页结果生成摘要。在响应中启用summarizer。	summary=true

主要用例

1. 新闻聚合
   使用result_filter=news和freshness=pd获取突发新闻。
2. 本地化结果
   结合country=DE、search_lang=de和units=metric为德国用户提供服务。
3. 学术研究
   使用extra_snippets=true和text_decorations=true比较多个内容摘录。
4. 家庭友好应用
   启用safesearch=strict和result_filter=web,faq用于教育工具。

响应增强

• query对象:
  • altered: 如果spellcheck=true，返回修改后的查询。
  • is_news_breaking: 指示突发新闻相关性。
• web结果:
  • snippets: 当extra_snippets=true时，返回多个摘录。
  • summary: 如果summary=true，返回AI生成的摘要。
• videos结果:
  • duration: 时长（HH:MM:SS）。
  • views: 近似观看次数。

错误处理

• 400 Bad Request: 无效参数（如不支持的country代码）。
• 429 Too Many Requests: 超过速率限制。
• 500 Server Error: 使用指数退避重试。

搜集汇总

背景与挑战

背景概述

Brave Search API是一个隐私优先的搜索引擎API，提供网页和视频搜索结果的程序化访问，支持多种定制化参数和功能，适用于开发者集成到应用程序或研究项目中。