App Logo
x.com

Read your X (Twitter) For You timeline

Automatically read your X (Twitter) For You timeline on x.com. 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 optional

How many to return. Without it, the script returns the first page X shows (often 20 to 40). With it, the script loads more until it has count, reaches the end, or X stops loading; complete says whether it reached the end.

Output

count required

Number of tweets returned. 0 is a valid answer.

tweets required
complete required

True when X showed the end of the feed and every one it sent is returned. False when there may be more: count was reached, X stopped loading, or no count was given and the first page is not the end.

FAQ

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.
Ask an AI agent connected to Reduck to run reduck/x.com/get_personal_feed, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/x.com/get_personal_feed
You do not need one. "Read your X (Twitter) For You timeline" drives the real x.com pages in a browser, so it works whether or not x.com offers an API for this.
Optional: count.
It returns count, tweets, complete.
Yes. It acts as you on x.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the x.com cookies saved by the Reduck extension.
It only reads. It looks things up on x.com and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/x.com/get_personal_feed, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/x.com/get_personal_feed
It is part of Reduck's official curated catalogue.

Start building not clicking