Overview
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 | ✔️ |
Other migration resources
Retweets lookup: Standard v1.1 to X API v2