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"
