> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zocomputer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search X

> Search X (Twitter) for posts and users matching a query.

{/* Tool: x_search */}

## Parameters

<ParamField path="query" type="string" required={true}>
  Natural language prompt describing what to find on X.
</ParamField>

<ParamField path="allowed_x_handles" type="string[]" default={[]}>
  Only include posts from these X handles (max 10). Cannot be used with excluded\_x\_handles.
</ParamField>

<ParamField path="excluded_x_handles" type="string[]" default={[]}>
  Exclude posts from these X handles (max 10). Cannot be used with allowed\_x\_handles.
</ParamField>

<ParamField path="time_range" type="string" default={"anytime"}>
  Recency window for results: "anytime", "day", "week", "month", "year" (aliases: "a", "d", "w", "m", "y"), or a shorthand like "4h", "48h", "7d", "2w". "anytime" applies no date filter. Unrecognized values are treated as "anytime". When both an explicit date range and time\_range are given, the explicit dates win.
</ParamField>

<ParamField path="from_date" type="string" default={""}>
  Start date (YYYY-MM-DD). If set, only results on/after this date are considered. Takes precedence over time\_range.
</ParamField>

<ParamField path="to_date" type="string" default={""}>
  End date (YYYY-MM-DD). If set, only results on/before this date are considered.
</ParamField>

<ParamField path="enable_image_understanding" type="boolean" default={true}>
  If true, allow the agent to view and interpret images from X posts.
</ParamField>

<ParamField path="enable_video_understanding" type="boolean" default={true}>
  If true, allow the agent to view and interpret videos from X posts.
</ParamField>