Returns a single status, specified by the id parameter below. The status's author will be returned inline.
Resource URL
Parameters
The numerical ID of the desired status.
Example Values: 123
When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.
Example Values: true
When set to either true, t or 1, each tweet will include a node called "entities,". This node offers a variety of metadata about the tweet in a discreet structure, including: user_mentions, urls, and hashtags. While entities are opt-in on timelines at present, they will be made a default component of output in the future. See Tweet Entities for more detail on entities.
Example Values: true
When set to either true, t or 1, any statuses returned that have been retweeted by the authenticating user will include an additional current_user_retweet node, containing the ID of the source status for the retweet. For all Phoenix API requests, this parameter is always set to true and cannot be overridden. For all other API requests, the default is to not include the current_user_retweet node unless requested.
Example Values: true
Extended description
About Geo
If there is no geotag for a status, then there will be an empty <geo/> or "geo" : {}. This can only be populated if the user has used the Geotagging API to send a statuses/update.
The XML response uses GeoRSS to encode the latitude and longitude. <georss:point> encodes as latitude, space, and longitude (see the response below for an example). For JSON, the response mostly uses conventions laid out in GeoJSON. Unfortunately, the coordinates that Twitter renderers are reversed from the GeoJSON specification (GeoJSON specifies a longitude then a latitude, whereas we are currently representing it as a latitude then a longitude). Our JSON renders as: "geo": { "type":"Point", "coordinates":[37.78029, -122.39697] }
Contributors
If there are no contributors for a status, then there will be an empty
This object contains an array of user IDs for users who have contributed to this status (an example of a status that has been contributed to is this one). In practice, there is usually only one ID in this array. The XML renders as <contributors><user_id>8285392</user_id></contributors>, and the JSON renders as such "contributors":[8285392].
Example Request
GET | |
{
"coordinates": null,
"created_at": "Sat Sep 10 22:23:38 +0000 2011",
"truncated": false,
"favorited": false,
"id_str": "112652479837110273",
"entities": {
"urls": [
{
"expanded_url": "http://instagr.am/p/MuW67/",
"url": "http://t.co/6J2EgYM",
"indices": [
67,
86
],
"display_url": "instagr.am/p/MuW67/"
}
],
"hashtags": [
{
"text": "tcdisrupt",
"indices": [
32,
42
]
}
],
"user_mentions": [
{
"name": "Twitter",
"id_str": "783214",
"id": 783214,
"indices": [
0,
8
],
"screen_name": "twitter"
},
{
"name": "Picture.ly",
"id_str": "334715534",
"id": 334715534,
"indices": [
15,
28
],
"screen_name": "SeePicturely"
},
{
"name": "Bosco So",
"id_str": "14792670",
"id": 14792670,
"indices": [
46,
58
],
"screen_name": "boscomonkey"
},
{
"name": "Taylor Singletary",
"id_str": "819797",
"id": 819797,
"indices": [
59,
66
],
"screen_name": "episod"
}
]
},
"in_reply_to_user_id_str": "783214",
"text": "@twitter meets @seepicturely at #tcdisrupt cc.@boscomonkey @episod http://t.co/6J2EgYM",
"contributors": null,
"id": 112652479837110273,
"retweet_count": 0,
"in_reply_to_status_id_str": null,
"geo": null,
"retweeted": false,
"possibly_sensitive": false,
"in_reply_to_user_id": 783214,
"place": null,
"source": "<a href=\"http://instagr.am\" rel=\"nofollow\">Instagram</a>",
"user": {
"profile_sidebar_border_color": "eeeeee",
"profile_background_tile": true,
"profile_sidebar_fill_color": "efefef",
"name": "Eoin McMillan ",
"profile_image_url": "http://a1.twimg.com/profile_images/1380912173/Screen_shot_2011-06-03_at_7.35.36_PM_normal.png",
"created_at": "Mon May 16 20:07:59 +0000 2011",
"location": "Twitter",
"profile_link_color": "009999",
"follow_request_sent": null,
"is_translator": false,
"id_str": "299862462",
"favourites_count": 0,
"default_profile": false,
"url": "http://www.eoin.me",
"contributors_enabled": false,
"id": 299862462,
"utc_offset": null,
"profile_image_url_https": "https://si0.twimg.com/profile_images/1380912173/Screen_shot_2011-06-03_at_7.35.36_PM_normal.png",
"profile_use_background_image": true,
"listed_count": 0,
"followers_count": 9,
"lang": "en",
"profile_text_color": "333333",
"protected": false,
"profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme14/bg.gif",
"description": "Eoin's photography account. See @mceoin for tweets.",
"geo_enabled": false,
"verified": false,
"profile_background_color": "131516",
"time_zone": null,
"notifications": null,
"statuses_count": 255,
"friends_count": 0,
"default_profile_image": false,
"profile_background_image_url": "http://a1.twimg.com/images/themes/theme14/bg.gif",
"screen_name": "imeoin",
"following": null,
"show_all_inline_media": false
},
"in_reply_to_screen_name": "twitter",
"in_reply_to_status_id": null
}