Web Search POST

Perform a web search to get real-time information.

Input Schema

Parameter	Type	Description
query	string	The search query to perform.

REST Endpoint

The REST equivalent accepts multiple queries in a single call, executes them via Tavily, and saves the results to the Data Analyst agent’s memories.


POST /api/agents/dataAnalyst/search


POST /api/agents/dataAnalyst/search
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
 
{
  "site_id": "YOUR_SITE_ID",
  "search_queries": ["AI trends 2026", "top CRM tools for SaaS"],
  "search_options": {
    "search_depth": "basic",
    "max_results": 10,
    "include_answer": true
  }
}

Field	Type	Description
site_id	string	Site UUID (required). Used to locate the Data Analyst agent.
search_queries	array	One or more search queries to execute.
search_options.search_depth	string	`basic` or `advanced`. Default: `basic`.
search_options.max_results	number	Max results per query. Default: 10.
search_options.include_answer	boolean	Include a synthesized answer. Default: true.
agent_id	string	Optional. Target a specific agent instead of the site’s Data Analyst.

Response:


{
  "success": true,
  "data": {
    "agent_id": "...",
    "total_queries": 2,
    "successful_searches": 2,
    "failed_searches": 0,
    "search_results": [
      {
        "query": "AI trends 2026",
        "success": true,
        "results_count": 10,
        "answer": "...",
        "memory_id": "..."
      }
    ],
    "memory_ids": ["...", "..."]
  }
}