Please note
We recently released Retweet lookup, a Twitter API v2 endpoint that has similar functionality to 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 along with the Twitter API v2 version.
GET statuses/retweeters/ids
Returns a collection of up to 100 user IDs belonging to users who have retweeted the Tweet specified by the id
parameter.
This method offers similar data to GET statuses / retweets / :id.
Resource URL¶
https://api.twitter.com/1.1/statuses/retweeters/ids.json
Resource Information¶
Response formats | JSON |
Requires authentication? | Yes |
Rate limited? | Yes |
Requests / 15-min window (user auth) | 75 |
Requests / 15-min window (app auth) | 300 |
Parameters¶
Name | Required | Description | Default Value | Example |
---|---|---|---|---|
id | required | The numerical ID of the desired status. | 327473909412814850 |
|
count | optional | Specifies the number of records to retrieve. Must be less than or equal to 100. | 5 |
|
cursor | semi-optional | Causes the list of IDs to be broken into pages of no more than 100 IDs at a time. The number of IDs returned is not guaranteed to be 100 as suspended users are filtered out after connections are queried. If no cursor is provided, a value of The response from the API will include a While this method supports the cursor parameter, the entire result set can be returned in a single cursored collection. Using the |
12893764510938 |
|
stringify_ids | optional | Many programming environments will not consume Tweet ids due to their size. Provide this option to have ids returned as strings instead. | true |
Example Request¶
GET https://api.twitter.com/1.1/statuses/retweeters/ids.json?id=327473909412814850&count=100&stringify_ids=true
Example Response¶
{ "previous_cursor": 0, "ids": [ "1382021622", "931150754", "1364953914", "92313481",
"1398853771", "268642828", "1393765387", "417614795", "1401282895", "1319566290",
"1398546265", "1332481988", "295679474", "967380524", "1278983791", "711759314",
"1396957736", "1400099804", "1400006540", "307434897", "531100534", "553765661",
"1398911250", "342624342", "629452817", "117815404", "137706363", "200935461",
"387409391", "1361168810", "1368343309", "613471026", "439924515", "36049728",
"1274405064", "1389815384", "1392424261", "577940232", "876175585", "510085789",
"410346647", "1393727204", "1394189851", "1387201657", "1393950540", "900169760",
"69572684", "517788963", "386168676", "1378242152", "18442587", "848640758",
"1366022899", "25457359", "257764557", "795253765", "1170975386", "1229598968",
"204528531", "954414061", "533154335", "580732530", "350798999", "427506664",
"527674954", "1389957769", "496054455", "1338136910", "1390051482", "1252565820",
"815941296", "1357349460", "1214535374", "1192879201", "1353712213", "229798008",
"1382909124", "1026779562", "917199121", "1388715336", "1388417048", "106315621",
"109159559", "523186040", "1256627971", "1137979866", "424946721", "1387875991" ],
"previous_cursor_str": "0", "next_cursor": 0, "next_cursor_str": "0" }