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

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

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

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

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

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

bookmark-remove
remove a bookmarked post on x.com.

bookmark-add
bookmark a post on x.com.

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

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

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

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

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

probe-timeline
probe user posts and timeline for article metadata

article-publish
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.

post-search
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.

post-thread
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.

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

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

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

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

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

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

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

post-create
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.
explore more on inference shell
x is one of many providers on the grid. discover hundreds of apps across image, video, audio, and more.
we use cookies
we use cookies to ensure you get the best experience on our website. for more information on how we use cookies, please see our cookie policy.
by clicking "accept", you agree to our use of cookies.
learn more.
