Documentation Index
Fetch the complete documentation index at: https://docs.x.com/llms.txt
Use this file to discover all available pages before exploring further.
title: X API v2 authentication mapping sidebarTitle: Endpoint mapping keywords: [“authentication mapping”, “v2 authentication”, “endpoint mapping”, “auth mapping”, “v1 to v2 mapping”, “authentication guide”] description: The following chart illustrates which v2 endpoints map to what authentication methods. | | | | | | :--- | :--- | :--- | :--- | | Endpoint | **OAuth 1.--- The following chart illustrates which v2 endpoints map to what authentication methods.
| Endpoint | OAuth 1.0a User Context | OAuth 2.0 App Only | OAuth 2.0 Authorization Code with PKCE |
| Tweet lookup Retrieve multiple Tweets with a list of IDs GET /2/tweets Retrieve a single Tweet with an ID GET /2/tweets/:id | ✅ | ✅ | ✅ Scopes: tweet.read users.read |
| Manage Tweets Post a Tweet POST /2/tweets Delete a Tweet DELETE /2/tweets/:id | ✅ | ✅ Scopes: tweet.read tweet.write users.read | |
| Timelines User Tweet timeline GET /2/users/:id/tweets User mention timeline GET /2/users/:id/mentions Reverse chronological home timeline GET /2/users/:id/timelines/reverse_cronological | ✅ ✅ | ✅ | ✅ Scopes: tweet.read users.read ✅ Scopes: tweet.read users.read |
| Recent search Search for Tweets published in the last 7 days GET /2/tweets/search/recent | ✅ | ✅ | ✅ Scopes: tweet.read users.read |
| Full-archive search Only available to those with Academic Research access Search the full archive of Tweets GET /2/tweets/search/all | ✅ | ||
| Filtered stream Add or delete rules from your stream POST /2/tweets/search/stream/rules Retrieve your stream’s rules GET /2/tweets/search/stream/rules Connect to the stream GET /2/tweets/search/stream | ✅ | ||
| Volume streams Streams about 1% of all Tweets in real-time. GET /2/tweets/sample/stream | ✅ | ||
| Manage Retweets Retweet a Tweet POST /2/users/:id/retweets Delete a Retweet DELETE /2/users/:id/retweets/:source_tweet_id | ✅ | ✅ Scopes: tweet.read tweet.write users.read | |
| Retweets lookup Users who have Retweeted a Tweet GET /2/tweets/:id/retweeted_by | ✅ | ✅ | ✅ Scopes: tweet.read users.read |
| Bookmarks lookup Get bookmarked Tweets GET /2/tweets/:id/bookmarks | ✅ Scopes: tweet.read users.read bookmark.read | ||
| Manage Bookmarks Bookmark a Tweet POST /2/tweets/:id/bookmarks Remove a Bookmark of a Tweet DELETE /2/users/:id/bookmarks:tweet_id | ✅ Scopes: tweet.read users.read bookmark.write | ||
| Manage Likes Like a Tweet POST /2/users/:id/likes Undo a Like of a Tweet DELETE /2/users/:id/likes/:tweet_id | ✅ | ✅ Scopes: tweet.read users.read like.write | |
| Likes lookup Users who have liked a Tweet GET /2/tweets/:id/liking_users Tweets liked by a user GET /2/users/:id/liked_tweets | ✅ | ✅ | ✅ Scopes: tweet.read users.read like.read |
| Hide replies Hides or unhides a reply to a Tweet. PUT /2/tweets/:id/hidden | ✅ | ✅ Scopes: tweet.read users.read tweet.moderate.write | |
| Users lookup Retrieve multiple users with IDs GET /2/users Retrieve a single user with an ID GET /2/users/:id Retrieve multiple users with usernames GET /2/users/by Retrieve a single user with a usernames GET /2/users/by/username/:username Get information about an authenticated user GET /2/users/me | ✅ | ✅ | ✅ Scopes: tweet.read users.read |
| Manage follows Allows a user ID to follow another user POST /2/users/:id/following Allows a user ID to unfollow another user DELETE /2/users/:source_user_id/following/:target_user_id | ✅ | ✅ Scopes: tweet.read users.read follows.write | |
| Follows lookup Lookup following of a user by ID GET /2/users/:id/following Lookup followers of a user by ID GET /2/users/:id/followers | ✅ | ✅ | ✅ Scopes: tweet.read users.read follows.read |
| Blocks lookup Returns a list of users who are blocked by the specified user ID GET /2/users/:id/blocking | ✅ | ✅ Scopes: tweet.read users.read block.read | |
| Manage Mutes Allows a user ID to mute another user POST /2/users/:id/muting Allows a user ID to unmute another user DELETE /2/users/:source_user_id/muting/:target_user_id | ✅ | ✅ Scopes: tweet.read users.read mute.write | |
| Mutes lookup Returns a list of users who are muted by the specified user ID GET /2/users/:id/muting | ✅ | ✅ Scopes: tweet.read users.read mute.read | |
| Spaces lookup Lookup Space by ID GET /2/spaces/:id Lookup multiple Spaces GET /2/spaces Discover Spaces created by user ID GET /2/spaces/by/creator_ids | ✅ | ✅ Scopes: tweet.read users.read space.read | |
| Spaces lookup Get users who purchased a ticket to a Space GET /2/spaces/:id/buyers | ✅ Scopes: tweet.read users.read space.read | ||
| Spaces search Returns live or scheduled Spaces matching your specified search terms. GET /2/spaces/search | ✅ | ✅ Scopes: tweet.read users.read space.read | |
| List lookup Lookup a specific list by ID GET /2/lists/:id Lookup a user’s owned List GET /2/users/:id/owned_lists | ✅ | ✅ | ✅ Scopes: tweet.read users.read list.read |
| Manage Lists Creates a new List on behalf of an authenticated user POST /2/lists | ✅ | ✅ Scopes: tweet.read users.read list.read list.write | |
| Manage Lists Deletes a List the authenticated user owns DELETE /2/lists/:id Updates the metadata for a List the authenticated user owns PUT /2/lists/:id | ✅ | ✅ Scopes: tweet.read users.read list.write | |
| List Tweets lookup Lookup Tweets from a specified List GET /2/lists/:id/tweets | ✅ | ✅ | ✅ Scopes: tweet.read users.read list.read |
| List members lookup Returns a list of members from a specified List GET /2/lists/:id/members Returns all Lists a specified user is a member of GET /2/users/:id/list_memberships | ✅ | ✅ | ✅ Scopes: tweet.read users.read list.read |
| Manage List members Add a member to a List that the authenticated user owns POST /2/lists/:id/members Removes a member from a List the authenticated user owns DELETE /2/lists/:id/members/:user_id | ✅ | ✅ Scopes: tweet.read users.read list.write | |
| List follows lookup Returns all followers of a specified List GET /2/lists/:id/followers Returns all Lists a specified user follows GET /2/users/:id/followed_lists | ✅ | ✅ | ✅ Scope |