API Payloads to include original quoted Tweet objects

rest
streaming
gnip
quote
quotetweet

#1

Over the next few weeks, API payloads for quote Tweets will begin to contain the fully-hydrated object for the original Tweet that was quoted. Streaming, REST and Gnip Realtime APIs will be updated to include this additional data.

Announced earlier this quarter, quote Tweets give users the ability to add new content in the form of a comment to an existing Tweet without character restrictions, and Twitter clients will display the original Tweet. You can see an example quote Tweet here:

After this change is made, the payload for a quote Tweet will include the following fields:

“quoted_status_id” (quoted Tweet ID)
“quoted_status_id_str” (String-version of quoted Tweet ID)
“quoted_status” (complete object of the quoted Tweet)

These new fields are additive (see Tweet field guide here). There are no changes to existing fields.

An example quote Tweet with the new objects is shown below:

{
    "created_at": "Thu May 21 20:03:48 +0000 2015",
    "id": 601478517394636801,
    "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": 560101531794821120,
    "quoted_status_id_str": "560101531794821120",
    "quoted_status": {
        "created_at": "Tue Jan 27 15:46:26 +0000 2015",
        "id": 560101531794821120,
        "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,
            "place": {
                "id": "96683cc9126741d1"
            }
        },
        "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"

#2

Excellent news @happycamper Is there a plan to include a stream event when someone’s tweet is quoted in this method?


#3

I’m seeing the quoted statuses in the steaming api but not the rest api. Is there something I have to enable?


#4

Just posted about quote Tweet events for UserStream here: Quote Tweet Events in the Streaming API


#5

Excellent news, thank you @happycamper


#6

Glad to see all the public API support this feature is getting. A couple quick questions.

Should we expect quoted_status in results from the search API?
Once fully rolled out will historical tweets also contain quoted_status?

Also since these quoted tweets are becoming first class citizens, I’d think “quoted_count” would be a symmetrical addition along with some REST methods to get a Tweet’s Quoted Tweets.


#7

Does the REST API support creating quoting tweets?


#8

It does now, just a status url to the end of a tweet


#9

Update: quote Tweet objects are now live in Streaming API.


#12