Brave Web Search

Brave Web Search

Active

by Faro

1 tool
upstream:

Access privacy-focused web search to find relevant pages, articles, and resources from across the internet. This suite helps agents retrieve ranked search results with flexible controls for recency, geography, language, and content safety.

Searchweb-searchsearchresearch

Tools (1)

Search the live web and return ranked results with titles, links, and snippets — for general lookups, research, fact-checks, or the latest news and current events. Powered by Brave's independent index of 30B+ pages with ~100M updates/day. Tune queries with recency filters (last day/week/month/year), country and language targeting, safe search level, pagination, and extra snippets per result.

6.25 credits/call ($0.00625) · Charged only on successful responses.

Example prompts

  • Search for documentation on Python asyncio
  • Find the official site for OpenTelemetry
  • Get the latest news on the US elections
  • Pull recent headlines about the Fed rate decision
  • Look up reviews of the Sony WH-1000XM5
  • Search for news about the SpaceX launch this week
  • What's the current population of Tokyo?
  • Find news articles about OpenAI from the last 7 days

Parameters

qstringrequired

Search query. Supports operators like site:, filetype:, quoted exact match, and minus exclusions.

countintegeroptionaldefault: 20

Number of results per page (max 20, default 20). Actual count returned may be less.

offsetintegeroptional

Starting position for results (0-based, max 9). Combine with count for pagination — e.g. offset=20 with count=20 fetches results 20–39.

countrystringoptional

Two-letter ISO country code to bias results.

freshnessstringoptional

Restrict results by recency. One of: pd (24h), pw (7d), pm (31d), py (year), OR a custom range like "2024-04-01to2024-07-30".

safesearchstringoptionaldefault: "moderate"

Adult-content filter level.

search_langstringoptional

ISO 639-1 language code for content language filter.

extra_snippetsbooleanoptional

Return up to 5 additional excerpts per result.

API Usage

curl -X POST "https://api.askfaro.com/invoke/brave/web_search" \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "arguments": {
    "q": "<q>"
  }
}'

CLI Usage

faro invoke brave/web_search --params '{"q":"<q>"}'

Install pip install askfaro-cli, then faro auth login.

README

Brave Web Search

Privacy-focused web search via the Brave Search API. One tool that returns ranked organic results with titles, links, and snippets — plus controls for recency, country, language, and safe-search.

web_search

{
  "q": "AI regulation in europe 2026",
  "count": 10,
  "freshness": "pm",
  "country": "us",
  "safesearch": "moderate"
}

Useful options

  • q — query. Supports operators like site:, filetype:, quoted exact match, and minus exclusions.
  • count — results per page (1–20).
  • offset — pagination offset (0–9). Pair with count for deeper paging.
  • freshnesspd (24h), pw (7d), pm (31d), py (year), or a custom range like "2025-01-01to2025-06-30".
  • country / search_lang — ISO codes to bias to a region or language.
  • extra_snippetstrue to return up to 5 additional excerpts per result.

Pricing

6.25 credits (~$0.0063) per call, charged only on a successful response.

Auth

A Brave Search API key on the publisher's Faro connection — no user-side configuration required.