Get the quote tweets of a post on X (Twitter)
TL;DR
About
Paste a post URL and you get back the quotes X lists under it, each with the quoter's own comment, handle, timestamp and engagement counts. The original post is not repeated, so pair this with get_tweet if you need its text and numbers. Say a SaaS founder tweets that the $12 plan is moving to $19 and has 70 quotes by lunch. With count raised to 100, they sort by views, leaving the few with null views at the bottom, and read the top five to see whether the angry takes are the ones getting seen. That decides who gets a reply first. The catch is that you only get what X's quotes list loads for your account, which leaves out quotes from protected accounts you don't follow. Scrolling also gives up after two scrolls in a row bring nothing new, so treat the count as what X served, not a census.
Input
url optionalFull URL of the post whose quotes you want, e.g. 'https://x.com/<handle>/status/<id>'. Pass this or urls.
urls optionalSeveral post URLs (max 10), read one after another in the same page, instead of url. count applies to each. Returns {results}, one per post in order, each with error null or what went wrong. A rate limit, lock or sign-in wall stops the batch: the remaining posts carry that error.
count optionalHow 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
url optionalcount optionalNumber of quotes returned. 0 is a valid answer.
tweets optionalresults optionalWith urls only: one result per post, in order, with the same fields as a single answer (url, count, complete, tweets) plus error. When error is set, only url and error are present.
complete optionalTrue when X showed the end of the quotes 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.
Example output
Shape only: placeholder values generated from the output schema, not a real run.
{
"url": "https://example.com/item/123",
"count": 3,
"tweets": "…",
"results": [
{
"url": "https://example.com/item/123",
"count": 3,
"error": "…",
"tweets": "…",
"complete": true
}
],
"complete": true
}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)
Get a tweet on X (Twitter) by URL, with the conversation around it: `tweet` (the post itself) and `replies` (every other post of its conversation on the page: the thread above it when it is a reply, and the replies below; use in_reply_to to rebuild the thread). Each post has id, url, author, text, created_at, lang, counts, in_reply_to and quoted_tweet. With count, it loads more replies until it has count or X reaches the end. complete is true only when X reached the end and left no folded replies (Show replies, hidden or probable-spam sections), which this script does not open. A deleted or unavailable tweet is an error. Requires being signed in to X.
X (Twitter) profile unofficial API: get a user's bio and followers
Look up an X (Twitter) user's profile by handle. Returns handle, user_id, name, bio, location, website, joined, followers_count, following_count, is_verified, is_self, is_following, follows_you. Counts are exact integers. bio and website carry the real destination URLs, with X's shortlinks resolved. is_following is null on your own profile. Any of is_self, is_following, follows_you and is_verified is null when X does not say. Requires being signed in to X; a missing or suspended account is an error that says which.