web_search
Read-only
Search the web in real time using an AI agent that browses pages, analyzes images, and provides answers with cited sources across multiple reasoning turns.
Instructions
Answer a query using agentic real-time web search.
Grok browses the web across multiple turns, optionally inspecting images on
pages, then synthesizes an answer with citations.
Args:
prompt: Search query or research question.
model: Grok model used to drive the agent (default `grok-4.3`).
allowed_domains: Restrict search to these domains (max 5, mutually exclusive with excluded).
excluded_domains: Exclude these domains from search (max 5).
enable_image_understanding: Let the agent analyze images it encounters.
enable_image_search: Let the agent search for and return image results.
include_inline_citations: Embed `[1]`-style citation markers into the answer text.
max_turns: Cap the agent's reasoning/tool turns.
show_usage: Append a token usage and cost footer to the answer (default False).
Returns:
Markdown with the answer body followed by a `**Sources:**` list of cited URLs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | grok-4.3 | |
| prompt | Yes | ||
| max_turns | No | ||
| show_usage | No | ||
| allowed_domains | No | ||
| excluded_domains | No | ||
| enable_image_search | No | ||
| include_inline_citations | No | ||
| enable_image_understanding | No |