Comparing Twitter API’s Retweets endpoints

These guides will focus on the following areas:

  • API request parameters - The Twitter API v2 endpoint introduces a new set of request parameters. While some parameters will be familiar, especially for those integrating with Labs, there are many important differences such as the introduction of the fields and expansions parameters.
  • App and Project requirements - To access the Twitter API v2, you will need to use credentials from a developer App that is associated with a Project

 

Retweets lookup

The v2 Retweets lookup endpoint will replace the standard v1.1 GET statuses/retweets/:id and v1.1 GET statuses/retweets/:ids endpoints.

The following tables compare the standard v1.1 and Twitter API v2 Retweets endpoints:

Description Standard v1.1 Twitter API v2
HTTP methods supported GET GET
Host domain https://api.twitter.com https://api.twitter.com
Endpoint path

/1.1/retweeters/id.json

/1.1/retweets/ids.json

/2/users/:id/retweeted_by
Authentication OAuth 1.0a User Context

OAuth 2.0 Bearer Token

OAuth 1.0a User Context

Default request rate limits

75 requests per 15 min

75 requests per 15 min (per App)

75 requests per 15 min (per user)


 

Manage Retweets

The following tables compare the standard v1.1 and Twitter API v2 undo Retweet endpoint:

Retweet a Tweet

Description Standard v1.1 Twitter API v2
HTTP methods supported POST POST
Host domain https://api.twitter.com https://api.twitter.com
Endpoint path /1.1/statuses/retweet/:id.json /2/users/:id/retweets
Authentication OAuth 1.0a User Context OAuth 1.0a User Context
Default request rate limits

None

300 requests per 3-hour window (per user, per app). This is shared with the POST endpoint.

50 requests per 15 min (per user)

300 requests per 3-hour window (per user, per app). 

 


Undo a Retweet

The following tables compare the standard v1.1 and Twitter API v2 undo Retweet endpoint:

Description Standard v1.1 Twitter API v2
HTTP methods supported POST DELETE
Host domain https://api.twitter.com https://api.twitter.com
Endpoint path /1.1/statuses/unretweet/:id.json /2/users/:id/retweets/:source_tweet_id
Authentication OAuth 1.0a User Context OAuth 1.0a User Context
Default request rate limits None
50 requests per 15 min (per user)
Was this document helpful?
Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?
Thank you for the feedback. Your comments will help us improve our documents in the future.