GET statuses/show/:id

Updated on Wed, 2012-04-18 10:37

Returns a single status, specified by the id parameter below. The status's author will be returned inline.

Resource URL

http://api.twitter.com/1/statuses/show/:id.format

Parameters

id required

The numerical ID of the desired status.

Example Values: 123

trim_user optional

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

include_entities optional

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

include_my_retweet optional

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 or "contributors" : {}. This field will only be populated if the user has contributors enabled on his or her account -- this is a beta feature that is not yet generally available to all.

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

https://api.twitter.com/1/statuses/show.json?id=112652479837110273&include_entities=true

  1. {
  2.   "coordinates": null,
  3.   "created_at": "Sat Sep 10 22:23:38 +0000 2011",
  4.   "truncated": false,
  5.   "favorited": false,
  6.   "id_str": "112652479837110273",
  7.   "entities": {
  8.     "urls": [
  9.       {
  10.         "expanded_url": "http://instagr.am/p/MuW67/",
  11.         "url": "http://t.co/6J2EgYM",
  12.         "indices": [
  13.           67,
  14.           86
  15.         ],
  16.         "display_url": "instagr.am/p/MuW67/"
  17.       }
  18.     ],
  19.     "hashtags": [
  20.       {
  21.         "text": "tcdisrupt",
  22.         "indices": [
  23.           32,
  24.           42
  25.         ]
  26.       }
  27.     ],
  28.     "user_mentions": [
  29.       {
  30.         "name": "Twitter",
  31.         "id_str": "783214",
  32.         "id": 783214,
  33.         "indices": [
  34.           0,
  35.           8
  36.         ],
  37.         "screen_name": "twitter"
  38.       },
  39.       {
  40.         "name": "Picture.ly",
  41.         "id_str": "334715534",
  42.         "id": 334715534,
  43.         "indices": [
  44.           15,
  45.           28
  46.         ],
  47.         "screen_name": "SeePicturely"
  48.       },
  49.       {
  50.         "name": "Bosco So",
  51.         "id_str": "14792670",
  52.         "id": 14792670,
  53.         "indices": [
  54.           46,
  55.           58
  56.         ],
  57.         "screen_name": "boscomonkey"
  58.       },
  59.       {
  60.         "name": "Taylor Singletary",
  61.         "id_str": "819797",
  62.         "id": 819797,
  63.         "indices": [
  64.           59,
  65.           66
  66.         ],
  67.         "screen_name": "episod"
  68.       }
  69.     ]
  70.   },
  71.   "in_reply_to_user_id_str": "783214",
  72.   "text": "@twitter meets @seepicturely at #tcdisrupt cc.@boscomonkey @episod http://t.co/6J2EgYM",
  73.   "contributors": null,
  74.   "id": 112652479837110273,
  75.   "retweet_count": 0,
  76.   "in_reply_to_status_id_str": null,
  77.   "geo": null,
  78.   "retweeted": false,
  79.   "possibly_sensitive": false,
  80.   "in_reply_to_user_id": 783214,
  81.   "place": null,
  82.   "source": "<a href=\"http://instagr.am\" rel=\"nofollow\">Instagram</a>",
  83.   "user": {
  84.     "profile_sidebar_border_color": "eeeeee",
  85.     "profile_background_tile": true,
  86.     "profile_sidebar_fill_color": "efefef",
  87.     "name": "Eoin McMillan ",
  88.     "profile_image_url": "http://a1.twimg.com/profile_images/1380912173/Screen_shot_2011-06-03_at_7.35.36_PM_normal.png",
  89.     "created_at": "Mon May 16 20:07:59 +0000 2011",
  90.     "location": "Twitter",
  91.     "profile_link_color": "009999",
  92.     "follow_request_sent": null,
  93.     "is_translator": false,
  94.     "id_str": "299862462",
  95.     "favourites_count": 0,
  96.     "default_profile": false,
  97.     "url": "http://www.eoin.me",
  98.     "contributors_enabled": false,
  99.     "id": 299862462,
  100.     "utc_offset": null,
  101.     "profile_image_url_https": "https://si0.twimg.com/profile_images/1380912173/Screen_shot_2011-06-03_at_7.35.36_PM_normal.png",
  102.     "profile_use_background_image": true,
  103.     "listed_count": 0,
  104.     "followers_count": 9,
  105.     "lang": "en",
  106.     "profile_text_color": "333333",
  107.     "protected": false,
  108.     "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme14/bg.gif",
  109.     "description": "Eoin's photography account. See @mceoin for tweets.",
  110.     "geo_enabled": false,
  111.     "verified": false,
  112.     "profile_background_color": "131516",
  113.     "time_zone": null,
  114.     "notifications": null,
  115.     "statuses_count": 255,
  116.     "friends_count": 0,
  117.     "default_profile_image": false,
  118.     "profile_background_image_url": "http://a1.twimg.com/images/themes/theme14/bg.gif",
  119.     "screen_name": "imeoin",
  120.     "following": null,
  121.     "show_all_inline_media": false
  122.   },
  123.   "in_reply_to_screen_name": "twitter",
  124.   "in_reply_to_status_id": null
  125. }