Skip to main content
The orq:web_search tool lets a model search the public web during a response. The AI Gateway runs each search and returns the results to the model, which decides how to use them in its answer.

Quick start

The examples use the client configuration from the Server tools overview.
The model writes the search query. Configuration on the tool entry controls the engine, result count, call count, and domains.

Configuration

max_results is a cap. If the model asks for fewer results, the lower value is used.

Cost and usage

Each Orq.ai web search that starts execution costs $0.005. The charge is included in the response cost when billing data is available. The number of searches appears at usage.server_tool_use.web_search_requests. Calls rejected by max_uses do not increment the counter. Use Web fetch when a prompt already contains the URL to read. Web search finds pages; web fetch retrieves a specific page.