X API v2 authentication mapping
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 |
Retrieve multiple Tweets with a list of IDs
Retrieve a single Tweet with an ID
|
✅ |
✅ |
✅
Scopes: tweet.read users.read |
Post a Tweet
Delete a Tweet
|
✅ |
|
✅
Scopes: tweet.read tweet.write users.read
|
User Tweet timeline
User mention timeline
Reverse chronological home timeline GET /2/users/:id/timelines/reverse_cronological
|
✅
✅ |
✅ |
✅
Scopes: tweet.read users.read
✅ Scopes: tweet.read users.read |
Search for Tweets published in the last 7 days
|
✅ |
✅ |
✅
Scopes: tweet.read users.read |
Only available to those with Academic Research access
Search the full archive of Tweets
|
|
✅ |
|
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 |
|
✅ |
|
Streams about 1% of all Tweets in real-time.
|
|
✅ |
|
Retweet a Tweet
Delete a Retweet DELETE /2/users/:id/retweets/:source_tweet_id
|
✅
|
|
✅
Scopes: tweet.read tweet.write users.read |
Users who have Retweeted a Tweet GET /2/tweets/:id/retweeted_by
|
✅ |
✅ |
✅
Scopes: tweet.read users.read |
Bookmarks lookup
Get bookmarked Tweets
|
|
|
✅
Scopes: tweet.read users.read bookmark.read |
Bookmark a Tweet
Remove a Bookmark of a Tweet |
|
|
✅
Scopes: tweet.read users.read bookmark.write |
Like a Tweet
Undo a Like of a Tweet DELETE /2/users/:id/likes/:tweet_id
|
✅ |
|
✅
Scopes: tweet.read users.read like.write |
Users who have liked a Tweet GET /2/tweets/:id/liking_users
Tweets liked by a user
|
✅ |
✅ |
✅
Scopes: tweet.read users.read like.read |
Hides or unhides a reply to a Tweet.
|
✅ |
|
✅
Scopes: tweet.read users.read tweet.moderate.write |
Retrieve multiple users with IDs
Retrieve a single user with an ID
Retrieve multiple users with usernames
Retrieve a single user with a usernames GET /2/users/by/username/:username
Get information about an authenticated user |
✅ |
✅ |
✅
Scopes: tweet.read users.read |
Allows a user ID to follow another user
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 |
Lookup following of a user by ID
Lookup followers of a user by ID
|
✅ |
✅ |
✅
Scopes: tweet.read users.read follows.read |
Allows a user ID to block another user
Allows a user ID to unblock another user DELETE /2/users/:source_user_id/blocking/:target_user_id
|
✅ |
|
✅
Scopes: tweet.read users.read block.write |
Returns a list of users who are blocked by the specified user ID |
✅ |
|
✅
Scopes: tweet.read users.read block.read |
Allows a user ID to mute another user
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 |
Returns a list of users who are muted by the specified user ID |
✅ |
|
✅
Scopes: tweet.read users.read mute.read |
Lookup Space by ID
Lookup multiple Spaces
Discover Spaces created by user ID
|
|
✅ |
✅
Scopes: tweet.read users.read space.read |
Get users who purchased a ticket to a Space |
|
|
✅
Scopes: tweet.read users.read space.read |
Returns live or scheduled Spaces matching your specified search terms.
|
|
✅ |
✅
Scopes: tweet.read users.read space.read |
Lookup a specific list by ID
Lookup a user's owned List
|
✅ |
✅ |
✅
Scopes: tweet.read users.read list.read |
Creates a new List on behalf of an authenticated user |
✅ |
|
✅
Scopes: tweet.read users.read list.read list.write |
Deletes a List the authenticated user owns
Updates the metadata for a List the authenticated user owns |
✅ |
|
✅
Scopes: tweet.read users.read list.write |
Lookup Tweets from a specified List |
✅ |
✅ |
✅
Scopes: tweet.read users.read list.read |
Returns a list of members from a specified List
Returns all Lists a specified user is a member of GET /2/users/:id/list_memberships
|
✅ |
✅ |
✅
Scopes: tweet.read users.read list.read |
Add a member to a List that the authenticated user owns
Removes a member from a List the authenticated user owns DELETE /2/lists/:id/members/:user_id
|
✅ |
|
✅
Scopes: tweet.read users.read list.write |
Returns all followers of a specified List
Returns all Lists a specified user follows |
✅ |
✅ |
✅
Scopes: tweet.read users.read list.read |
Follows a List on behalf of an authenticated user POST /2/users/:id/followed_lists
Unfollows a List on behalf of an authenticated user |
✅ |
|
✅
Scopes: tweet.read users.read list.write
|
Returns the pinned Lists of the authenticated user |
✅
|
|
✅
Scopes: tweet.read users.read list.read |
Pins a List on behalf of an authenticated user POST /2/users/:id/pinned_lists
Unpins a List on behalf of an authenticated user |
✅ |
|
✅
Scopes: tweet.read users.read list.write |
Creates a new compliance job
Returns status and download information about a specified compliance job GET /2/compliance/jobs/:job_id
Returns a list of recent compliance jobs |
|
✅ |
|