> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter-d02e98a0-mintlify-5b6e02fd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ToolWebSearch20260209 - Python SDK

> ToolWebSearch20260209 method reference

<Warning>
  The Python SDK and docs are currently in beta.
  Report issues on [GitHub](https://github.com/OpenRouterTeam/python-sdk/issues).
</Warning>

## Fields

| Field             | Type                                                                                                                     | Required             | Description                                                                                                                                                                                                 | Example                                                                                                                    |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------ | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `allowed_callers` | List\[[components.AnthropicAllowedCallers](/client-sdks/python/api-reference/components/anthropicallowedcallers)]        | :heavy\_minus\_sign: | N/A                                                                                                                                                                                                         | \[<br />"direct"<br />]                                                                                                    |
| `allowed_domains` | List\[*str*]                                                                                                             | :heavy\_minus\_sign: | N/A                                                                                                                                                                                                         |                                                                                                                            |
| `blocked_domains` | List\[*str*]                                                                                                             | :heavy\_minus\_sign: | N/A                                                                                                                                                                                                         |                                                                                                                            |
| `cache_control`   | [Optional\[components.AnthropicCacheControlDirective\]](../components/anthropiccachecontroldirective.md)                 | :heavy\_minus\_sign: | Enable automatic prompt caching. When set at the top level, the system automatically applies cache breakpoints to the last cacheable block in the request. Currently supported for Anthropic Claude models. | `{"type": "ephemeral"}`                                                                                                    |
| `max_uses`        | *OptionalNullable\[int]*                                                                                                 | :heavy\_minus\_sign: | N/A                                                                                                                                                                                                         |                                                                                                                            |
| `name`            | [components.NameWebSearch2](/client-sdks/python/api-reference/components/namewebsearch2)                                 | :heavy\_check\_mark: | N/A                                                                                                                                                                                                         |                                                                                                                            |
| `type`            | [components.TypeWebSearch20260209](/client-sdks/python/api-reference/components/typewebsearch20260209)                   | :heavy\_check\_mark: | N/A                                                                                                                                                                                                         |                                                                                                                            |
| `user_location`   | [OptionalNullable\[components.AnthropicWebSearchToolUserLocation\]](../components/anthropicwebsearchtooluserlocation.md) | :heavy\_minus\_sign: | N/A                                                                                                                                                                                                         | `{"city": "San Francisco","country": "US","region": "California","timezone": "America/Los_Angeles","type": "approximate"}` |