Get X (Twitter) user profile
Input
handle requiredX handle without the leading @. Case-insensitive; the result carries the canonical casing.
Output
name requiredhandle requiredCanonical handle as returned by X (may differ in casing from the input).
is_self requiredTrue when this profile is the signed-in viewer's own; null when X does not say who the viewer is.
user_id requiredNumeric rest_id.
follows_you requiredWhether they follow you; null when X does not say.
is_verified requiredBlue/verified badge; null when X does not say.
is_following requiredWhether you follow them; null on your own profile or when X does not say.
bio optionalProfile bio text, with any t.co shortlinks replaced by their real destination (as the page displays them); null when empty.
joined optionalAccount creation date in X's format, e.g. 'Tue Jun 02 20:12:29 +0000 2009'.
website optionalExpanded profile URL; null when the profile has none.
location optionalProfile location; null when empty.
followers_count optionalExact follower count as an integer.
following_count optionalExact count of accounts this profile follows; 0 is a real value.
FAQ
Search X (Twitter) posts
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.
Get X (Twitter) user posts
Get an X (Twitter) user's latest posts by handle (the Posts tab of x.com/<handle>), with their views, likes, reposts, replies, quotes and bookmarks. Returns { posts, complete }; until 16 Oct 2026 the answer was the bare posts array, so a caller written before then reads result.posts now. Posts come in the order X shows them: the pinned post, if any, first, then newest first, with each self-thread kept in thread order. complete is true only when X marked the end of the tab and every post fits in count. Replies (see get_user_replies) and reposts (see get_user_reposts) are not included. Works signed in or signed out. Signed out, X only shows visitors a short preview of recent posts, so fewer than count is expected, complete is false, and in_reply_to and quoted_tweet are not available; each post's source field says which one you got.