GET statuses/show/:id

Updated on Thu, 2013-03-07 10:37

Returns a single Tweet, specified by the id parameter. The Tweet's author will also be embedded within the tweet.

See Embeddable Timelines, Embeddable Tweets, and GET statuses/oembed for tools to render Tweets according to Display Requirements.

Resource URL

https://api.twitter.com/1.1/statuses/show.json

Parameters

id required

The numerical ID of the desired Tweet.

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_my_retweet optional

When set to either true, t or 1, any Tweets 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.

Example Values: true

include_entities optional

The entities node will be disincluded when set to false.

Example Values: false

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 JSON response mostly uses conventions laid out in GeoJSON. Unfortunately, the coordinates that Twitter renders 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 Tweet, 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 JSON renders as such "contributors":[8285392].

Example Request

GET

https://api.twitter.com/1.1/statuses/show.json?id=210462857140252672

  1. {
  2.   "coordinates": null,
  3.   "favorited": false,
  4.   "truncated": false,
  5.   "created_at": "Wed Jun 06 20:07:10 +0000 2012",
  6.   "id_str": "210462857140252672",
  7.   "entities": {
  8.     "urls": [
  9.       {
  10.         "expanded_url": "https://dev.twitter.com/terms/display-guidelines",
  11.         "url": "https://t.co/Ed4omjYs",
  12.         "indices": [
  13.           76,
  14.           97
  15.         ],
  16.         "display_url": "dev.twitter.com/terms/display-\u2026"
  17.       }
  18.     ],
  19.     "hashtags": [
  20.       {
  21.         "text": "Twitterbird",
  22.         "indices": [
  23.           19,
  24.           31
  25.         ]
  26.       }
  27.     ],
  28.     "user_mentions": [
  29.  
  30.     ]
  31.   },
  32.   "in_reply_to_user_id_str": null,
  33.   "contributors": [
  34.     14927800
  35.   ],
  36.   "text": "Along with our new #Twitterbird, we've also updated our Display Guidelines: https://t.co/Ed4omjYs  ^JC",
  37.   "retweet_count": 66,
  38.   "in_reply_to_status_id_str": null,
  39.   "id": 210462857140252672,
  40.   "geo": null,
  41.   "retweeted": true,
  42.   "possibly_sensitive": false,
  43.   "in_reply_to_user_id": null,
  44.   "place": null,
  45.   "user": {
  46.     "profile_sidebar_fill_color": "DDEEF6",
  47.     "profile_sidebar_border_color": "C0DEED",
  48.     "profile_background_tile": false,
  49.     "name": "Twitter API",
  50.     "profile_image_url": "http://a0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
  51.     "created_at": "Wed May 23 06:01:13 +0000 2007",
  52.     "location": "San Francisco, CA",
  53.     "follow_request_sent": false,
  54.     "profile_link_color": "0084B4",
  55.     "is_translator": false,
  56.     "id_str": "6253282",
  57.     "entities": {
  58.       "url": {
  59.         "urls": [
  60.           {
  61.             "expanded_url": null,
  62.             "url": "http://dev.twitter.com",
  63.             "indices": [
  64.               0,
  65.               22
  66.             ]
  67.           }
  68.         ]
  69.       },
  70.       "description": {
  71.         "urls": [
  72.  
  73.         ]
  74.       }
  75.     },
  76.     "default_profile": true,
  77.     "contributors_enabled": true,
  78.     "favourites_count": 24,
  79.     "url": "http://dev.twitter.com",
  80.     "profile_image_url_https": "https://si0.twimg.com/profile_images/2284174872/7df3h38zabcvjylnyfe3_normal.png",
  81.     "utc_offset": -28800,
  82.     "id": 6253282,
  83.     "profile_use_background_image": true,
  84.     "listed_count": 10774,
  85.     "profile_text_color": "333333",
  86.     "lang": "en",
  87.     "followers_count": 1212963,
  88.     "protected": false,
  89.     "notifications": null,
  90.     "profile_background_image_url_https": "https://si0.twimg.com/images/themes/theme1/bg.png",
  91.     "profile_background_color": "C0DEED",
  92.     "verified": true,
  93.     "geo_enabled": true,
  94.     "time_zone": "Pacific Time (US & Canada)",
  95.     "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.",
  96.     "default_profile_image": false,
  97.     "profile_background_image_url": "http://a0.twimg.com/images/themes/theme1/bg.png",
  98.     "statuses_count": 3333,
  99.     "friends_count": 31,
  100.     "following": true,
  101.     "show_all_inline_media": false,
  102.     "screen_name": "twitterapi"
  103.   },
  104.   "in_reply_to_screen_name": null,
  105.   "source": "web",
  106.   "in_reply_to_status_id": null
  107. }

This request could also be obtained with: GET https://api.twitter.com/1.1/statuses/show/210462857140252672.json