GET statuses/retweeters/ids

Updated on Tue, 2013-05-07 10:47

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 and replaces API v1's GET statuses/:id/retweeted_by/ids method.

Resource URL

https://api.twitter.com/1.1/statuses/retweeters/ids.json

Parameters

id required

The numerical ID of the desired status.

Example Values: 327473909412814850

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 -1 will be assumed, which is the first "page."

The response from the API will include a previous_cursor and next_cursor to allow paging back and forth. See Using cursors to navigate collections for more information.

While this method supports the cursor parameter, the entire result set can be returned in a single cursored collection. Using the count parameter with this method will not provide segmented cursors for use with this parameter.

Example Values: 12893764510938

stringify_ids optional

Many programming environments will not consume our ids due to their size. Provide this option to have ids returned as strings instead. Read more about Twitter IDs, JSON and Snowflake.

Example Values: true

Example Request

GET	`https://api.twitter.com/1.1/statuses/retweeters/ids.json?id=327473909412814850&count=100&stringify_ids=true`

```
{
```
```
  "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"
```
```
}
```

Resource Information

Rate Limited?	Yes
Requests per rate limit window	15/user 60/app
Authentication	Required
Response Formats	json
HTTP Methods	GET
Resource family	statuses
Response Object	Users
API Version	v1.1

OAuth tool

Please Sign in with your Twitter account in order to use the OAuth tool.