Migrate

Comparing X API’s Retweets endpoints

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 X API v2 Retweets endpoints:

Description Standard v1.1 X API v2
HTTP methods supported GET GET
Host domain https://api.x.com https://api.x.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)

Data format Standard v1.1 format

X API v2 format (determined by fields and expansions request parameters, not backward-compatible with v1.1 formats)

To learn more about how to migrate from the Standard v1.1 format to the X API v2 format, please visit our data formats migration guide.

Requires the use of credentials from a developer App that is associated with a Project   ✔️


 

Manage Retweets

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

Retweet a Post

Description Standard v1.1 X API v2
HTTP methods supported POST POST
Host domain https://api.x.com https://api.x.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 Tweet endpoint

50 requests per 15 min (per user)

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

 

Requires the use of credentials from a developer App that is associated with a Project   ✔️


Undo a Retweet

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

Description Standard v1.1 X API v2
HTTP methods supported POST DELETE
Host domain https://api.x.com https://api.x.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)
Requires the use of credentials from a developer App that is associated with a Project   ✔️