Get X For You feed
Get tweets from your personal For You home feed — the timeline as shown: top-level posts plus the replies and quote-tweets X threads in. Returns per tweet: id, url, author {id, handle, name}, text, created_at, lang, likes, retweets, replies, quotes, bookmarks, views, is_retweet, is_quote, plus ref objects retweeted_tweet/quoted_tweet/in_reply_to (each {id, author_handle}, null when N/A). For a retweet the id is the wrapper, not the original — join via retweeted_tweet.id; in_reply_to != null is the reply test. Count is capped by how far the feed paginates before throttling.
Input
count optionalMax tweets to collect. The feed loads ~20-35 per fetch; the script scrolls to accumulate pages until count is met or the feed stops yielding new tweets.
Default: 20Output
tweets requiredFAQ
Search X tweets
Search X for tweets, supporting all X search operators; the tab arg picks 'top' (ranked sample, default) or 'latest' (chronological). Returns per tweet a canonical record: id, url, author {id, handle, name}, text, created_at, lang, likes, retweets, replies, quotes, bookmarks, views, is_retweet, is_quote, plus followers (the author's follower count, a search-only enrichment), and the top-level query and count. Top is a ranked sample, not exhaustive.
Delete tweet
Delete one of your own tweets given its URL. Returns the deleted tweet id and a deleted flag.
Get X user posts
Get a user's Posts tab by handle (x.com/<handle>) — their own tweets and self-threads, newest first. Excludes replies to others (see get_user_replies for the Replies tab), and excludes reposts, which X keeps on a separate Reposts tab. The post count shown on the profile header includes replies, so expect fewer items than that number. Returns per tweet: id, url, text, created_at, lang, likes, retweets, replies, quotes, views, bookmarks, is_retweet, is_quote. Count is capped by how far X paginates before throttling.
