Web
Search X
Search X (Twitter) for posts and users matching a query.
Parameters#
querystringrequiredNatural language prompt describing what to find on X.
allowed_x_handlesstring[]default: []Only include posts from these X handles (max 10). Cannot be used with excluded_x_handles.
excluded_x_handlesstring[]default: []Exclude posts from these X handles (max 10). Cannot be used with allowed_x_handles.
time_rangestringdefault: anytimeRecency 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.
from_datestringdefault: ""Start date (YYYY-MM-DD). If set, only results on/after this date are considered. Takes precedence over time_range.
to_datestringdefault: ""End date (YYYY-MM-DD). If set, only results on/before this date are considered.
enable_image_understandingbooleandefault: trueIf true, allow the agent to view and interpret images from X posts.
enable_video_understandingbooleandefault: trueIf true, allow the agent to view and interpret videos from X posts.