New Resources: Who has a tweet been retweeted by?

[Marcel Molina]

We've just deployed two new resources for the retweet API:

* /statuses/:status_id/retweeted_by

* /statuses/:status_id/retweeted_by/ids

The first will return up to the first 100 user representations of those who have retweeted the tweet specified in the url by :status_id.

The second will return just the ids of those retweeters for the cases where that's all you care about.

Though up to the first 100 users will be returned by default, these resources both support the :count and :page parameters if you'd like to pull down fewer users. It should be noted though that for operational efficiency you can't use the :count and :page parameters to go *beyond* the first 100 retweeters.

Full docs here:

http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-GET-statuses-id-retweeted_by

http://apiwiki.twitter.com/Twitter-REST-API-Method%3A-GET-statuses-id-retweeted_by-ids

In conjunction with these additions we also want to provide a "retweet_count" parameter in the status payload for convenience. The code for this is mostly done but there are some details around cache invalidation that will likely push out the availability of the retweet_count parameter for a few weeks while we work on an infrastructure change to obviate these cache invalidation issues. But we just wanted to give you a heads up about that too!

P.S. Thanks to everyone for weighing in on the naming of these resources (http://twitter.com/twitterapi/status/10538921196)

--
Marcel Molina
Twitter Platform Team
http://twitter.com/noradio