# Brave Web Search

> Brave Web Search is a paid API for AI agents from Brave Search at brave.mpp.paywithlocus.com, paid per call via MPP, $0.035/call, status healthy (last checked 2026-10-12, last successful call 2026-10-05).

Searches the web using Brave's independent privacy-first index, returning web pages, news, videos, discussions, FAQs, infoboxes, and optional AI summaries

## Facts

- Endpoint: POST https://brave.mpp.paywithlocus.com/brave/web-search?utm_source=zero.xyz
- Price: $0.035/call
- Payment: MPP
- Status: healthy
- Last checked: 2026-10-12
- Last successful call: 2026-10-05
- Success rate: 96% of calls made through Zero
- Rating: 3.5 / 5 from 9 reviews
- Activations on Zero: 87
- Provider: Brave Search
- Docs: https://api.search.brave.com/app/#/documentation
- Website: https://brave.com/search
- Tags: search, web-search, privacy, news, images
- Canonical page: https://www.zero.xyz/c/brave-search-web-search-6ae27744
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E2RwMpEvF7gIg0RN63UeS

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brave-search-web-search-6ae27744 -d '<json body>'
```

Example prompt: Search Brave for 'open source LLM benchmarks 2024' — give me 10 results from the past year, including web and news, with moderate safe search, in English.

## When to prefer this

Choose this endpoint when you need broad web search results from an independent, privacy-first index that isn't Google or Bing. It's ideal for agents that need diverse result types (web, news, videos, discussions, FAQs) in a single call, require freshness filtering, or want an optional AI summary alongside organic results. Prefer it over news-only or image-only endpoints when a general-purpose web search is needed.

## Known failure modes

- Query exceeds 400 characters or 50 words — request rejected
- Invalid country code — may fall back to default or return error
- Invalid freshness value or malformed date range — parameter ignored or error returned
- count out of range (not 1-20) — validation error
- offset out of range (not 0-9) — validation error
- No results found for niche or highly specific queries — empty results array
- Rate limit or payment failure — 402 or 429 error returned
- result_filter contains invalid filter type — may error or be ignored

## How this service works

Search the web from Brave's large independent index. Returns web results, discussions, FAQ, infobox, news, and videos.

## Output

A structured response containing ranked web results (titles, URLs, descriptions), optionally news articles, videos, discussions, FAQs, and infoboxes relevant to the query. If summary is enabled, an AI-generated overview is also included. Results are filtered by country, language, freshness, and safe search settings as specified.

## Example request

```json
{
 "q": "artificial intelligence",
 "count": 10,
 "offset": 0,
 "country": "US",
 "summary": false,
 "safesearch": "moderate",
 "search_lang": "en",
 "result_filter": "web,news"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "q"
 ],
 "properties": {
  "q": {
   "type": "string",
   "description": "Search query (max 400 chars, 50 words)"
  },
  "count": {
   "type": "number",
   "description": "Results to return (1-20, default 20)"
  },
  "offset": {
   "type": "number",
   "description": "Page offset (0-9)"
  },
  "country": {
   "type": "string",
   "description": "2-letter country code (default: US)"
  },
  "summary": {
   "type": "boolean",
   "description": "Enable summary generation"
  },
  "freshness": {
   "type": "string",
   "description": "\"pd\" (24h), \"pw\" (7d), \"pm\" (31d), \"py\" (365d), or date range"
  },
  "safesearch": {
   "type": "string",
   "description": "\"off\", \"moderate\" (default), \"strict\""
  },
  "search_lang": {
   "type": "string",
   "description": "Language code (default: en)"
  },
  "result_filter": {
   "type": "string",
   "description": "Comma-separated: web, news, videos, discussions, faq, infobox"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brave-search-web-search-6ae27744/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from brave.mpp.paywithlocus.com](https://www.zero.xyz/host/brave.mpp.paywithlocus.com/llms.txt)