v.0.2.0

What's Changed

• docs: update readme by @kayvane1 in #36
• increased compatability by @CalebHoldenerKai in #39
• Reraise errors caught after sync request by @johncant in #38
• Fixed URL for brave search API page by @fauzaanu in #37
• chore: bump version with latest PRs by @kayvane1 in #40
• fix: || operator not permitted for httpx dependency in pypi by @kayvane1 in #41

New Contributors

• @CalebHoldenerKai made their first contribution in #39
• @johncant made their first contribution in #38
• @fauzaanu made their first contribution in #37

Full Changelog: v0.1.8...v.0.2.0

Return Raw response & validation fixes

Fixed validation errors in pydantic models for:

• book
• thumbnail
• news
• web_search

Users can return raw if pydantic validation fails to not block them 🔥

from brave import Brave

query = "George Orwell, 1984"
num_results = 10

search_results = brave.search(q=query, raw=True)

@harishankar-gopalan fixed a compatability issue with Python 3.9 🚀

Add Apache 2.0 License

Adds permissive license for users to build on top of brave-api

Pydantic model updates following Brave changes

@dmabry - Fixed errors in the WebResponseSearch and updated QAPage to appropriately use Answer. Also made several fields optional as they don't always seem to be included depending on the query and response from Brave. 🚀

Fix Brave Pypi page

Fixes reference on pypi to pull the readme

Adds Initial Tests

• Adds initial tests for the repository
• Test coverage is at 92% but more fine-grained tests need to be built as pydantic is very strict and used on all responses

Minor Fixes

• Fixes issue in pydantic class which meant urls , descriptions, product_clusters and their downstream methods were returning an error.
• removes requirement for Python 3.11 for better cross-project compatibility

v0.1.0

This package provides a convenient way to integrate Brave's privacy-preserving search capabilities into your Python projects.

Overview

brave-search is designed to interact seamlessly with the Brave Search API, offering a range of endpoints to build diverse applications. Emphasizing privacy, Brave Search does not track users or their queries, making it an ideal alternative to traditional search engines.

Installation

You can install the package using pip install brave-search

Features

• Search Functionality
  • Supports both synchronous and asynchronous requests.
  • API key can be set as an environment variable or passed directly.
  • Retrieve Web, News, and Video results.
• Specialized Methods
  • Download PDFs: Download all PDFs found in the search results.
  • Aggregate Price Data: Get a list of prices from search results.
  • Aggregate Review Data: Calculate the average review score on a 100-point scale.
• Goggles Integration
  • Customize search result ranking using goggles for specific use cases.
  • Includes support for community-contributed Goggles.