Logo
test-backup API Documentation

Twitter API v2

Number of APIs: 62


This is a Qodex Collection for the Twitter API v2 endpoints.

Refer to the main Twitter API documentation for more details.

If you have an API-related question, you can also discuss in the developer community forum.

Installation

Quick install

Go to the Collection and click Run in Qodex.

Manual install

You can also download this Collection from a GitHub repo here: https://github.com/twitterdev/Qodex-twitter-api

Environment

This Collection includes a pre-configured Environment. You will need to set up the following variables in order to run each request (depending on the authentication type used by the request you are sending):

Name Description
consumer_key Your consumer key
consumer_secret Your consumer secret
access_token Your access token
token_secret Your access token secret
bearer_token Your bearer token


1. Tweet Lookup - Single Tweet Usercontext

GET https://api.twitter.com/2/tweets/:id

This endpoint returns details about the Tweet specified by the requested ID.

For full details, see the API reference for this endpoint.


2. Tweet Lookup - Multiple Tweets

GET https://api.twitter.com/2/tweets?ids=

This endpoint returns details about up to 100 Tweets specified by the requested IDs.

For full details, see the API reference for this endpoint.


3. User Lookup - User by ID

GET https://api.twitter.com/2/users/:id

This endpoint returns details about a user by ID.

For full details, see the API reference for this endpoint.


4. User Lookup - Users by ID

GET https://api.twitter.com/2/users?ids=

This endpoint returns details about up to 100 users by ID.

For full details, see the API reference for this endpoint.


5. User Lookup - User by Username

GET https://api.twitter.com/2/users/by/username/:username

This endpoint returns details about a user by username.

For full details, see the API reference for this endpoint.


6. User Lookup - Users by Username

GET https://api.twitter.com/2/users/by?usernames=

This endpoint returns details about up to 100 users specified by username.

For full details, see the API reference for this endpoint.


7. User Lookup - Authenticated User Lookup

GET https://api.twitter.com/2/me

This endpoint returns the information about an authorized user.

For full details, see the API reference for this endpoint.


8. Follows - Followers of user ID

GET https://api.twitter.com/2/users/:id/followers

Returns a list of users who are followers of the specified user ID.

For full details, see the API reference for this endpoint.


9. Follows - Users a user ID is following

GET https://api.twitter.com/2/users/:id/following

Returns a list of users the specified user ID is following.

For full details, see the API reference for this endpoint.


10. Follows - Follow a user ID

POST https://api.twitter.com/2/users/:id/following

Allows a user ID to follow another user.

For full details, see the API reference for this endpoint.


11. Follows - Unfollow a user ID

DELETE https://api.twitter.com/2/users/:source_user_id/following/:target_user_id

Allows a user ID to unfollow another user.

For full details, see the API reference for this endpoint.


12. Blocks - Block a user ID

POST https://api.twitter.com/2/users/:id/blocking

Allows a user ID to block another user.

For full details, see the API reference for this endpoint.


13. Blocks - Blocks lookup

GET https://api.twitter.com/2/users/:id/blocking

Returns a list of users who are blocked by the specified user ID.

For full details, see the API reference for this endpoint.


14. Blocks - Unblock a user ID

DELETE https://api.twitter.com/2/users/:source_user_id/blocking/:target_user_id

Allows a user ID to unblock another user.

For full details, see the API reference for this endpoint.


15. List-List lookup - List by ID

GET https://api.twitter.com/2/lists/:id

This endpoint returns details about the List specified by the requested ID

For full details, see the API reference for this endpoint.


16. List-List lookup - User owned Lists

GET https://api.twitter.com/2/users/:id/owned_lists

This endpoint returns details on user owned Lists specified by the requested ID

For full details, see the API reference for this endpoint.


17. List-Manage Lists - Create a list

POST https://api.twitter.com/2/lists

Allows the authenticated user to create a new List.

For full details, see the API reference for this endpoint.


18. List-Manage Lists - Delete a list

DELETE https://api.twitter.com/2/lists/:id

Allows the authenticated user to delete a list they own.

For full details, see the API reference for this endpoint.


19. List-Manage Lists - Update a list

PUT https://api.twitter.com/2/lists/:id

Allows the authenticated user to update a List they own.

For full details, see the API reference for this endpoint.


20. List-List Tweets - List Tweets lookup

GET https://api.twitter.com/2/lists/:id/tweets

This endpoint returns all Tweets from a List specified by the requested ID

For full details, see the API reference for this endpoint.


21. List-List members - Add a member

