search
Search the web to retrieve full page content for factual lookups and specific questions. Optionally get AI-synthesized answers or filter by news and recency.
Instructions
Search the web for current information on any topic. Returns extracted page content, not just snippets. Best for factual lookups, specific questions, or when you need a list of sources. For open-ended questions that need synthesis across many sources, use the research tool instead.
For news queries (current events, breaking news, politics, world events), set topic="news" to search news sources specifically. This returns recent articles with publication dates.
Set include_answer=true to get an AI-synthesized answer alongside results (adds 5 credits). This is the sweet spot for most agent tasks, e.g. basic + include_answer = 8 credits, much cheaper than a full 25-credit research call.
Returns: query, answer (if requested), results (array of {title, url, content, description, fetched, published_date}), search_depth, topic, elapsed_ms, credits_used, credits_remaining, altered_query.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The search query | |
| topic | No | "general" for web search, "news" for news articles. Use "news" for current events, breaking news, politics, or any time-sensitive query | general |
| freshness | No | Filter by recency: "day", "week", "month", "year", or "YYYY-MM-DD:YYYY-MM-DD" | |
| max_results | No | Number of results (default 10, max 20) | |
| search_depth | No | "basic" (default) for extracted page content (3 credits), "snippets" for SERP snippets only without page fetching (1 credit) | basic |
| include_answer | No | Generate an AI answer that synthesizes the search results (adds 5 credits) | |
| exclude_domains | No | Exclude results from these domains (max 10) | |
| include_domains | No | Only include results from these domains (max 10) |