Web Search Overview
Helicone Gateway supports web search for Anthropic models, allowing Claude to search the internet and provide up-to-date information with citations. This feature is enabled by appending:online
to the model name, following the same pattern as OpenRouter.
How it Works
When you append:online
to an Anthropic model name (e.g., claude-3-5-sonnet-20241022:online
), Helicone automatically:
- Enables the web search tool for the request
- Routes the request to Anthropic with the appropriate web search configuration
- Returns the response with citations formatted as annotations
Quick Start
- Python
- Node.js
- cURL
Advanced Configuration
You can customize the web search behavior by including aplugins
parameter in your request body:
Plugin Options
Parameter | Type | Description |
---|---|---|
max_uses | integer | Maximum number of web searches allowed per request (default: unlimited) |
allowed_domains | array | Restrict searches to specific domains |
blocked_domains | array | Exclude specific domains from search results |
user_location | object | Provide approximate user location for localized results |
Response Format
When web search is used, the response includes annotations with citation information:Understanding Annotations
url
: The source URL of the cited informationtitle
: The title of the source pagecontent
: The relevant excerpt from the sourcestart_index
: Character position where the citation begins in the responseend_index
: Character position where the citation ends in the response