# OpenResponsesWebSearch20250826Tool

Web search tool configuration (2025-08-26 version)


## Fields

| Field                                                                                                                                                                                                                                                                                          | Type                                                                                                                                                                                                                                                                                           | Required                                                                                                                                                                                                                                                                                       | Description                                                                                                                                                                                                                                                                                    | Example                                                                                                                                                                                                                                                                                        |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type`                                                                                                                                                                                                                                                                                         | [components.OpenResponsesWebSearch20250826ToolType](../components/openresponseswebsearch20250826tooltype.md)                                                                                                                                                                                   | :heavy_check_mark:                                                                                                                                                                                                                                                                             | N/A                                                                                                                                                                                                                                                                                            |                                                                                                                                                                                                                                                                                                |
| `filters`                                                                                                                                                                                                                                                                                      | [OptionalNullable[components.OpenResponsesWebSearch20250826ToolFilters]](../components/openresponseswebsearch20250826toolfilters.md)                                                                                                                                                           | :heavy_minus_sign:                                                                                                                                                                                                                                                                             | N/A                                                                                                                                                                                                                                                                                            |                                                                                                                                                                                                                                                                                                |
| `search_context_size`                                                                                                                                                                                                                                                                          | [Optional[components.ResponsesSearchContextSize]](../components/responsessearchcontextsize.md)                                                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                                                                                             | Size of the search context for web search tools                                                                                                                                                                                                                                                | medium                                                                                                                                                                                                                                                                                         |
| `user_location`                                                                                                                                                                                                                                                                                | [OptionalNullable[components.ResponsesWebSearchUserLocation]](../components/responseswebsearchuserlocation.md)                                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                                                                                             | User location information for web search                                                                                                                                                                                                                                                       | {<br/>"type": "approximate",<br/>"city": "San Francisco",<br/>"country": "USA",<br/>"region": "California",<br/>"timezone": "America/Los_Angeles"<br/>}                                                                                                                                        |
| `engine`                                                                                                                                                                                                                                                                                       | [Optional[components.OpenResponsesWebSearch20250826ToolEngine]](../components/openresponseswebsearch20250826toolengine.md)                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                                                                             | Which search engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in search (parameters like max_results, search_context_size, and domain filters are not forwarded to the provider). "exa" forces the Exa search API. | auto                                                                                                                                                                                                                                                                                           |
| `max_results`                                                                                                                                                                                                                                                                                  | *Optional[float]*                                                                                                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                                                                                                             | Maximum number of search results to return per search call. Defaults to 5. Only applies when using the Exa engine; ignored with native provider search.                                                                                                                                        | 5                                                                                                                                                                                                                                                                                              |