See who reposted (retweeted) a post on X (Twitter)
TL;DR
About
X already lists who reposted a public post on its Reposts tab (the post URL plus /retweets), but only as a feed you scroll by hand. get_reposters opens that tab, keeps scrolling, and turns each account into a row you can sort. The count input defaults to 100 and goes up to 1,000, so raise it for a busy post. A founder whose launch post picked up 180 reposts runs it with count at 200, sorts by followers, and finds four accounts with large followings next to a cluster of blank-bio accounts each following about 5,000 people, which looks a lot like an engagement pod. Those four go into a private X List (create_list, then add_to_list per handle) so the founder can watch what they post next. The catch is that X serves a sample of reposters rather than the full set, so on a viral post the list stops a few hundred in whatever count you ask for.
Input
url requiredFull URL of the X post, e.g. 'https://x.com/<handle>/status/<id>'. Query/hash are stripped.
count optionalMax reposters to return. Scrolls until count is met or the list dries up. Default 100.
Default: 100Output
url requiredcount requiredNumber of reposters returned. 0 is a first-class outcome (no reposts, or reposters hidden).
reposters requiredaccount_used requiredhandle of the logged-in account that performed this lookup, read from the account switcher UI (not assumed from input) — audit-trail consistency with the action scripts.
Example output
Shape only: placeholder values generated from the output schema, not a real run.
{
"url": "https://example.com/item/123",
"count": 3,
"reposters": [
{
"bio": "…",
"name": "Example",
"handle": "…",
"tweets": 3,
"user_id": "abc123",
"website": "…",
"location": "…",
"verified": true,
"followers": 1200,
"following": 3
}
],
"account_used": "…"
}FAQ
X (Twitter) search unofficial API: search tweets, no API key
Search X (Twitter) for tweets with every X search operator, from the Top tab (a ranked sample, the default) or the Latest tab (chronological), picked by the tab arg. 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.
Get a tweet and its replies on X (Twitter)
Fetch a tweet by URL — the focal post plus the surrounding conversation. Returns `tweet` (the focal post; null if deleted/tombstoned) and `replies[]`, which holds every other tweet on the conversation page: both the focal's ancestors (the thread above it, present when the focal is itself a reply; each has `in_reply_to` null or pointing above the focal) and the replies below it (`in_reply_to` points at the focal or a sibling reply). Use `in_reply_to` to tell ancestors from replies and rebuild the thread — the array is not filtered to descendants of the focal. Each entry is a canonical tweet record: id, url, author {id, handle, name}, text, created_at, lang, likes, retweets, replies, quotes, bookmarks, views, is_retweet, is_quote, in_reply_to {id, author_handle}. Scrolls the main thread until `count` is met (then complete=false — more may exist) or it drains (complete=true). Replies behind a "Show more replies"/hidden/probable-spam cursor are not expanded, so even complete=true is a floor, not a guarantee every nested reply was seen.
X (Twitter) posts unofficial API: export a user's tweets and stats
An unofficial X (Twitter) API for a user's posts: export an account's latest tweets with their views, likes, reposts, replies, quotes and bookmarks as data, in one call, without the X API. For the owner-only analytics of each post (impressions, engagements), run get_post_analytics on its id. Get a user's latest posts by handle (x.com/<handle>, the Posts tab), newest first: their own tweets and self-threads, without replies (see get_user_replies) or reposts (see get_user_reposts). Works signed in or signed out. Signed in, it reads the full Posts tab up to count. Signed out, X only shows visitors its few most recent posts, so it returns that short preview and fewer than count is expected; each post's source field says which one you got. Returns per tweet: id, url, text, created_at, lang, likes, retweets, replies, quotes, views, bookmarks, is_retweet, is_quote, source.