Skip to main content
The Swarms API supports search-enabled agents that can access real-time web information using integrated search capabilities. This allows agents to provide up-to-date answers and research current topics.
Enable web search by setting "tools_enabled": ["auto_search"] in your request to access current information and real-time data.

Quick Start

Search Integration

When tools_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

  1. Specific Queries: Ask specific questions for better search results
  2. Time Sensitivity: Specify time frames for time-sensitive topics
  3. Source Quality: Request verification from reliable sources when needed
  4. Context Preservation: Use conversation history for follow-up questions
  5. 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, and the search tool’s cost is deducted from your credits and reflected in total_cost:

Rate Limiting

Search operations may have additional rate limits:
  • Per Minute: 10 search requests
  • Per Hour: 100 search requests
  • Per Day: 500 search requests
Implement exponential backoff for rate limit handling: