web-search-tool changedagents-and-tools/tool-use/web-search-tool
Recorded here
Lines+77added
Lines−3removed
From line
2
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits20to this page, all time
## Availability ### API support #### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages) #### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) ### Data handling
The whole hunk
from line 2, old and new numbered
/
from line 2
22title: Web search tool
33url: https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool
44description: Give Claude access to current web content with cited sources, optional dynamic filtering, and domain controls.
5featureMetadata:
6 status: ga
7 zdr:
8 eligibility: eligible
9 note: Excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements). Real-time web search results returned in the API response. Dynamic filtering for web search is not eligible for ZDR or HIPAA.
10 supportedModels:
11 - claude-fable-5-1
12 - claude-mythos-5-1
13 - claude-fable-5
14 - claude-mythos-5
15 - claude-mythos-preview
16 - claude-opus-5-5
17 - claude-opus-5
18 - claude-sonnet-5-5
19 - claude-sonnet-5
20 - claude-haiku-5-5
21 - claude-haiku-4-5-20251001
22 - claude-opus-4-8
23 - claude-opus-4-7
24 - claude-opus-4-6
25 - claude-sonnet-4-6
26 - claude-opus-4-5-20251101
27 - claude-sonnet-4-5-20250929
28 supportedPlatforms:
29 Claude API: ga
30 Claude Platform on AWS: ga
31 Claude Models on Google Cloud (Anthropic managed): ga
32 Claude Models on Google Cloud (Google managed):
33 availability: ga
34 note: Only the basic web search tool (`web_search_20250305`), without dynamic filtering.
35 Microsoft Foundry:
36 availability: ga
37 note: Only the basic web search tool (`web_search_20250305`), without dynamic filtering.
538---
639
7<Note>
8 To learn how zero data retention (ZDR) applies to this feature, see [API and data retention](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention).
9</Note>
40**API support**: Usage differs by product.
1041
42* **Messages API**: Add a `web_search` tool to the request’s `tools`. Settings such as `max_uses`, domain lists and `user_location` go on that tool.
43* **Managed Agents**: On by default in the agent toolset, without `max_uses`, `citations` or `cache_control`.
44
1145The web search tool gives Claude direct access to real-time web content, allowing it to answer questions with up-to-date information beyond its knowledge cutoff. The response includes citations for sources drawn from search results.
1246
1347With `web_search_20260209` and later versions, Claude can write and run code that filters the search results before they reach the context window (**dynamic filtering**), keeping only relevant information. Dynamic filtering is available with Claude 4.6 and later models and [Claude Mythos Preview](https://anthropic.com/glasswing).
from line 723
689723 Directory of Anthropic-provided tools and reference for optional tool definition properties.
690724 </Card>
691725</CardGroup>
726
727## Availability
728
729Web search tool is available on every model and eligible for zero data retention and HIPAA readiness.
730
731### API support
732
733#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
734
735* Availability: Available
736* Usage: Add a `web_search` tool to the request’s `tools`. Settings such as `max_uses`, domain lists and `user_location` go on that tool.
737
738| Status | Cloud platforms |
739| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
740| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed), [Microsoft Foundry (hosted on Anthropic)](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
741| Available<sup>1</sup> | [Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/google-managed), [Microsoft Foundry (hosted on Azure)](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
742
7431. Only the basic web search tool (`web_search_20250305`), without dynamic filtering.
744
745#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
746
747* Availability: Available
748* Usage: Part of the agent toolset, and on by default once the toolset is added. Domain lists and `user_location` go on the toolset’s `web_search` entry; `max_uses`, `citations` and `cache_control` are not available.
749
750| Status | Cloud platforms |
751| --------- | ------------------------------------------------------------------------------------------------------------------ |
752| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws) |
753
754### Data handling
755
756[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
757
758| Item | Zero data retention | HIPAA |
759| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
760| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Eligible |
761| Details | Real-time web search results returned in the API response. Dynamic filtering for web search is not eligible for ZDR or HIPAA. | Dynamic filtering for web search is not eligible for ZDR or HIPAA. |
762
763Applicable endpoints:
764
765* `/v1/messages` with `web_search` tool
692766
No line in this hunk matches that.