X (Twitter)
X (Twitter) · 225 endpoints
- Create a draft X ArticleCreate draft Article
- Publish a drafted Article by article idPublish Article
- Create a bookmark folderCreate Bookmark Folder
- Send a chat message to a live broadcastSend a chat message to a live broadcast
- Schedule a broadcastCreate a scheduled broadcast
- Delete a scheduled broadcast by idDelete a scheduled broadcast
- Look up a scheduled broadcast by idGet a scheduled broadcast
- Go live on a scheduled broadcast by idGo live on a scheduled broadcast
- List scheduled broadcastsList scheduled broadcasts
- Update a scheduled broadcast by idUpdate a scheduled broadcast
- Look up a chat conversation by idGet Chat Conversation
- List events in a chat conversation by idGet Chat Conversation Events
- List your chat conversationsGet Chat Conversations
- Create a group chat conversationCreate Chat Group Conversation
- Initialize a chat groupInitialize Chat Group
- Add members to a group chat conversationAdd members to a Chat group conversation
- Download a chat media file by idDownload Chat Media
Chat media upload
- Append to a chat media uploadAppend Chat Media Upload
- Finalize a chat media uploadFinalize Chat Media Upload
- Initialize a chat media uploadInitialize Chat Media Upload
- Delete chat messages in a conversationDelete Chat messages
- Send a chat message to a conversationSend Chat Message
Community details
- X (Twitter) community details by URLRetrieves details about a Twitter/X Community by URL.
- Look up a Community by idGet Communities by ID
- X (Twitter) community tweets by URLFetches tweets posted within a Twitter/X Community by URL.
- Search Communities by keywordSearch Communities
- Write a Community NoteCreate Community Notes
- Delete a Community Note by idDelete a Community Note
- Posts eligible for Community NotesSearch Eligible Posts
- Evaluate a Community NoteEvaluate Community Notes
- Community Notes you have writtenSearch Community Notes Written
- Start a group direct message conversationCreate DM conversation
- Delete a direct message event by event idDelete DM event
- Look up a direct message event by event idGet Direct Messages Events by ID
Direct messages
- List your direct message eventsGet Direct Messages Events
- Direct message history by conversation idGet Direct Messages Events by Conversation ID
- Direct message history with a user by participant idGet Direct Messages Events by Participant ID
- Download media from a direct messageDownload DM Media
Send direct message
- Send a direct message by conversation idCreate Direct Messages by Conversation ID
- Send a direct message to a user by participant idCreate DM message by participant ID
- Create a ListCreate Lists
- Delete a List by list idDelete List
- Look up a List by list idGet Lists by ID
List follow
- Follow a ListFollow List
- Unfollow a List by list idUnfollow a List
- Followers of a List by list idGet Lists Followers
- Add a member to a ListAdd Lists Member
- Remove a member from a List by user idRemove a List member
- Members of a List by list idGet Lists Members
Pin list
- Pin a ListPin List
- Unpin a List by list idUnpin a List
- Tweets from a List timeline by list idGet Lists Posts
- Update a List by list idUpdate List
- Analytics for your media by media keysGet Media analytics
Media details
- Look up one media item by media keyGet Media by media key
- Look up media by media keysGet Media by media keys
- Create metadata for uploaded mediaCreate Media metadata
- Add subtitles to uploaded mediaCreate Media subtitles
- Delete subtitles from uploaded mediaDelete Media subtitles
Media upload
- Append to a media upload by idAppend Media Upload
- Finalize a media upload by idFinalize Media upload
- Initialize a media uploadInitialize media upload
- Upload a media fileUpload media
- Check media upload status by media idGet Media upload status
- Look up news stories by idGet news stories by ID
- Analytics for your tweets by post idsGet Posts Analytics
- Bookmark a tweetCreate Users Bookmark
- Remove a bookmark by post idDelete Bookmark
Post replies
- X / Twitter Post RepliesFetch the replies to any X (Twitter) post URL as structured records: author, text, and engagement. An empty result is valid and does not assert whether the target post exists.
- X (Twitter) post comments by tweet idRetrieves the latest comments for an X (Twitter) post identified by tweet ID, with cursor pagination.
- X (Twitter) newest post comments by tweet idTwitter: fetch latest post comments (web)
- X (Twitter) post comments by tweet idTwitter: fetch post comments (web)
- Replies to an X (Twitter) postThe replies to one X (Twitter) post, one row per reply: id, author, author name, text, time, likes, replies, reposts, views and link, in X's own order (most relevant first). `tweet` is the post's URL (https://x.com/NASA/status/2095890075447964086) or its id. `limit` up to 100; X gives about 9-12 replies per page and a run reads at most 8 pages. `session` is required: your `auth_token` and `ct0` cookies, copied with the Crawl4AI Session extension; used for this run only and never stored. One fetch per page; a wrong session costs one unit. Columns: id, author, author_name, text, posted_at, likes, replies, reposts, views, url.
- x.post.comments — routed: best of 3 providers, own keys firstReplies to an X (Twitter) post by tweet id — provider-native rows in `comments`
- x.post.comments — routed: best of 3 providers, own keys firstReplies to an X (Twitter) post by tweet id — provider-native rows in `comments`
Post counts
- Count tweets matching a query — full archiveGet Posts Counts All
- Count tweets matching a query — last 7 daysGet Posts Counts Recent
- Post a tweet to your own X accountPublish a post to your own X account
- Delete a tweet by post idDelete Posts
Post details
- X (Twitter) post details by tweet idTwitter: fetch tweet detail (web)
- X (Twitter) post details by URLX (formerly Twitter) - Posts
- X (Twitter) tweet by URL — author, engagementRetrieves detailed information about a specific tweet by URL, including the author's profile and engagement metrics.
- Look up a tweet by post idGet Posts by ID
- Look up tweets by post idsGet Posts by IDs
Like post
- Like a postLike Post
- Unlike a post by post idUnlike Post
- Users who liked a tweet by post idGet Posts Liking Users
- Quote tweets of a post by post idGet Posts Quoted Posts
- Reply to a tweet or continue your thread by post idReply to an X post, or continue your own thread
- Hide a reply to your tweet by post idHide reply
Repost
- Repost a tweetRepost Post
- Undo a repost by post idUnrepost Post
Reposters
- X (Twitter) users who reposted by tweet idTwitter: fetch retweet user list (web)
- Users who reposted a tweet by post idGet Posts Reposted by
- Reposts of a tweet by post idGet Posts Reposts
- Stream tweets matching your filter rulesStream filtered Posts
Filtered stream rules
- List filtered-stream rulesGet filtered-stream rules
- Add or delete filtered-stream rulesUpdate stream rules
- X (Twitter) video tweet transcript by URLExtracts the transcript from a Twitter video tweet using AI-powered transcription.
- Search news stories by keywordSearch News
Search posts
- X / Twitter SearchSearch X (Twitter) with full advanced-search syntax (operators like from:, since:, until:, min_faves: work inline in the query) and get structured tweets with text, author, engagement, and cursor pagination. Limit is a per-page maximum; native pages contain approximately 20 tweets unless requireSinglePage selects a bulk lane.
- Search X (Twitter) by keyword — top, latest, media, peopleSearches X (Twitter) by keyword across top, latest, media, people, or list result modes with cursor pagination.
- Search X (Twitter) posts by keywordTwitter: fetch search timeline (web)
- Search posts on X (Twitter)The posts X (Twitter) returns for a search, one row per post, in X's order: id, link, text, time, author, counts, views, language, media, and whether it is a reply, a quote or a repost. `query` is X search text (rust lang, from:nasa since:2026-10-01); `mode` latest or top; `limit` up to 100. `session` is your X login (`auth_token` and `ct0`, from the Crawl4AI Session extension), for this run only. Without it, only from:<account> (since:/until: allowed) in mode latest: the account's timeline, newest first; older days via a slower second source. Other queries are refused, not billed. Columns: id, url, text, created, author, author_name, likes, reposts, replies, quotes, views, language, media, is_reply, is_quote, is_repost.
- x.search.posts — routed: best of 3 providers, own keys firstSearch X (Twitter) posts by keyword — provider-native rows in `posts`
- x.search.posts — routed: best of 3 providers, own keys firstSearch X (Twitter) posts by keyword — provider-native rows in `posts`
- Search the full tweet archive by keyword querySearch Posts All
- Search tweets from the last 7 days by keywordSearch Posts Recent
- Search Spaces by keywordSearch Spaces
- Search users by keywordSearch Users
- Spaces hosted by creators, by user idsGet Spaces by Creator IDs
Space details
- Look up a Space by space idGet Spaces by ID
- Look up Spaces by space idsGet Spaces by IDs
- Tweets shared in a Space by space idGet Space Posts
- Ticket buyers of a Space by space idGet Space ticket buyers
- Personalized trends for the connected userGet Trends Personalized Trends
Trending topics
- X (Twitter) trending topics by countryTwitter: fetch trending (web)
- Trending topics by location WOEIDGet Trends by Woeid
- Affiliated accounts of a user by user idGet Users Affiliates
- Accounts a user has blocked, by user idGet Users Blocking
- Your bookmark folders by user idGet Users Bookmark Folders
Bookmarks
- Your bookmarked tweets by user idGet Users Bookmarks
- Bookmarked tweets in a folder by folder idGet Users Bookmarks by Folder ID
DM blocking
- Block direct messages from a user by user idBlock Users Dms
- Unblock direct messages from a user by user idUnblock Users Dms
Follow user
- Follow a user by user idFollow User
- Unfollow a user by user idUnfollow User
- Lists a user follows, by user idGet Users Followed Lists
User followers
- X (Twitter) user's followers by handleTwitter: fetch user followers (web)
- Followers of a user by user idGet Users Followers
Following
- X (Twitter) accounts a user follows by handleTwitter: fetch user followings (web)
- Accounts a user follows, by user idGet Users Following
- Tweets a user has liked, by user idGet Users Liked Posts
- Lists a user is a member of, by user idGet Users List Memberships
- X (Twitter) user's media posts by handleTwitter: fetch user media (web)
- Tweets mentioning a user by user idGet Users Mentions
Mute user
- Mute a user by user idMute User
- Unmute a user by user idUnmute User
- Accounts a user has muted, by user idGet Users Muting
- Lists a user owns, by user idGet Users Owned Lists
- Lists a user has pinned, by user idGet Users Pinned Lists
User posts
- X / Twitter User Tweets and RepliesGet up to the requested limit of tweets and replies authored by an X (Twitter) account, with engagement, views, language, and cursor pagination where available.
- X / Twitter User PostsGet an X (Twitter) account's profile Posts-tab timeline by handle. Results follow profile order: a pinned post may appear first, followed by otherwise reverse-chronological authored posts, reposts, quotes, and self-thread continuations.
- Posts of an X (Twitter) accountThe latest posts of one X (Twitter) account, one row per post: id, link, text, likes, reposts, replies, quotes, time, whether it is a repost, and the author. `username` is the handle (nasa or @nasa), the profile URL or X's numeric user id (11348282). `limit` up to 100; X gives about 15-20 posts a page and a run reads at most two pages. `session` is your own X login (the `auth_token` and `ct0` cookies, from the Crawl4AI Session extension) (optional), used for this run only, never stored. Without it the run reads X as a visitor; when X shows a visitor nothing, a slower second source answers. Columns: id, url, text, likes, retweets, replies, quotes, created, is_retweet, author.
- X (Twitter) user posts by numeric user idRetrieves posts published by an X (Twitter) user identified by Rest ID, with cursor pagination.
- X (Twitter) user tweets by usernameFetches tweets from a Twitter user's profile by handle.
- X (Twitter) user's posts by handle or user idRecent posts of an X (Twitter) user
- Recent tweets of a user by user id — engagement metricsList the recent posts of an X user (your own or any public account)
- x.user.posts — routed: best of 5 providers, own keys firstList an X (Twitter) user's recent posts — provider-native post objects in `posts`
- x.user.posts — routed: best of 5 providers, own keys firstList an X (Twitter) user's recent posts — provider-native post objects in `posts`
User profile
- Twitter ProfileFetch a Twitter/X account's public profile (followers, tweets, bio, verification) by handle.
- X (Twitter) profile by URLX (formerly Twitter) - Profiles
- An X (Twitter) profileOne X (Twitter) account as one row: username, name, bio, followers, following, tweet count, join date, location, website, verified badge, profile image and user id. `username` is the handle (nasa or @nasa) or the profile URL. `session` is your own X login (the `auth_token` and `ct0` cookies, from the Crawl4AI Session extension), optional, used for this run only and never stored. Without it the run reads X as a visitor; when X gives nothing, a slower second source answers. Columns: username, name, bio, followers, following, tweets, created, location, website, verified, image, user_id.
- X (Twitter) user profile by numeric user idRetrieves an X (Twitter) user profile identified by its numeric Rest ID.
- X (Twitter) profile by username — account statsRetrieves a Twitter user's profile by handle, including account metadata and statistics.
- X (Twitter) profile by handle or user idPublic X (Twitter) profile by handle or numeric id
- Your connected X account profile — handle, followersGet the profile of the connected X account (handle, name, follower counts)
- X user profile by username — followers, bio, verifiedGet any public X user's profile by handle
- x.user.profile — routed: best of 5 providers, own keys firstGet an X (Twitter) user's public profile — treg picks the provider and names the one that served
- x.user.profile — routed: best of 5 providers, own keys firstGet an X (Twitter) user's public profile — treg picks the provider and names the one that served
- Look up a user by user idGet Users by ID
- Look up users by user idsGet Users by IDs
- Look up users by usernamesGet Users by Usernames
- X (Twitter) user's replies by handleTwitter: fetch user tweet replies (web)
- Reposts of your tweetsGet Users Reposts of Me
- Home timeline tweets, newest first, by user idGet Users Timeline
Account and utility endpoints
- Add an encryption public keyAdd public key
- Add encryption keys to a chat conversationAdd Conversation Keys
- Check an Account Activity subscription by webhook idValidate Account Activity Subscription
- Count your Account Activity subscriptionsGet Account Activity Subscription Count
- Count your filtered-stream rulesGet Rule Counts
- Create a compliance jobCreate Compliance Job
- Create a webhook replay jobCreate replay job for webhook
- Create an activity subscriptionCreate X activity subscription
- Delete a filtered-stream webhook link by webhook idDelete stream link
- Delete a webhook by webhook idDelete webhook
- Delete activity subscriptions by subscription idsDelete X activity subscriptions by IDs
- Delete an activity subscription by subscription idDeletes X activity subscription
- Encryption public keys of a user by user idGet public keys
- Firehose stream of English tweetsStream English Posts
- Firehose stream of Japanese tweetsStream Japanese Posts
- Firehose stream of Korean tweetsStream Korean Posts
- Firehose stream of Portuguese tweetsStream Portuguese Posts
- Firehose stream of all LikesStream all Likes
- Firehose stream of all tweetsStream all Posts
- History of streaming connectionsGet Connection History
- Link a webhook to the filtered stream by webhook idCreate stream link
- List Account Activity subscriptions by webhook idGet Account Activity Subscriptions
- List compliance jobs by typeGet Compliance Jobs
- List filtered-stream webhook linksGet stream links
- List your activity subscriptionsGet X activity subscriptions
- List your registered webhooksGet webhook
- Look up a compliance job by idGet Compliance Job by ID
- Look up encryption public keys by user idsGet public keys
- Mark a chat conversation as readMark Conversation as Read
- OpenAPI specification of the X APIGet OpenAPI Spec.
- Register a webhookCreate webhook
- Remove a user's Account Activity subscriptionDelete subscription
- Send a typing indicator to a chat conversationSend Typing Indicator
- Stream Likes compliance eventsStream Likes compliance data
- Stream Posts compliance eventsStream Posts compliance data
- Stream Users compliance eventsStream Users compliance data
- Stream a 10% sample of LikesStream sampled Likes
- Stream a 10% sample of tweetsStream 10% sampled Posts
- Stream activity events in real timeActivity Stream
- Stream sampled tweets in real timeStream sampled Posts
- Stream tweet label eventsStream Post labels
- Subscribe a webhook to Account Activity eventsCreate subscription
- Terminate all streaming connectionsTerminate all connections
- Terminate streaming connections by endpoint idTerminate connections by endpoint
- Terminate streaming connections by uuidTerminate multiple connections
- Tweet usage against your plan capGet Usage
- Twitter CommunityFetch a Twitter/X community's public details (name, description, member count, join policy) by URL.
- Twitter Community TweetsList recent tweets posted in a Twitter/X community by URL.
- Twitter TweetFetch a single Twitter/X tweet by URL with its full text and engagement counts (likes, retweets, replies, quotes, bookmarks, views).
- Twitter Tweet TranscriptExtract the spoken transcript from a Twitter/X video tweet by URL.
- Update an activity subscription by subscription idUpdate X activity subscription
- Validate a webhook by webhook idValidate webhook
- X / Twitter ArticleGet a public X long-form article from its wrapper post URL, including its author, engagement, cover image, and structured content blocks.
- X / Twitter Community SearchSearch X (Twitter) communities by keyword and get their id, name, topic, and member count with cursor pagination. This is how you find a community URL to pass to twitter.community or twitter.community_tweets.
- X / Twitter FollowersFetch the follower list of any public X (Twitter) account by username with cursor pagination. Limit is a per-page maximum and a native page holds up to 200 accounts; follow the response's nextCursor for more.
- X / Twitter FollowingList the accounts a public X (Twitter) account follows by username with cursor pagination. Limit is a per-page maximum and a native page holds up to 200 accounts; follow the response's nextCursor for more.
- X / Twitter TrendsGet current X (Twitter) trends for worldwide, a country, or a city in X ranking order, including the resolved location.
- X / Twitter Tweet ThreadResolve the linear self-thread containing an X (Twitter) post, from its root through the author's linked continuations. This excludes replies from other users.
- X / Twitter User SearchSearch X (Twitter) accounts by keyword - the People tab of X search. Matches handles, display names, and profile bios, and returns normalized profile records with follower, following, and post counts plus cursor pagination. Use twitter.search for posts.
These endpoints are callable but not part of the catalog's browse surface.