social

get engagement analytics for specific posts. returns impressions, engagements, and other metrics over a time period.

get trending topics by location. use woeid 1 for worldwide, or a specific location id.

list accounts a user follows. returns profiles with bios, follower counts, and join dates.

list followers of a user. returns profiles with bios, follower counts, and join dates.

list users who liked a specific post. returns user profiles with follower counts.

list posts that quoted a specific post. returns quote tweets with text, author, and engagement metrics.

remove a bookmarked post on x.com.

bookmark a post on x.com.

list your bookmarked posts. returns saved posts with text, author, and engagement metrics.

list recent dm events. returns direct message text, sender, and timestamps.

get your recent mentions. returns posts that mention the authenticated user.

get your home timeline. returns recent posts from accounts you follow with engagement metrics.

list posts by a user. returns text, timestamps, engagement metrics, and article metadata.

publish long-form articles on x.com from markdown. supports headings, lists, blockquotes, code blocks, gfm tables, latex, images, embedded tweets, and inline formatting (bold, italic, strikethrough, links). optional cover image and draft-only mode.

search recent posts on x.com. use conversation_id to get replies to a tweet, or any x search query. returns up to 100 posts with text, author, and engagement metrics.

create threaded posts on x.com. provide 2-25 tweets that are posted sequentially as a reply chain. each tweet supports text (280 char limit) and optional media (up to 4 images or 1 video/gif). images over 5mb are auto-resized.

send a direct message on x.com. requires the recipient's user id (not username). text-only messages; media attachments are not supported.

follow a user on x.com by user id. succeeds silently if already following.

get a user profile from x.com by id or username. returns bio, follower/following counts, tweet count, verified status, and profile image url.

retweet a post on x.com by post id. succeeds silently if already retweeted.

like a post on x.com by post id. succeeds silently if already liked.

delete a post from x.com by post id. can only delete posts authored by the authenticated account.

get a post by id from x.com. returns text, author id, creation date, and engagement metrics (likes, retweets, replies, quotes).

create posts on x.com with text (280 char limit) and optional media. supports up to 4 images or 1 video/gif. can reply to or quote other posts. images over 5mb are auto-resized.

probe user posts and timeline for article metadata