Addition of new social event to Streaming API - retweet has been retweeted


#1

In order to support additional social events in Streaming API we will be adding the payload for social event “retweet has been retweeted”. The payload will look like the following JSON and will be gradually rolled out starting on: 01/20/2015. The changes will be present in userstreams and sitestreams only.

The format and notation in this payload is in line with our format for previous social event’s payloads. For example, the event type is “retweeted_retweet”, source is the user performing the retweet of your tweet, target is the creator of the retweet and target_object is the retweet being retweeted.

{
  "event": "retweeted_retweet",
  "created_at": "Fri Jan 16 23:13:32 +0000 2015",
  "source": {
    "id": xxxxxxxxx,
    "id_str": "xxxxxxxxx",
    "name": "xxxxxxxxx",
    "screen_name": "xxxxxxxxx",
    "location": null,
    "profile_location": null,
    "url": null,
    "description": null,
    "protected": true,
    "followers_count": 1,
    "friends_count": 1,
    "listed_count": 0,
    "created_at": "Tue Jan 14 01:35:19 +0000 2014",
    "favourites_count": 4,
    "utc_offset": null,
    "time_zone": null,
    "geo_enabled": false,
    "verified": false,
    "statuses_count": 8,
    "lang": "en",
    "contributors_enabled": false,
    "is_translator": false,
    "is_translation_enabled": false,
    "profile_background_color": "C0DEED",
    "profile_background_image_url": "http:\/\/abs.twimg.com\/images\/themes\/theme1\/bg.png",
    "profile_background_image_url_https": "https:\/\/abs.twimg.com\/images\/themes\/theme1\/bg.png",
    "profile_background_tile": false,
    "profile_image_url": "http:\/\/abs.twimg.com\/sticky\/default_profile_images\/default_profile_1_normal.png",
    "profile_image_url_https": "https:\/\/abs.twimg.com\/sticky\/default_profile_images\/default_profile_1_normal.png",
    "profile_link_color": "0084B4",
    "profile_sidebar_border_color": "C0DEED",
    "profile_sidebar_fill_color": "DDEEF6",
    "profile_text_color": "333333",
    "profile_use_background_image": true,
    "default_profile": true,
    "default_profile_image": true,
    "following": null,
    "follow_request_sent": null,
    "notifications": null
  },
  "target": {
    "id": xxxxxxxxx,
    "id_str": "xxxxxxxxx",
    "name": "xxxxxxxxx",
    "screen_name": "xxxxxxxxx",
    "location": "San Francisco",
    "profile_location": null,
    "url": "http:\/\/favstar.fm\/users\/url",
    "description": "blah",
    "protected": false,
    "followers_count": 277,
    "friends_count": 406,
    "listed_count": 13,
    "created_at": "Tue Mar 17 16:58:32 +0000 2009",
    "favourites_count": 1947,
    "utc_offset": -28800,
    "time_zone": "Pacific Time (US & Canada)",
    "geo_enabled": true,
    "verified": false,
    "statuses_count": 1797,
    "lang": "en",
    "contributors_enabled": false,
    "is_translator": false,
    "is_translation_enabled": false,
    "profile_background_color": "020812",
    "profile_background_image_url": "http:\/\/pbs.twimg.com\/profile_background_images\/633396944\/xee936481711f0d7e86da827b279c9b8.jpg",
    "profile_background_image_url_https": "https:\/\/pbs.twimg.com\/profile_background_images\/633396944\/xee936481711f0d7e86da827b279c9b8.jpg",
    "profile_background_tile": false,
    "profile_image_url": "http:\/\/pbs.twimg.com\/profile_images\/470768477351866368\/28J9i0Io_normal.jpeg",
    "profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/470768477351866368\/28J9i0Io_normal.jpeg",
    "profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/24911559\/1375644715",
    "profile_link_color": "17406C",
    "profile_sidebar_border_color": "FFFFFF",
    "profile_sidebar_fill_color": "020812",
    "profile_text_color": "2280A9",
    "profile_use_background_image": false,
    "default_profile": false,
    "default_profile_image": false,
    "following": null,
    "follow_request_sent": null,
    "notifications": null
  },
  "target_object": {
    "created_at": "Mon Jan 05 21:36:42 +0000 2015",
    "id": 552217146626166784,
    "id_str": "552217146626166784",
    "text": "RT @DrunkkLawyer: Society: Be yourself\nSociety: No, not like that",
    "source": "<a href=\"http:\/\/twitter.com\/download\/iphone\" rel=\"nofollow\">Twitter for iPhone<\/a>",
    "truncated": false,
    "in_reply_to_status_id": null,
    "in_reply_to_status_id_str": null,
    "in_reply_to_user_id": null,
    "in_reply_to_user_id_str": null,
    "in_reply_to_screen_name": null,
    "user": {
      "id": xxxxxxxxx,
      "id_str": "xxxxxxxxx",
      "name": "xxxxxxxxx",
      "screen_name": "xxxxxxxxx",
      "location": "San Francisco",
      "profile_location": null,
      "url": "http:\/\/favstar.fm\/users\/url",
      "description": "xxxxxxxxx",
      "protected": false,
      "followers_count": 277,
      "friends_count": 406,
      "listed_count": 13,
      "created_at": "Tue Mar 17 16:53:32 +0000 2009",
      "favourites_count": 1947,
      "utc_offset": -28800,
      "time_zone": "Pacific Time (US & Canada)",
      "geo_enabled": true,
      "verified": false,
      "statuses_count": 1797,
      "lang": "en",
      "contributors_enabled": false,
      "is_translator": false,
      "is_translation_enabled": false,
      "profile_background_color": "020812",
      "profile_background_image_url": "http:\/\/pbs.twimg.com\/profile_background_images\/633396944\/xee936481711f0d7e86da827b279c9b8.jpg",
      "profile_background_image_url_https": "https:\/\/pbs.twimg.com\/profile_background_images\/633396944\/xee936481711f0d7e86da827b279c9b8.jpg",
      "profile_background_tile": false,
      "profile_image_url": "http:\/\/pbs.twimg.com\/profile_images\/470768477351866368\/28J9i0Io_normal.jpeg",
      "profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/470768477351866368\/28J9i0Io_normal.jpeg",
      "profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/24911559\/1375644715",
      "profile_link_color": "17406C",
      "profile_sidebar_border_color": "FFFFFF",
      "profile_sidebar_fill_color": "020812",
      "profile_text_color": "2280A9",
      "profile_use_background_image": false,
      "default_profile": false,
      "default_profile_image": false,
      "following": null,
      "follow_request_sent": null,
      "notifications": null
    },
    "geo": null,
    "coordinates": null,
    "place": null,
    "contributors": null,
    "retweet_count": 0,
    "favorite_count": 0,
    "entities": {
      "hashtags": [
        
      ],
      "symbols": [
        
      ],
      "user_mentions": [
        {
          "screen_name": "DrunkkLawyer",
          "name": "Your Honor ",
          "id": xxxxxxxxx,
          "id_str": "xxxxxxxxx",
          "indices": [
            3,
            16
          ]
        }
      ],
      "urls": [
        
      ]
    },
    "favorited": false,
    "retweeted": false,
    "lang": "en"
  }
}

#2

Cannot get retweets of retweets , using statuses/filter
#3

By having the social events like “retweeted_retweet” in the payload developers can detect these events in an easier manner. Earlier developers had to make several workarounds to recreate this event from Streaming API, but with this change it will be easier to detect such events.


#4

Hi! Could you include retweets of retweets in a Filter API endpoint? Maybe additional field like “retweet_of_retweet” : true.


#5

#6