GET users/show

API version 1.1
Updated on Tue, 2013-04-23 07:26

Returns a variety of information about the user specified by the required user_id or screen_name parameter. The author's most recent Tweet will be returned inline when possible.

GET users/lookup is used to retrieve a bulk collection of user objects.

Resource URL

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

Parameters

user_id required

The ID of the user for whom to return results for. Either an id or screen_name is required for this method.

Example Values: 12345

screen_name required

The screen name of the user for whom to return results for. Either a id or screen_name is required for this method.

Example Values: noradio

include_entities optional

The entities node will be disincluded when set to false.

Example Values: false

Extended description

You must be following a protected user to be able to see their most recent Tweet. If you don't follow a protected user, the users Tweet will be removed. A Tweet will not always be returned in the current_status field.

Example Request

GET

https://api.twitter.com/1.1/users/show.json?screen_name=rsarver 

  1. {
  2.   "profile_sidebar_fill_color": "F8FCF2",
  3.   "profile_sidebar_border_color": "547980",
  4.   "profile_background_tile": true,
  5.   "name": "Ryan Sarver",
  6.   "profile_image_url": "http://a0.twimg.com/profile_images/1777569006/image1327396628_normal.png",
  7.   "created_at": "Mon Feb 26 18:05:55 +0000 2007",
  8.   "location": "San Francisco, CA",
  9.   "follow_request_sent": false,
  10.   "profile_link_color": "547980",
  11.   "is_translator": false,
  12.   "id_str": "795649",
  13.   "default_profile": false,
  14.   "contributors_enabled": true,
  15.   "favourites_count": 3162,
  16.   "url": null,
  17.   "profile_image_url_https": "https://si0.twimg.com/profile_images/1777569006/image1327396628_normal.png",
  18.   "utc_offset": -28800,
  19.   "id": 795649,
  20.   "profile_use_background_image": true,
  21.   "listed_count": 1586,
  22.   "profile_text_color": "594F4F",
  23.   "lang": "en",
  24.   "followers_count": 276334,
  25.   "protected": false,
  26.   "notifications": true,
  27.   "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png",
  28.   "profile_background_color": "45ADA8",
  29.   "verified": false,
  30.   "geo_enabled": true,
  31.   "time_zone": "Pacific Time (US & Canada)",
  32.   "description": "Director, Platform at Twitter. Detroit and Boston export. Foodie and over-the-hill hockey player. @devon's lesser half",
  33.   "default_profile_image": false,
  34.   "profile_background_image_url": "http://a0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png",
  35.   "status": {
  36.     "coordinates": null,
  37.     "favorited": false,
  38.     "truncated": false,
  39.     "created_at": "Sat Aug 25 19:33:11 +0000 2012",
  40.     "retweeted_status": {
  41.       "coordinates": null,
  42.       "favorited": false,
  43.       "truncated": false,
  44.       "created_at": "Sat Aug 25 19:20:36 +0000 2012",
  45.       "id_str": "239442171466493953",
  46.       "entities": {
  47.         "urls": [
  48.           {
  49.             "expanded_url": "http://nbcnews.to/NtkRTJ",
  50.             "url": "http://t.co/f8ivBrVd",
  51.             "indices": [
  52.               102,
  53.               122
  54.             ],
  55.             "display_url": "nbcnews.to/NtkRTJ"
  56.           }
  57.         ],
  58.         "hashtags": [
  59.  
  60.         ],
  61.         "user_mentions": [
  62.  
  63.         ]
  64.       },
  65.       "in_reply_to_user_id_str": null,
  66.       "contributors": null,
  67.       "text": "Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd",
  68.       "retweet_count": 112,
  69.       "in_reply_to_status_id_str": null,
  70.       "id": 239442171466493953,
  71.       "geo": null,
  72.       "retweeted": false,
  73.       "possibly_sensitive": false,
  74.       "in_reply_to_user_id": null,
  75.       "place": null,
  76.       "in_reply_to_screen_name": null,
  77.       "source": "web",
  78.       "in_reply_to_status_id": null
  79.     },
  80.     "id_str": "239445335481647105",
  81.     "entities": {
  82.       "urls": [
  83.         {
  84.           "expanded_url": "http://nbcnews.to/NtkRTJ",
  85.           "url": "http://t.co/f8ivBrVd",
  86.           "indices": [
  87.             115,
  88.             135
  89.           ],
  90.           "display_url": "nbcnews.to/NtkRTJ"
  91.         }
  92.       ],
  93.       "hashtags": [
  94.  
  95.       ],
  96.       "user_mentions": [
  97.         {
  98.           "name": "NBC News",
  99.           "id_str": "14173315",
  100.           "id": 14173315,
  101.           "indices": [
  102.             3,
  103.             11
  104.           ],
  105.           "screen_name": "NBCNews"
  106.         }
  107.       ]
  108.     },
  109.     "in_reply_to_user_id_str": null,
  110.     "contributors": null,
  111.     "text": "RT @NBCNews: Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd",
  112.     "retweet_count": 112,
  113.     "in_reply_to_status_id_str": null,
  114.     "id": 239445335481647105,
  115.     "geo": null,
  116.     "retweeted": false,
  117.     "possibly_sensitive": false,
  118.     "in_reply_to_user_id": null,
  119.     "place": null,
  120.     "in_reply_to_screen_name": null,
  121.     "source": "<a href=\"http://twitter.com\" rel=\"nofollow\">Twitter for  iPhone</a>",
  122.     "in_reply_to_status_id": null
  123.   },
  124.   "statuses_count": 13728,
  125.   "friends_count": 1780,
  126.   "following": true,
  127.   "show_all_inline_media": true,
  128.   "screen_name": "rsarver"
  129. }