search

# Live Search (Grok) Real-time web + news search with AI-summarized results and citations. **Flat $0.081 per call on Base ($0.08 + $0.001 network fee; $0.08 on Solana), at any `max_results`** — verified against live 402 quotes 2026-10-06. Best for *fresh* queries; for semantic / neural research use `blockrun_exa` instead. ## How to Call from MCP ```ts blockrun_search({ body: { query: "what's the consensus on the Fed's next move", sources: ["web", "news"], max_results: 10 }}) ``` ## Body Shape | Field | Required | Type | Notes | |---|---|---|---| | `query` | yes | string | Natural-language search query | | `sources` | no | string[] | Subset of `["web","news"]`. Default: `["web"]` — pass both for news coverage. There is no X/Twitter source (removed upstream 2026-07-05; asking for `"x"` is refused before payment). Does NOT multiply price. | | `max_results` | no | number | 1–50, default 10. Does **not** change the price — ask for as many sources as the question needs. | | `from_date` | no | string | `YYYY-MM-DD` lower bound on result date | | `to_date` | no | string | `YYYY-MM-DD` upper bound | ## When to Reach for Which Source | User intent | `sources` setting | |---|---| | Breaking news / today's headlines | `["news"]` | | Social / X sentiment | not served — there is no X source; use `["news","web"]` and say so, or `blockrun_exa` for a targeted crawl | | Backgrounder / explainer / docs | `["web"]` | | General "find current info" question | `["web","news"]` (omitting it searches the web only) | ## Worked Examples ### 1. "What's the latest on the ETH ETF approval timeline?" ```ts blockrun_search({ body: { query: "Ethereum ETF approval SEC", sources: ["news","web"], max_results: 8 } }) ``` **Cost: $0.081.** ### 2. "What happened in Solana's latest outage?" ```ts blockrun_search({ body: { query: "Solana outage today", sources: ["news","web"], max_results: 15 } }) ``` **Cost: $0.081.** There is no X/Twitter source: `sources: ["x"]` is refused before payment with the live list, so do not promise "what X is saying" — say what the news and web say. ### 3. "Background on Pectra upgrade, last 90 days only" ```ts blockrun_search({ body: { query: "Ethereum Pectra upgrade", sources: ["web","news"], from_date: "2026-02-17" }}) ``` **Cost: $0.081** (the default 10 sources — same price as any other count). ## search vs exa — Pick the Right Tool | Use case | Tool | |---|---| | "What's happening *right now*?" — freshness matters | `blockrun_search` | | "Find the canonical paper on X" — semantic relevance matters | `blockrun_exa` | | "Pull the full text of these 5 URLs" — content fetch | `blockrun_exa` `contents` | | "Cited answer to a question" | both work; `blockrun_exa answer` is grounded in pre-indexed corpus, `blockrun_search` searches the live web | ## Notes - Returns AI-summarized text + a list of sources with URLs. The summary is one paragraph; sources let you drill in. - **One flat price per call.** Neither `sources` nor `max_results` changes it: the upstream decides how many searches to run, so the count never drove the cost (repriced 2026-09-29). - Date filters are strict — results outside the window are dropped, not down-ranked. ## Reference - Endpoint: `POST /v1/search` - Upstream: xAI Grok Live Search