{"uid":"cap_x8oTtl3Z1UPIJzmap1BDP","slug":"brave-search-web-search-c16b6250","name":"Brave Search Web Search","description":"Web search over Brave's independent index. Returns ranked pages with title, URL, and snippet, plus news, video, and discussion results when relevant. Use it to find current sources on any topic. Pass q, and optionally count, offset, country, search_lang, and freshness.","url":"https://search.agent.s.brave.app/res/v1/web/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":600,"description":"Search query"},"count":{"type":"integer","default":20,"maximum":20,"minimum":1},"offset":{"type":"integer","maximum":9,"minimum":0,"description":"Pages of count results to skip"},"country":{"type":"string","description":"Country code such as US, or ALL"},"freshness":{"type":"string","description":"pd, pw, pm, py, or a range like 2026-01-01to2026-06-30"},"safesearch":{"enum":["off","moderate","strict"],"type":"string","default":"moderate"},"search_lang":{"type":"string","description":"Language code such as en"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"web":{"type":"object","properties":{"type":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"type":"string"},"page_age":{"type":"string"},"description":{"type":"string"}}}}}},"type":{"type":"string"},"query":{"type":"object","properties":{"original":{"type":"string"}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jHQA4s60vPUPACZ5JlPf9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Brave's independent web index and returns ranked pages with title, URL, snippet, plus news, video, and discussion results when relevant.","exampleAgentPrompt":"Search Brave's web index for the latest information on the EU AI Act regulatory updates — give me up to 10 results from the past month, focused on English-language sources from the US.","exampleUseCases":[{"title":"Real-time fact checking for a claim","prompt":"Search the web to find out whether OpenAI actually released GPT-5 this week — show me the most recent results from the past 7 days so I can verify the claim."},{"title":"Competitive research on a company","prompt":"Find me up to 20 recent web pages about Anthropic's funding rounds and valuation — English results only, from the past year, nothing explicit."},{"title":"Finding technical documentation","prompt":"Search Brave for the official documentation or guides on how to configure Kubernetes horizontal pod autoscaling — give me the top 10 results."}],"resultDescription":"Returns a structured object containing ranked web results (each with title, URL, description/snippet, and page age), plus additional result groups such as news articles, videos, and discussions when Brave deems them relevant to the query. Also includes query metadata such as the original query string.","failureModes":["Missing required 'q' parameter returns a 400 error","Query exceeding 600 characters is rejected","Offset above 9 is rejected as out of range","Count above 20 is capped or rejected","Invalid country or language code may return no results or an error","Payment failure (x402) if USDC balance is insufficient","Freshness date range in wrong format returns an error or empty results"],"whenToPreferThis":"Choose this endpoint when you need broad, ranked web results from Brave's independent index — especially when you want source diversity beyond Google or Bing, need freshness filtering by date range, or want supplemental news/video/discussion results alongside standard web results. Prefer it over the Brave News Search endpoint when you need general web pages rather than just news articles, and over the LLM-ready text endpoint when you want raw ranked results rather than pre-extracted passage text.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T19:29:16.471Z","isFirstParty":false,"canonicalSlug":"brave-search-web-search-c16b6250"}