Web Search

Search the web and return ranked results. The gateway routes to the best available provider (Brave, Gemini, OpenAI, or Anthropic) based on latency and cost.

When to use

• Research queries — retrieve up-to-date information from the live web.
• Fact checking — ground LLM responses in current sources.
• News & events — look up recent happenings beyond a model's training cutoff.

Inputs & outputs

Input modality	None (query is a parameter)
Output modality	Text (structured list of results)
Max query length	500 characters
Max results	50

Parameters

Param	Required	Description
query	yes	Search query string (1–500 chars)
max_results	no	Number of results to return (1–50). Default: 10
region	no	BCP-47 region code for localised results, e.g. en-US, de-DE

Examples

Basic web search

{
  "type": "web.search",
  "input": {},
  "params": { "query": "best LLMs 2026", "max_results": 10 }
}

Localised search

{
  "type": "web.search",
  "input": {},
  "params": { "query": "Bundesliga Ergebnisse", "max_results": 5, "region": "de-DE" }
}

Pricing

Billed per search request. The gateway routes to the most appropriate provider; see pricing dashboard for current rates.

Related capabilities

• code.run_python — process or summarise search results with inline Python
• code.run_node — transform result data with Node.js

{
  "query": "best LLMs 2026",
  "max_results": 10
}