Web Search
searchSearch the web with SERP, AI synthesis, or both. Returns, by mode: serp the organic results (title, url, snippet, position, and the displayed link, date and sitelinks where Google shows them) with the page's People also ask questions, related searches, answer box, top stories and knowledge graph; ai a written answer with the URLs it cites; deep both. Use for current facts, news and finding pages. To read one page in full use scrape; for a report built from many sources use research. Cost: serp 1 credit, ai 2 credits, deep 3 credits, charged only when a call succeeds.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Mode: serp (Raw Google SERP results), ai (AI-synthesized answers with citations), deep (SERP + AI synthesis combined). | |
| query | Yes | The search query. | |
| country | No | ISO country code of the Google results (serp and deep modes). | us |
| freshness | No | Only sources from this window, in every mode. | any |
| num_results | No | Maximum number of organic results (serp and deep modes). |