Quote Tweet Events in the Streaming API

quoted
quote
userstream

#1

Over the next few weeks, UserStreams and SiteStreams of the Streaming APIs will start to include new event messages when a Tweet is quoted. The new messages will be similar to the events HERE.

A quoted Tweet event will come through UserStream with the following objects

“created_at”: timestamp of the quote Tweet event,
“event”: “quoted_tweet”,
“source”: user who created the quote Tweet,
“target”: user of the original Tweet that was quoted,
“target_object”: The newly created quote Tweet containing the original tweet nested


An example quote Tweet event is shown below
{
    "created_at": "Thu May 21 20:07:22 +0000 2015",
    "event": "quoted_tweet",
    "source": {
        "id": 3001969357,
        "id_str": "3001969357",
        "name": "Jordan Brinks",
        "screen_name": "ilyanshe",
        "location": "Madagascar",
        "url": "http://spacejam.com",
        "description": "Alter Ego",
        "protected": false,
        "verified": false,
        "followers_count": 8,
        "friends_count": 37,
        "listed_count": 0,
        "favourites_count": 1,
        "statuses_count": 122,
        "created_at": "Thu Jan 29 18:27:49 +0000 2015",
        "utc_offset": 3600,
        "time_zone": "West Central Africa",
        "geo_enabled": true,
        "lang": "en",
        "contributors_enabled": false,
        "is_translator": 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_link_color": "0084B4",
        "profile_sidebar_border_color": "C0DEED",
        "profile_sidebar_fill_color": "DDEEF6",
        "profile_text_color": "333333",
        "profile_use_background_image": true,
        "profile_image_url": "http://pbs.twimg.com/profile_images/601155672395227136/qakfE9EU_normal.jpg",
        "profile_image_url_https": "https://pbs.twimg.com/profile_images/601155672395227136/qakfE9EU_normal.jpg",
        "profile_banner_url": "https://pbs.twimg.com/profile_banners/3001969357/1432161817",
        "default_profile": true,
        "default_profile_image": false,
        "following": null,
        "follow_request_sent": null,
        "notifications": null
    },
    "target": {
        "id": 6253282,
        "id_str": "6253282",
        "name": "Twitter API",
        "screen_name": "twitterapi",
        "location": "San Francisco, CA",
        "url": "http://dev.twitter.com",
        "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.",
        "protected": false,
        "verified": true,
        "followers_count": 3331390,
        "friends_count": 48,
        "listed_count": 12956,
        "favourites_count": 27,
        "statuses_count": 3534,
        "created_at": "Wed May 23 06:01:13 +0000 2007",
        "utc_offset": -25200,
        "time_zone": "Pacific Time (US & Canada)",
        "geo_enabled": true,
        "lang": "en",
        "contributors_enabled": false,
        "is_translator": false,
        "profile_background_color": "C0DEED",
        "profile_background_image_url": "http://pbs.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
        "profile_background_image_url_https": "https://pbs.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
        "profile_background_tile": true,
        "profile_link_color": "0084B4",
        "profile_sidebar_border_color": "C0DEED",
        "profile_sidebar_fill_color": "DDEEF6",
        "profile_text_color": "333333",
        "profile_use_background_image": true,
        "profile_image_url": "http://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
        "profile_image_url_https": "https://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
        "profile_banner_url": "https://pbs.twimg.com/profile_banners/6253282/1431474710",
        "default_profile": false,
        "default_profile_image": false,
        "following": null,
        "follow_request_sent": null,
        "notifications": null
    },
    "target_object": {
        "created_at": "Thu May 21 20:03:48 +0000 2015",
        "id": 601478517394636800,
        "id_str": "601478517394636801",
        "text": "Awesome news! https://t.co/plSZZhcvkP",
        "source": "<a href=\"http://twitter.com\" rel=\"nofollow\">Twitter Web Client</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": 3001969357,
            "id_str": "3001969357",
            "name": "Jordan Brinks",
            "screen_name": "ilyanshe",
            "location": "Madagascar",
            "url": "http://spacejam.com",
            "description": "Alter Ego",
            "protected": false,
            "verified": false,
            "followers_count": 8,
            "friends_count": 37,
            "listed_count": 0,
            "favourites_count": 1,
            "statuses_count": 118,
            "created_at": "Thu Jan 29 18:27:49 +0000 2015",
            "utc_offset": 3600,
            "time_zone": "West Central Africa",
            "geo_enabled": true,
            "lang": "en",
            "contributors_enabled": false,
            "is_translator": 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_link_color": "0084B4",
            "profile_sidebar_border_color": "C0DEED",
            "profile_sidebar_fill_color": "DDEEF6",
            "profile_text_color": "333333",
            "profile_use_background_image": true,
            "profile_image_url": "http://pbs.twimg.com/profile_images/601155672395227136/qakfE9EU_normal.jpg",
            "profile_image_url_https": "https://pbs.twimg.com/profile_images/601155672395227136/qakfE9EU_normal.jpg",
            "profile_banner_url": "https://pbs.twimg.com/profile_banners/3001969357/1432161817",
            "default_profile": true,
            "default_profile_image": false,
            "following": null,
            "follow_request_sent": null,
            "notifications": null
        },
        "geo": null,
        "coordinates": null,
        "place": null,
        "contributors": null,
        "quoted_status_id": 560101531794821100,
        "quoted_status_id_str": "560101531794821120",
        "quoted_status": {
            "created_at": "Tue Jan 27 15:46:26 +0000 2015",
            "id": 560101531794821100,
            "id_str": "560101531794821120",
            "text": "Native video support in REST and Streaming API https://t.co/VrFm1qGZnF",
            "source": "<a href=\"http://itunes.apple.com/us/app/twitter/id409789998?mt=12\" rel=\"nofollow\">Twitter for Mac</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": 6253282,
                "id_str": "6253282",
                "name": "Twitter API",
                "screen_name": "twitterapi",
                "location": "San Francisco, CA",
                "url": "http://dev.twitter.com",
                "description": "The Real Twitter API. I tweet about API changes, service issues and happily answer questions about Twitter and our API. Don't get an answer? It's on my website.",
                "protected": false,
                "verified": true,
                "followers_count": 3331390,
                "friends_count": 48,
                "listed_count": 12956,
                "favourites_count": 27,
                "statuses_count": 3534,
                "created_at": "Wed May 23 06:01:13 +0000 2007",
                "utc_offset": -25200,
                "time_zone": "Pacific Time (US & Canada)",
                "geo_enabled": true,
                "lang": "en",
                "contributors_enabled": false,
                "is_translator": false,
                "profile_background_color": "C0DEED",
                "profile_background_image_url": "http://pbs.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
                "profile_background_image_url_https": "https://pbs.twimg.com/profile_background_images/656927849/miyt9dpjz77sc0w3d4vj.png",
                "profile_background_tile": true,
                "profile_link_color": "0084B4",
                "profile_sidebar_border_color": "C0DEED",
                "profile_sidebar_fill_color": "DDEEF6",
                "profile_text_color": "333333",
                "profile_use_background_image": true,
                "profile_image_url": "http://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
                "profile_image_url_https": "https://pbs.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
                "profile_banner_url": "https://pbs.twimg.com/profile_banners/6253282/1431474710",
                "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": [],
                "trends": [],
                "urls": [
                    {
                        "url": "https://t.co/VrFm1qGZnF",
                        "expanded_url": "https://twittercommunity.com/t/twitter-video-now-supported-in-rest-and-streaming-api/31258",
                        "display_url": "twittercommunity.com/t/twitter-vide…",
                        "indices": [
                            47,
                            70
                        ]
                    }
                ],
                "user_mentions": [],
                "symbols": []
            },
            "favorited": false,
            "retweeted": false,
            "possibly_sensitive": false,
            "filter_level": "low",
            "lang": "en"
        },
        "retweet_count": 0,
        "favorite_count": 0,
        "entities": {
            "hashtags": [],
            "trends": [],
            "urls": [
                {
                    "url": "https://t.co/plSZZhcvkP",
                    "expanded_url": "https://twitter.com/twitterapi/status/560101531794821120",
                    "display_url": "twitter.com/twitterapi/sta…",
                    "indices": [
                        14,
                        37
                    ]
                }
            ],
            "user_mentions": [],
            "symbols": []
        },
        "favorited": false,
        "retweeted": false,
        "possibly_sensitive": false,
        "filter_level": "low",
        "lang": "en",
        "timestamp_ms": "1432238628134"
    }
}

Quoted Tweets / Retweets W/Comments Not Received
API Payloads to include original quoted Tweet objects
#2

Hi,

In the case of Site Streams, will the events be cases where a tracked user quoted another user’s tweet or where a tracked user’s tweet was itself quoted?

Thanks,
Aaron Rankin
Sprout Social


#3