Tools/web-search/web_search

web-search/web_search

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 on success

What it does

Runs a web search against Brave's independent index and returns ranked results with titles, URLs, descriptions, and richer page excerpts. Queries can be tuned with country and language targeting, recency filters, SafeSearch level, and result count.

Primary use cases

  • AI agents grounding responses in fresh, cited web pages instead of relying on training data alone.
  • Researchers and analysts running competitive scans, news sweeps, or fact-checks across recent content.
  • Developers building search-enabled features into chatbots, CRMs, or internal tools that need a privacy-respecting search backend.
  • Marketers and SEO teams checking how content surfaces in a specific country or language without manual location spoofing.

Why use this tool

Brave maintains its own crawler and index of over 30 billion pages with roughly 100 million updates per day, so results are not a thin wrapper over another engine. The recency, region, and language controls make it straightforward to scope a query to exactly the slice of the web that matters, and the independent index gives broader perspective than re-querying the same dominant search source.

Good to know

Recency filters narrow to the last day, week, month, or year, which is useful when an agent needs current information. SafeSearch can be tightened for user-facing applications, and country plus language targeting work together to localize both ranking and result language.

Parameters

qstringrequired

Search query. Supports site:, -exclude, "exact phrase", filetype:pdf.

countintegeroptionaldefault: 10

Results to return (1–20).

countrystringoptional

ISO 3166-1 alpha-2 country code, e.g. "US".

freshnessstringoptional

Time filter: pd=24h, pw=7d, pm=31d, py=year.

safesearchstringoptionaldefault: "moderate"
search_langstringoptional

Content language (ISO 639-1), e.g. "en".

extra_snippetsbooleanoptionaldefault: false

Include up to 5 extra excerpts per result.

web-search/web_search — Faro