Package Exports

brave-search
brave-search/dist/braveSearch.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (brave-search) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Brave Search API Library

A TypeScript library for interacting with the Brave Search API, providing easy access to web search, local POI search, and automatic summarization features.

Installation

Install the package using npm:

npm install brave-search

Getting Started

Obtain a Brave Search API key from Brave Search API Dashboard.
Install the package:
```
npm install brave-search
```

Import and initialize the BraveSearch class:

import { BraveSearch } from "brave-search";

const BRAVE_API_KEY = "your-api-key-here";
const braveSearch = new BraveSearch(BRAVE_API_KEY);

Usage

Web Search

Perform a web search:

const webSearchResults = await braveSearch.webSearch("TypeScript tutorial", {
  count: 5,
  safesearch: "off",
  search_lang: "en",
  country: "US",
  text_decorations: false,
});
console.log(webSearchResults);

Summarized Search

Get a summarized answer for a query (requires "Data for AI pro" plan):

const { summary, webSearchResponse } = await braveSearch.getSummarizedAnswer(
  "What is TypeScript?",
  {
    count: 5,
    safesearch: "off",
    search_lang: "en",
    country: "US",
    text_decorations: false,
    freshness: "pw",
    spellcheck: false,
    extra_snippets: true,
    summary: true,
  },
);
console.log(summary);
console.log(webSearchResponse);

Local POI Search

Search for local points of interest:

const poiResults = await braveSearch.localPoiSearch("poi_id1", "poi_id2");
console.log(poiResults);

Local Descriptions Search

Get descriptions for local points of interest:

const descriptionResults = await braveSearch.localDescriptionsSearch(
  "poi_id1",
  "poi_id2",
);
console.log(descriptionResults);

Search Options

The library supports various search options as defined in the Brave Search API documentation. Here are some of the available options:

interface BraveSearchOptions {
  country?: string;
  search_lang?: string;
  ui_lang?: string;
  safesearch?: "off" | "moderate" | "strict";
  freshness?: "pd" | "pw" | "pm" | "py" | string;
  text_decorations?: boolean;
  spellcheck?: boolean;
  goggles_id?: string;
  units?: "metric" | "imperial";
  extra_snippets?: boolean;
  count?: number;
  result_filter?: ResultFilterType;
  summary?: boolean;
}

For a complete list of options and their descriptions, please refer to the Brave Search API Documentation.

Important Notes

The summary option and getSummarizedAnswer method are only available with the Brave "Data for AI pro" plan.
For detailed information about API usage, rate limits, and pricing, please visit the Brave Search API Terms.

API Reference

For detailed API reference, please refer to the Brave Search API Documentation.

Features

Web search
Automatic summarization with polling
Local POI search
Local descriptions search
Error handling for API requests

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Disclaimer

This library is not officially associated with Brave Software. It is a third-party implementation of the Brave Search API.