x_search
Read-only
Searches X posts, threads, and users with filters for handles and dates. Analyzes images and videos to answer queries with cited sources.
Instructions
Answer a query using agentic search over X (Twitter).
Searches posts, threads, and users on X. Can filter by handle allow/deny
lists and a date range, and optionally analyze images/videos attached to posts.
Args:
prompt: Search query or question about X content.
model: Grok model driving the agent (default `grok-4.3`).
allowed_x_handles: Restrict search to these handles (max 10, mutually exclusive with excluded).
excluded_x_handles: Exclude these handles (max 10).
from_date: Inclusive start date as `DD-MM-YYYY`.
to_date: Inclusive end date as `DD-MM-YYYY`.
enable_image_understanding: Let the agent analyze images in posts.
enable_video_understanding: Let the agent analyze videos in posts (X Search only).
include_inline_citations: Embed `[1]`-style citation markers into the answer.
max_turns: Cap the agent's reasoning/tool turns.
Returns:
Markdown with the answer body followed by a `**Sources:**` list of cited posts.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | ||
| model | No | grok-4.3 | |
| allowed_x_handles | No | ||
| excluded_x_handles | No | ||
| from_date | No | ||
| to_date | No | ||
| enable_image_understanding | No | ||
| enable_video_understanding | No | ||
| include_inline_citations | No | ||
| max_turns | No |