GET users/show

API version 1
Updated on Wed, 2012-04-18 11:27

Returns extended information of a given user, specified by ID or screen name as per the required id parameter. The author's most recent status will be returned inline.

Resource URL

http://api.twitter.com/version/users/show.format

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

Note:: Specifies the ID of the user to befriend. Helpful for disambiguating when a valid user ID is also a valid screen name.

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

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

Extended description

You must be following a protected user to be able to see their most recent status update. If you don't follow a protected user, or request this method without autenticating, the users status will be removed.

The URL pattern /version/users/show/:screen_name_or_user_id.format is still accepted but not recommended. As a sequence of numbers is a valid screen name we recommend using the screen_name or user_id parameter instead.

Example Request

GET

https://api.twitter.com/1/users/show.json?screen_name=TwitterAPI&include_entities=true 

  1. {
  2.   "profile_sidebar_fill_color": "e0ff92",
  3.   "name": "Twitter API",
  4.   "profile_sidebar_border_color": "87bc44",
  5.   "profile_background_tile": false,
  6.   "created_at": "Wed May 23 06:01:13 +0000 2007",
  7.   "profile_image_url": "http://a3.twimg.com/profile_images/689684365/api_normal.png",
  8.   "location": "San Francisco, CA",
  9.   "follow_request_sent": false,
  10.   "id_str": "6253282",
  11.   "profile_link_color": "0000ff",
  12.   "is_translator": false,
  13.   "contributors_enabled": true,
  14.   "url": "http://dev.twitter.com",
  15.   "favourites_count": 15,
  16.   "utc_offset": -28800,
  17.   "id": 6253282,
  18.   "profile_use_background_image": true,
  19.   "listed_count": 6868,
  20.   "profile_text_color": "000000",
  21.   "protected": false,
  22.   "followers_count": 335343,
  23.   "lang": "en",
  24.   "notifications": false,
  25.   "geo_enabled": true,
  26.   "profile_background_color": "c1dfee",
  27.   "verified": true,
  28.   "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.",
  29.   "time_zone": "Pacific Time (US & Canada)",
  30.   "profile_background_image_url": "http://a3.twimg.com/profile_background_images/59931895/twitterapi-background-new.png",
  31.   "friends_count": 20,
  32.   "statuses_count": 2404,
  33.   "status": {
  34.     "coordinates": null,
  35.     "created_at": "Wed Dec 22 20:08:02 +0000 2010",
  36.     "favorited": false,
  37.     "truncated": false,
  38.     "id_str": "17672734540570624",
  39.     "entities": {
  40.       "urls": [
  41.         {
  42.           "expanded_url": "http://tumblr.com/xnr140f9mi",
  43.           "url": "http://t.co/37zl2jI",
  44.           "indices": [
  45.             93,
  46.             112
  47.           ],
  48.           "display_url": "tumblr.com/xnr140f9mi"
  49.         }
  50.       ],
  51.       "hashtags": [
  52.  
  53.       ],
  54.       "user_mentions": [
  55.  
  56.       ]
  57.     },
  58.     "in_reply_to_user_id_str": null,
  59.     "contributors": null,
  60.     "text": "Twitter downtime - Twitter is currently down. We are aware of the problem and working on it. http://t.co/37zl2jI",
  61.     "id": 17672734540570624,
  62.     "retweet_count": 30,
  63.     "in_reply_to_status_id_str": null,
  64.     "geo": null,
  65.     "retweeted": false,
  66.     "in_reply_to_user_id": null,
  67.     "source": "<a href=\"http://www.tumblr.com/\" rel=\"nofollow\">Tumblr</a>",
  68.     "in_reply_to_screen_name": null,
  69.     "place": null,
  70.     "in_reply_to_status_id": null
  71.   },
  72.   "following": true,
  73.   "screen_name": "twitterapi",
  74.   "show_all_inline_media": false
  75. }