Enable web search by setting
"tools_enabled": ["auto_search"] in your request to access current information and real-time data.Quick Start
- Python
- JavaScript
- cURL
Search Integration
Whentools_enabled includes "auto_search", the agent can:
- Access real-time web information
- Search for current news and developments
- Verify facts with up-to-date sources
- Provide contextually relevant information
- Cite sources for transparency
Use Cases
Current Events Research
Market Research
Technical Research
Product Research
Search Quality Control
Source Verification
Recent Information Priority
Advanced Search Configuration
Combined with Conversation History
Best Practices
- Specific Queries: Ask specific questions for better search results
- Time Sensitivity: Specify time frames for time-sensitive topics
- Source Quality: Request verification from reliable sources when needed
- Context Preservation: Use conversation history for follow-up questions
- Cost Awareness: Search-enabled agents use additional tokens
Cost Considerations
- Search Operations: Additional costs for web search access
- Token Usage: Increased token consumption for search results processing
- Quality Trade-off: Balance search quality with cost efficiency
Error Handling
Search Result Format
Search-enabled agents return the standard/v1/agent/completions response shape. The agent’s answer (with any web-sourced facts woven into the text) appears in outputs. The search tool’s $0.04 fee is deducted from your credits as a separate charge — it is not included in the usage.total_cost field, which covers token and image costs only:
Rate Limiting
Search operations have no extra rate limits of their own; they count against your account’s normal request limits (free tier):- Per Minute: 100 requests
- Per Hour: 350 requests
- Per Day: 1200 requests