Sign in

v54

OpenAPI 3.1.0raw.githubusercontent.com2026-08-038690315.6 KB
search

Create Search

Run a search against a configured search tool.

The tool is taken from search_tool_name, which may be omitted when exactly one tool is configured.

Authentication modes:

  • Master key: the user field is required and may name any existing user.
  • API key: usage and spend always bind to the key's own user. A user field naming a different user is rejected with 403 (or ignored, when reject_user_mismatch is disabled); it is never billed to that user.
post/v1/search

Request body

countrystring nullable

Two-letter ISO country code to localize results to

max_resultsinteger nullable

Maximum number of results to return

max_tokens_per_pageinteger nullable

Approximate cap on the page content returned per result

querystring required

The search query

search_domain_filterstring[] nullable

Restrict results to these domains; prefix a domain with '-' to exclude it instead

search_tool_namestring nullable

Configured search tool to run against. Optional when exactly one tool is configured, and ignored on POST /v1/search/{search_tool_name}.

userstring nullable

User ID for usage attribution

Example request

{
  "max_results": 5,
  "query": "otari llm gateway"
}

Response

Successful Response

object'search'
search_toolstring required

The configured search tool that served the request