Marketplace/brave/web_search

brave/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.

by Faro

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 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.