Docs · static mirror — the interactive version loads with JavaScript.

X (Twitter)

Source: https://runstack.engineer/docs/toolkits/x

Posts, users, likes, reposts, bookmarks, lists, spaces, DMs, media uploads, and analytics via the X API v2.

Tools (79):

ToolDescription
xCreatePostCreate a new post (tweet) on X: text, polls, media, quotes, replies, geo.
xDeletePostDelete a post owned by the authenticated user by post ID.
xLookupPostLook up a single post by ID with expansions and field selections.
xLookupPostsLook up up to 100 posts by IDs in one request.
xRecentSearchSearch posts from the last 7 days: conversations, mentions, hashtags.
xFullArchiveSearchSearch the full archive of public posts by query.
xRecentCountsCount posts from the last 7 days matching a query over time.
xFullArchiveCountsCount posts across the full archive matching a query over time.
xPostAnalyticsEngagement analytics for posts over a time range: impressions, likes, replies.
xPostUsageX API tweet usage stats for the project: consumption, caps, daily breakdowns.
xHideReplyHide or unhide a reply to your own conversation (tweet.moderate.write).
xQuotePostsGet posts that quote a specific post.
xStreamLabelsStream labeling events applied to posts (compliance label stream).
xLikePostLike a post on behalf of the authenticated user.
xUnlikePostUnlike a post on behalf of the authenticated user.
xListLikersGet users who liked a specific post.
xLikedPostsGet posts liked by a user ID.
xRetweetPostRepost (retweet) a post on behalf of the authenticated user.
xUnretweetPostUndo a repost by source post ID.
xRepostersGet users who reposted a specific post.
xRepostsGet reposts of a specific post with post objects.
xFollowUserFollow a user on behalf of the authenticated user.
xUnfollowUserUnfollow a user on behalf of the authenticated user.
xFollowersGet followers of a user by user ID.
xFollowingGet accounts a user is following by user ID.
xBlockedUsersGet accounts blocked by the authenticated user.
xMutedUsersGet accounts muted by the authenticated user.
xMuteUserMute a user on behalf of the authenticated user.
xUnmuteUserUnmute a user on behalf of the authenticated user.
xGetUserByIdGet a user profile by user ID.
xLookupUserByUsernameGet a user profile by username (without @).
xGetUsersByIdsGet up to 100 user profiles by IDs in one request.
xLookupUsersByUsernamesGet up to 100 user profiles by usernames in one request.
xLookupMeGet the authenticated user profile and ID.
xHomeTimelineReverse-chronological home timeline of the authenticated user.
xGetBookmarksGet posts bookmarked by the authenticated user.
xAddBookmarkAdd a post to the authenticated user bookmarks.
xRemoveBookmarkRemove a post from the authenticated user bookmarks.
xCreateListCreate a new List owned by the authenticated user.
xGetListGet a List by ID.
xUpdateListUpdate a List name, description, or privacy.
xDeleteListDelete a List owned by the authenticated user.
xAddListMemberAdd a user to a List you own.
xRemoveListMemberRemove a user from a List you own.
xListMembersGet members of a List.
xListFollowersGet followers of a List.
xFollowListFollow a List on behalf of the authenticated user.
xUnfollowListUnfollow a List on behalf of the authenticated user.
xPinListPin a List to the authenticated user profile.
xUnpinListUnpin a List from the authenticated user profile.
xOwnedListsGet Lists owned by a user.
xFollowedListsGet Lists followed by a user.
xListMembershipsGet Lists a user is a member of.
xPinnedListsGet Lists pinned by a user.
xListTimelineGet the timeline of posts from a List by List ID.
xGetSpaceGet a Space by ID.
xGetSpacesByIdsGet up to 100 Spaces by IDs in one request.
xSpacesByCreatorsGet Spaces created by given user IDs.
xSearchSpacesSearch live or scheduled Spaces by keyword.
xSpaceBuyersGet users who bought tickets for a ticketed Space.
xSpacePostsGet posts shared in a Space.
xCreateDmConversationCreate a group DM conversation with an opening message.
xSendDmToConversationSend a message to an existing DM conversation.
xSendDmToUserSend a new one-to-one DM to a user by user ID.
xDmEventsByParticipantGet DM events for the one-to-one conversation with a user.
xDmEventsByConversationGet DM events for a conversation by conversation ID.
xRecentDmEventsGet recent DM events across all conversations (30 days).
xGetDmEventGet a single DM event by event ID.
xDeleteDmDelete a DM event you sent by event ID.
xInitMediaUploadInitialize a chunked media upload session for videos, GIFs, large files.
xAppendMediaUploadAppend a base64 media chunk to an upload session.
xMediaUploadStatusPoll media processing status until succeeded before posting.
xUploadMediaUpload a small media file in one request (base64).
xUploadLargeMediaUpload a large media file via initialize, append, finalize in one call.
xCreateComplianceJobCreate a compliance job for post or user IDs.
xGetComplianceJobGet a compliance job by ID.
xListComplianceJobsList compliance jobs by type and status.
xCreateActivitySubscriptionSubscribe to X activity events: follows, profile updates, spaces, news.
xGetOpenApiSpecFetch the official X API v2 OpenAPI spec summary and operations.