type: Literal["web_search_preview", "web_search_preview_2025_03_11"]

The type of the web search tool. One of web_search_preview or web_search_preview_2025_03_11.

One of the following:
"web_search_preview"
"web_search_preview_2025_03_11"
search_content_types: Optional[List[Literal["text", "image"]]]
One of the following:
"text"
"image"
search_context_size: Optional[Literal["low", "medium", "high"]]

High level guidance for the amount of context window space to use for the search. One of low, medium, or high. medium is the default.

One of the following:
"low"
"medium"
"high"
user_location: Optional[UserLocation]

The approximate location of the user. If omitted or null, defaults to the United States. To avoid this fallback, pass {"type": "approximate"} without location fields. To localize results, provide the relevant location fields.

type: Literal["approximate"]

The type of location approximation. Always approximate.

city: Optional[str]

Free text input for the city of the user, e.g. San Francisco.

country: Optional[str]

The two-letter ISO country code of the user, e.g. US.

region: Optional[str]

Free text input for the region of the user, e.g. California.

timezone: Optional[str]

The IANA timezone of the user, e.g. America/Los_Angeles.