🌐Web Search
Search the web and return organic results: title, URL and snippet per result, with an optional country bias. Powered by the Brave Search API. Cached 1 hour per query; monthly quota is shared, so bursts may return a quota-exhausted error until the window resets.
🔌 Server-side tool
This tool runs on the server (it fetches third-party URLs directly and cannot run in your browser). Use the paid JSON API below — the worked examples show real server-side results and refresh automatically.
Worked examples
Live examples refresh automatically — call the API for guaranteed-fresh results.
Machine API (x402)
$0.01 / callThis tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol — no accounts, no API keys.
GET /api/v1/live/web-search?query=best%20crypto%20hardware%20wallets%202026&count=5&country=us HTTP/1.1
Host: localhost:3000
→ 402 (payment required, instructions in headers)
→ 200 (after X-PAYMENT header; JSON body below)
{
"tool": "live/web-search",
"input": {"query":"best crypto hardware wallets 2026","count":5,"country":"us"},
"result": { "value": null, "answer": "" }
}Agent docs: /llms.txt · OpenAPI spec · integration guide
About this tool
Web search is the capability agents lack most — LLMs have training cutoffs and no internet access. This returns fresh organic results (title, URL, snippet) for any query, with a country bias option. Results are cached an hour per query.
Frequently asked questions
How fresh are the results?
Brave's index is continuously updated; identical queries are cached one hour to stay within quota.
Can I get more than 10 results?
The API caps at 10 per call. Chain calls with refined queries for deeper research.