WebSearchPlugin Type | OpenRouter TypeScript SDK

The TypeScript SDK and docs are currently in beta. Report issues on GitHub.

Example Usage

import { WebSearchPlugin } from "@openrouter/sdk/models";

let value: WebSearchPlugin = {
  id: "web",
};

Field	Type	Required	Description	Example
`enabled`	boolean	:heavy_minus_sign:	Set to false to disable the web-search plugin for this request. Defaults to true.
`engine`	models.WebSearchEngine	:heavy_minus_sign:	The search engine to use for web search.	exa
`excludeDomains`	string[]	:heavy_minus_sign:	A list of domains to exclude from web search results. Supports wildcards (e.g. “*.substack.com”) and path filtering (e.g. “openai.com/blog”).	[ “example.com”, “*.substack.com”, “openai.com/blog” ]
`id`	”web”	:heavy_check_mark:	N/A
`includeDomains`	string[]	:heavy_minus_sign:	A list of domains to restrict web search results to. Supports wildcards (e.g. “*.substack.com”) and path filtering (e.g. “openai.com/blog”).	[ “example.com”, “*.substack.com”, “openai.com/blog” ]
`maxResults`	number	:heavy_minus_sign:	N/A
`maxUses`	number	:heavy_minus_sign:	Maximum number of times the model can invoke web search in a single turn. Passed through to native providers that support it (e.g. Anthropic).
`searchPrompt`	string	:heavy_minus_sign:	N/A
`userLocation`	models.UserLocation	:heavy_minus_sign:	N/A	`{"city": "San Francisco","country": "US","region": "California","timezone": "America/Los_Angeles","type": "approximate"}`

⌘I