---
title: "ToolWebSearch20260209"
---

## Fields

| Field                                                                                                                                                                                                       | Type                                                                                                                                                                                                        | Required                                                                                                                                                                                                    | Description                                                                                                                                                                                                 | Example                                                                                                                                                                                                     |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `allowed_callers`                                                                                                                                                                                           | List[[components.AnthropicAllowedCallers](../components/anthropicallowedcallers.mdx)]                                                                                                                        | :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.mdx)                                                                                                      | :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. | \{<br/>"type": "ephemeral"<br/>}                                                                                                                                                                             |
| `max_uses`                                                                                                                                                                                                  | *OptionalNullable[int]*                                                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                          | N/A                                                                                                                                                                                                         |                                                                                                                                                                                                             |
| `name`                                                                                                                                                                                                      | [components.NameWebSearch2](../components/namewebsearch2.mdx)                                                                                                                                                | :heavy_check_mark:                                                                                                                                                                                          | N/A                                                                                                                                                                                                         |                                                                                                                                                                                                             |
| `type`                                                                                                                                                                                                      | [components.TypeWebSearch20260209](../components/typewebsearch20260209.mdx)                                                                                                                                  | :heavy_check_mark:                                                                                                                                                                                          | N/A                                                                                                                                                                                                         |                                                                                                                                                                                                             |
| `user_location`                                                                                                                                                                                             | [OptionalNullable[components.AnthropicWebSearchToolUserLocation]](../components/anthropicwebsearchtooluserlocation.mdx)                                                                                      | :heavy_minus_sign:                                                                                                                                                                                          | N/A                                                                                                                                                                                                         | \{<br/>"city": "San Francisco",<br/>"country": "US",<br/>"region": "California",<br/>"timezone": "America/Los_Angeles",<br/>"type": "approximate"<br/>}                                                      |