---
id: brave-search
version: "0.2.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# brave-search — Brave Search API wrapper

License: unclear · Maintenance: active · Downloads: 88.2K/mo

## What it is and what it does

brave-search is a Python client for the Brave Search API, which provides privacy-preserving search results as an alternative to Google Search. The package wraps Brave's REST endpoints and returns structured data for web, news, and video results. It supports both synchronous and asynchronous request patterns, letting you choose based on your application's concurrency model.

Beyond basic search, the package includes convenience methods for extracting and aggregating data from results—downloading PDFs found in results, extracting product prices and review scores, and applying Brave Goggles (custom re-ranking rules) to alter result ordering. Configuration is straightforward: pass your API key as an environment variable or constructor argument, then call search() with your query and optional parameters like result count or country filter.

Use it for:

- Build a privacy-focused search application or metasearch tool that queries Brave instead of tracking-heavy alternatives.
- Extract and aggregate product pricing or review data from search results for price comparison or market research.
- Apply custom Goggles to re-rank search results for domain-specific queries (e.g., academic sources, thought leadership).
- Integrate privacy-preserving search into an async Python application without blocking I/O.
- Download and process PDFs discovered in search results for document research or archival workflows.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Wrapper for the Brave Search API that provides both synchronous and asynchronous access to privacy-preserving web, news, and video search results.

Yes, with conditions. The package is actively maintained, has low install friction, and fills a clear need for privacy-preserving search integration. However, the license is unclear—verify the actual terms before use in proprietary contexts. The note that it is 'under active development' suggests the API surface may change; pin your version if stability is critical. No known vulnerabilities and reasonable dependency choices make it safe to try.

## Install

pip install brave-search
uv add brave-search
poetry add brave-search

## Installing brave-search

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with recent commits and no known vulnerabilities. Six runtime dependencies (requests, httpx, tenacity, pydantic, pytest-asyncio, numpy) are all stable, widely-used packages.

License in practice: License status is unclear—no SPDX identifier or raw license text is recorded in the package metadata. Verify the actual license before use in proprietary or restricted contexts.

Quickstart:

pip install brave-search

from brave import Brave

brave = Brave()
search_results = brave.search(q="cobalt mining", count=10)
web_results = search_results.web_results

Requires a Brave API key, passed via BRAVE_API_KEY environment variable or as an argument to the Brave class.

Verify before relying:

- Whether the package is production-ready given the note 'under active development, functionality may change'.
- Actual license terms and compatibility with your use case (license metadata is unclear).
- Performance and rate-limit behavior under typical usage loads.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 88.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

brave search api wrapper, privacy search python, async web search, search results aggregation, brave api client, privacy-preserving search, search api integration, privacy-search, async-ready, api-wrapper

[View on SkillFed](https://skillfed.io/packages/brave-search) · [View on PyPI](https://pypi.org/project/brave-search/)