Retweets contains the Twitter API v2 versions of the following standard v1.1 endpoints:

To see what's new with v2, please visit our comparison guide.

Learn more about the new Twitter API v2.

Introduction

Retweeting is one of the core features people use to engage in the public conversation on Twitter. With the Retweets lookup endpoints, you can see a list of accounts that Retweeted a given Tweet. In addition, the new manage Retweets endpoints allow you to Retweet a Tweet or undo a Retweet.

 

Retweets lookup

With the Retweets lookup endpoint, you can retrieve a list of accounts that have Retweeted a Tweet. 

You can authenticate these endpoints with either OAuth 1.0a User Context or OAuth 2.0 Bearer Token. When authenticating, you must use keys and tokens from a developer App located within a Project. You will receive the most recent 100 users who Retweeted the specified Tweet. There is no pagination available for this endpoint. 

 

Manage Retweets

The manage Retweets endpoints enable you to Retweet or undo a Retweet of a specified Tweet on behalf of an authenticated account. For this endpoint group, there are two methods available POST and DELETE. The POST method allows you to Retweet a Tweet, and the DELETE method will enable you to undo a Retweet of a given Tweet.

Since you are making requests on behalf of a user, you must authenticate these endpoints with OAuth 1.0a User Context and use the Access Tokens associated with the user, which can be generated using the 3-legged OAuth flow. You can Retweet a Tweet from your account or an account of an authenticated user. With both endpoints, there is a user rate limit of 50 requests per 15 minutes per endpoint.
 

Learn more about getting access to the Twitter API v2 endpoints in our getting started page