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.

Account setup

To access these endpoints, you will need:

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

 

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 ContextOAuth 2.0 App-Only, or OAuth 2.0 Authorization Code with PKCE. 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 either OAuth 1.0a User Context or OAuth 2.0 Authorization Code with PKCE, and utilize the user Access Tokens associated with the user you are making the request on behalf of. You can generate this user Access Token using the 3-legged OAuth flow (OAuth 1.0a) or using the Authorization Code with PKCE grant flow (OAuth 2.0). 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.