---
id: brave-search-python-client
version: "0.4.27"
license: MIT License Copyright (c) [2025] [Helmut Hoffer von Ankershoffen (helmuthva@googlemail.com)] Permission is hereby granted, free of charge, to any person obtaining a copy of this software and… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# brave-search-python-client — 🦁 Brave Search Python Client supporting Web, Image, News and Video search.

License: permissive · Maintenance: active · Downloads: 85.3K/mo

## What it is and what it does

Brave Search Python Client is an async-first wrapper around the Brave Search API that lets you perform web, image, news, and video searches from Python code. It uses pydantic-settings for configuration, tenacity for resilience, and typer for its command-line interface. The library is designed to work with current Python versions (3.11, 3.12, 3.13) and includes both a programmatic API for integration into applications and a CLI for shell scripts.

Typical use cases include adding search capabilities to Python applications, giving language models access to current web information, and running searches from the command line. The package is in pre-alpha development status but actively maintained, with comprehensive documentation, examples, and test coverage.

Use it for:

- Integrate web search into Python applications so users can find current information without leaving your app.
- Add real-time web data to LLM applications to supplement model knowledge with current search results.
- Use the CLI in shell scripts to fetch search results in JSON format for further processing.
- Build image or video search features into web or desktop applications.
- Create news aggregation tools that pull recent articles on specific topics.

## Worth the install?

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

A Python client library for the Brave Search API that supports web, image, news, and video search with both async library and CLI interfaces.

Yes, with conditions. The package is actively maintained, has low install friction, and offers a clean async API with CLI support. However, it is marked pre-alpha, so expect potential API changes. You must obtain a Brave Search API key and be aware of the free tier's 2,000 monthly request limit. If you need a stable, production-ready search client and can work within those constraints, this is a solid choice.

## Install

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

## Installing brave-search-python-client

Before you install: Low install friction with a pure-Python wheel and only three runtime dependencies (pydantic-settings, tenacity, typer). Actively maintained with recent releases; last commit 2026-08-08.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects without restriction.

Quickstart:

pip install brave-search-python-client

import asyncio
from brave_search_python_client import BraveSearch, WebSearchRequest

async def search():
    client = BraveSearch()
    response = await client.web(WebSearchRequest(q="python"))
    return response

asyncio.run(search())

Requires a Brave Search API key (obtain from https://brave.com/search/api/); free tier includes 2,000 requests per month.

Verify before relying:

- Whether tenacity is used for automatic retry logic on API failures
- Specific rate-limiting behavior and how it interacts with the free tier quota

## Package facts

- License: MIT License Copyright (c) [2025] [Helmut Hoffer von Ankershoffen (helmuthva@googlemail.com)] Permission is hereby granted, free of charge, to any person obtaining a copy of this software and… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 85.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

brave search api python client, web search integration python, image news video search api, async search client library, brave search cli tool, search-api, async-client, cli-tool

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