Please note
We recently released manage Retweets, which includes a Twitter API v2 endpoint that has the same functionality as this one. The new version is currently in development and serves adequate access for the majority of developers on our platform. While elevated levels of access are coming to v2 soon, developers in need of higher levels of access should continue to use this endpoint and should apply for elevated access if you are getting close to hitting the rate limit.
POST statuses/retweet/:id
Retweets a tweet. Returns the original Tweet with Retweet details embedded.
Usage Notes:
- This method is subject to update limits. A HTTP 403 will be returned if this limit as been hit.
- Twitter will ignore attempts to perform duplicate retweets.
- The retweet_count will be current as of when the payload is generated and may not reflect the exact count. It is intended as an approximation.
Resource URL¶
https://api.twitter.com/1.1/statuses/retweet/:id.json
Resource Information¶
Response formats | JSON |
Requires authentication? | Yes (user context only) |
Rate limited? | Yes |
Requests / 3-hour window | 300* per user; 300* per app |
Please note - The 300 per 3 hours is a combined limit with the POST statuses/update endpoint. You can only post 300 Tweets or Retweets during a 3 hour period.
Parameters¶
Name | Required | Description | Default Value | Example |
id | required | The numerical ID of the desired status. | 123 | |
trim_user | optional | When set to either true , t or 1 , each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object. | true |
Example Request¶
$ curl --request POST
--url 'https://api.twitter.com/1.1/statuses/retweet/TWEET_ID.json'
--header 'authorization: OAuth oauth_consumer_key="YOUR_CONSUMER_KEY", oauth_nonce="AUTO_GENERATED_NONCE", oauth_signature="AUTO_GENERATED_SIGNATURE", oauth_signature_method="HMAC-SHA1", oauth_timestamp="AUTO_GENERATED_TIMESTAMP", oauth_token="USERS_ACCESS_TOKEN", oauth_version="1.0"'
--header 'content-type: application/json'
Example Response¶
{retweet-status-object,
"user": {retweeting-user-object},
"retweeted_status": {retweeted-status-object,
"user": {retweeted-user-object}
}
}