Web search: top results for any query

$0.01 per call · failed calls are never charged · no account or subscription: pay per call with a card key or USDC

Web search: send a query and get the top web results as JSON (title, URL, snippet, published date), optionally with page text and highlights, filtered by domain, date or category. Results are for immediate use only (Brave API terms); failures are uncharged. Use when an agent needs current facts, sources or links.

Buy credits by card (from $1) Example result (JSON)

Inputs

NameTypeDescription
q (required)stringSearch query, at most 400 characters
countintegerNumber of results (1-20, default 10)
includeDomainsstringOnly results from these domains: comma list or JSON array, up to 20 (example.com, github.com/org)
excludeDomainsstringNever results from these domains: comma list or JSON array
startPublishedDatestringOnly pages published on or after this date (ISO 8601, e.g. 2025-01-01)
endPublishedDatestringOnly pages published on or before this date (ISO 8601)
categorystringnews, research paper, github, pdf, tweet, linkedin profile, company, personal site or financial report
includeTextstringA phrase the results must contain (up to 5 words)
excludeTextstringA phrase the results must not contain
textCharsintegerReturn the live page text of the top results, this many characters each (500-20000, or true for 3000; default none)
highlightsstringtrue: the passages of each page that best match the query, with scores
numSentencesintegerSentences per highlight (1-10, default 3)
highlightsPerUrlintegerHighlights per result (1-5, default 1)
summarystringtrue: a 1-3 sentence AI summary of each of the top pages
summaryQuerystringWhat the summaries should focus on (default: the query)

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://tools.funwords.eu/web/search?q=x402%20payment%20protocol"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.

Example result

{
  "query": "x402 payment protocol",
  "provider": "Brave Search",
  "count": 1,
  "results": [
    {
      "title": "x402: an open payment protocol",
      "url": "https://www.x402.org/",
      "snippet": "x402 lets any HTTP API charge per request in stablecoins…",
      "age": "2 days ago",
      "publishedDate": "2026-11-04T09:00:00.000Z",
      "author": null,
      "domain": "x402.org",
      "favicon": "https://imgs.search.brave.com/x402-favicon.png",
      "image": null
    }
  ],
  "terms": "Results are for the caller's immediate use: no storing or caching beyond the current task, no resale and no model training (Brave Search API terms)."
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is web_search, and the first 25 successful calls are free:

https://tools.funwords.eu/mcp

Related tools