POST https://api.twitter.com/2/lists/:id/members

Allows the authenticated user to add a member to a List they own.

For full details, see the API reference for this endpoint.


22. List-List members - Remove a member

DELETE https://api.twitter.com/2/lists/:id/members/:user_id

Allows the authenticated user to remove a member from a List they own.

For full details, see the API reference for this endpoint.


23. List-List members - Members lookup

GET https://api.twitter.com/2/lists/:id/members

This endpoint returns member details from the List specified by the requested ID

For full details, see the API reference for this endpoint.


24. List-List members - User memberships

GET https://api.twitter.com/2/users/:id/list_memberships

This endpoint returns details on Lists a user is a member of specified by the requested ID

For full details, see the API reference for this endpoint.


25. List-List follows - Follow a list

POST https://api.twitter.com/2/users/:id/followed_lists

Allows the authenticated user to follow a specified List.

For full details, see the API reference for this endpoint.


26. List-List follows - Unfollow a list

DELETE https://api.twitter.com/2/users/:id/followed_lists/:list_id

Allows the authenticated user to unfollow a specified List.

For full details, see the API reference for this endpoint.


27. List-List follows - Follower lookup

GET https://api.twitter.com/2/lists/:id/followers

This endpoint returns follower details from the List specified by the requested ID

For full details, see the API reference for this endpoint.


28. List-List follows - User's followed Lists

GET https://api.twitter.com/2/users/:id/followed_lists

This endpoint returns details on Lists a user follows specified by the requested ID

For full details, see the API reference for this endpoint.


29. List-Pinned Lists - Pin a list

POST https://api.twitter.com/2/users/:id/pinned_lists

Allows the authenticated user to pin a specified List.

For full details, see the API reference for this endpoint.


30. List-Pinned Lists - Unpin a list

DELETE https://api.twitter.com/2/lists/:id/pinned_lists/:list_id

Allows the authenticated user to unpin a specified List.

For full details, see the API reference for this endpoint.


31. List-Pinned Lists - User's pinned Lists

GET https://api.twitter.com/2/users/:id/pinned_lists

This endpoint returns details on a user's pinned Lists specified by the requested ID

For full details, see the API reference for this endpoint.


32. Manage Tweets - Create a Tweet

POST https://api.twitter.com/2/tweets

Allows an authenticated user to create a Tweet.

You can add parameters to post polls, quote Tweets, Tweet with reply settings, and Tweet to Super Followers in addition to other features.

For full details, see the API reference for this endpoint.


33. Manage Tweets - Delete a Tweet

DELETE https://api.twitter.com/2/tweets/:id

Allows an authenticated user to delete a Tweet.

For full details, see the API reference for this endpoint.


34. Mutes - Mute a user ID

POST https://api.twitter.com/2/users/:id/muting

Allows a user ID to mute another user.

For full details, see the API reference for this endpoint.


35. Mutes - Unmute a user ID

DELETE https://api.twitter.com/2/users/:source_user_id/muting/:target_user_id

Allows a user ID to unmute another user.

For full details, see the API reference for this endpoint.


36. Mutes - Mutes lookup

GET https://api.twitter.com/2/users/:id/muting

Returns a list of users who are muted by the specified user ID.

For full details, see the API reference for this endpoint.


37. Timelines - User Tweet timeline by ID

GET https://api.twitter.com/2/users/:id/tweets

Returns the most recent Tweets composed by a single user specified by the requested user ID.

For full details, see the API reference for this endpoint.


38. Timelines - User mention timeline by ID

GET https://api.twitter.com/2/users/:id/mentions

Returns the most recent Tweets mentioning a single user specified by the requested user ID.

For full details, see the API reference for this endpoint.


39. Hide Replies - Unhide a reply

PUT https://api.twitter.com/2/tweets/:id/hidden

Provides the ability to unhide a reply to a Tweet.

For full details, see the API reference for this endpoint.


40. Search Tweets - Recent search

GET https://api.twitter.com/2/tweets/search/recent?query=

Search for public Tweets created in the last 7 days.

For full details, see the API reference for this endpoint.


41. Search Tweets - Full-archive search

GET https://api.twitter.com/2/tweets/search/all?query=

Search across the complete history of public Tweets matching a search query; since the first Tweet was created in March 2006.

For full details, see the API reference for this endpoint.

NOTE this endpoint requires access via the Academic Research product track


42. Tweet Counts - Recent Tweet counts

GET https://api.twitter.com/2/tweets/counts/recent?query=

Search for public Tweets created in the last 7 days.

