search

# Live Search (Grok) Real-time web + news search with AI-summarized results and citations. **PRICED PER SOURCE and expensive by default: $0.025 × `max_results`, +5% +$0.001 → default 10 settles $0.2635 per call.** 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. **Drives the price** — ~$0.0263 charged per source. Pass a small number to cap spend; the gateway prices the raw value and does not floor fractions. | | `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 curre...