Search X tweets

Search X for tweets, supporting all X search operators. Returns per tweet: handle, name, followers, text, likes, retweets, replies, quotes, views, date, url, plus the query and count. Gotcha: the top tab is a ranked sample, not exhaustive; combining -filter:replies with min_faves and since can return zero results.

Version 1 (6/11/26, 1:00 PM)

Author Reduck AI - @reduck

Output

query required

Raw X search query. Supports all X search operators, e.g. '"AI automation" min_faves:500 since:2026-06-04'. Note: -filter:replies combined with min_faves+since can return zero results (X quirk); prefer fewer combined operators.

tab optional

Which search tab: 'top' (ranked, default) or 'latest' (chronological). Top is a sample, not an exhaustive ranking.

count optional

Max tweets to return. The script scrolls until count is met or results dry up. Default 20, max 100.

Output

count required

Number of tweets returned. 0 is a first-class outcome (no results for the query).

query required

tweets required