For full details, see the API reference for this endpoint.


43. Tweet Counts - Full-archive Tweet counts

GET https://api.twitter.com/2/tweets/counts/all?query=

Search across the complete history of public Tweets matching a search query; since the first Tweet was created in March 2006.

For full details, see the API reference for this endpoint.

NOTE this endpoint requires access via the Academic Research product track


44. Filtered Stream - Delete Rules (by rule value)

POST https://api.twitter.com/2/tweets/search/stream/rules

Delete filter rules. To delete one or more rules, submit a delete object payload with an array of rule values to delete.


45. Filtered Stream - Retrieve Rules

GET https://api.twitter.com/2/tweets/search/stream/rules

Returns a list of filter rules currently active on the streaming endpoint.


46. Filtered Stream - Stream (see description)

GET https://api.twitter.com/2/tweets/search/stream

Streams Tweets in real-time based on a specific set of filter rules.

Please note streaming responses are currently not supported in Qodex. Use this to help form your request, then click on Code > cURL. Copy the cURL command and paste in terminal to view the response.


47. Sampled Stream - Stream (see description)

GET https://api.twitter.com/2/tweets/sample/stream

Stream, in real-time, roughly a 1% sample of all public Tweets.

Please note streaming responses are currently not supported in Qodex. Use this to help form your request, then click on Code > cURL. Copy the cURL command and paste in terminal to view the response.


48. Spaces-Spaces lookup - Spaces lookup by single ID

GET https://api.twitter.com/2/spaces/:id?space.fields=&expansions=&user.fields=&topic.fields

This endpoint returns information about a single Space with the specified ID.


49. Spaces-Spaces lookup - Spaces lookup by list of IDs

GET https://api.twitter.com/2/spaces?ids=&space.fields=&expansions=&user.fields=&topic.fields

This endpoint returns information about one or more Spaces with the specified comma-separated list of IDs. You can request up to 100 Spaces in a single request


50. Spaces-Spaces lookup - Lookup Spaces created by one or more users

GET https://api.twitter.com/2/spaces/by/creator_id?user_ids=&space.fields=&expansions=&user.fields=&topic.fields

This endpoint returns information about a user. Specify user by username.


51. Spaces-Spaces lookup - Users who bought a ticket to a Space

GET https://api.twitter.com/2/spaces/:id/buyers

Returns a list of users who are blocked by the specified user ID.

For full details, see the API reference for this endpoint.


52. Spaces-Search Spaces - Search Spaces by title

GET https://api.twitter.com/2/spaces/search?query=&state=&space.fields=&expansions=&user.fields&topic.fields

This endpoint returns Spaces matching the specified keyword query.


53. Batch Compliance - Create a batch compliance job

POST https://api.twitter.com/2/compliance/jobs


54. Batch Compliance - Get all batch compliance jobs

GET https://api.twitter.com/2/compliance/jobs?type=tweets


55. Batch Compliance - Get a compliance job by ID

GET https://api.twitter.com/2/compliance/jobs/:id


56. Likes - Like a Tweet

POST https://api.twitter.com/2/users/:id/likes

Allows an authenticated user to like a Tweet.

For full details, see the API reference for this endpoint.


57. Likes - Liked Tweets

GET https://api.twitter.com/2/users/:id/liked_tweets

Returns a list of Tweets that have been liked by a specified user ID.

For full details, see the API reference for this endpoint.


58. Likes - Liking users

GET https://api.twitter.com/2/tweets/:id/liking_users

Returns a list of users who have liked a specified Tweet ID.

For full details, see the API reference for this endpoint.


59. Likes - Unlike a Tweet

DELETE https://api.twitter.com/2/users/:id/likes/:tweet_id

Allows an authenticated user to unlike a Tweet.

For full details, see the API reference for this endpoint.


60. Retweets - Retweet a Tweet

POST https://api.twitter.com/2/users/:id/retweets

Allows an authenticated user to Retweet a Tweet.

For full details, see the API reference for this endpoint.


61. Retweets - Retweeted by

GET https://api.twitter.com/2/tweets/:id/retweeted_by

Returns a list of users who have liked a specified Tweet ID.

For full details, see the API reference for this endpoint.


62. Retweets - Undo a Retweet

DELETE https://api.twitter.com/2/users/:id/retweets/:source_tweet_id

Allows an authenticated user to unlike a Tweet.

For full details, see the API reference for this endpoint.


  • FAQs

  • More

    Github

    Twitter

    Developer Website

    Claim this page

    Report this page

ENDPOINTS