search-results changedbuild-with-claude/search-results
Recorded here
Lines+70added
Lines−3removed
From line
2
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits17to 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: Search results
33url: https://platform.claude.com/docs/en/build-with-claude/search-results
44description: Get natural citations for RAG applications by providing search results with source attribution
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).
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 Amazon Bedrock: ga
32 Amazon Bedrock (InvokeModel): ga
33 Claude Models on Google Cloud (Google managed): ga
34 Microsoft Foundry: ga
535---
636
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>
37**API support**: Usage differs by product.
1038
39* **Messages API**: Always on. Send `search_result` blocks in a tool result or directly in a user message.
40* **Managed Agents**: Always on. Accepted only in tool results, such as a `user.custom_tool_result` event, not in `user.message` events.
41
1142Search result content blocks let Claude cite your own content the same way it cites web search results: each citation carries the source and title you provided. Use them in RAG (Retrieval-Augmented Generation) applications where Claude needs to attribute answers to your documents.
1243
1344All [active models](https://platform.claude.com/docs/en/models/overview) support search results with citations, with the exception of Claude Haiku 3. No beta header is required: search results are part of the standard Messages API.
from line 2187
21562187 Cache search results with `cache_control` to reduce cost and latency on repeated requests.
21572188 </Card>
21582189</CardGroup>
2190
2191## Availability
2192
2193Search results are available on every model and eligible for zero data retention and HIPAA readiness.
2194
2195### API support
2196
2197#### [Messages API](https://platform.claude.com/docs/en/build-with-claude/working-with-messages)
2198
2199* Availability: Always on
2200* Usage: Send `search_result` blocks in a tool result or directly in a user message.
2201
2202| Status | Cloud platforms |
2203| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2204| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws), [Amazon Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-in-amazon-bedrock), [Amazon Bedrock (InvokeModel)](https://platform.claude.com/docs/en/build-with-claude/claude-on-amazon-bedrock-legacy), [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](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry) |
2205
2206#### [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)
2207
2208* Availability: Always on
2209* Usage: Accepted only in tool results, such as a `user.custom_tool_result` event, not in `user.message` events.
2210
2211| Status | Cloud platforms |
2212| --------- | ------------------------------------------------------------------------------------------------------------------ |
2213| Available | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws) |
2214
2215### Data handling
2216
2217[Data handling overview](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#feature-eligibility)
2218
2219| Item | Zero data retention | HIPAA |
2220| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
2221| Status | Eligible (excludes [Covered Models](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)) | Eligible |
2222
2223Applicable endpoints:
2224
2225* `/v1/messages` with `search_results` source
21592226
No line in this hunk matches that.