GET users/show

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.

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.

Resource URL

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

Resource Information

Response formats
JSON
Requires authentication?
Yes
Rate limited?
Yes
Requests / 15-min window (user auth)
180
Requests / 15-min window (app auth)
180

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

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

GET

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

Example Result

{
  "profile_sidebar_fill_color": "F8FCF2",
  "profile_sidebar_border_color": "547980",
  "profile_background_tile": true,
  "name": "Ryan Sarver",
  "profile_image_url": "http://a0.twimg.com/profile_images/1777569006/image1327396628_normal.png",
  "created_at": "Mon Feb 26 18:05:55 +0000 2007",
  "location": "San Francisco, CA",
  "follow_request_sent": false,
  "profile_link_color": "547980",
  "is_translator": false,
  "id_str": "795649",
  "default_profile": false,
  "contributors_enabled": true,
  "favourites_count": 3162,
  "url": null,
  "profile_image_url_https": "https://si0.twimg.com/profile_images/1777569006/image1327396628_normal.png",
  "utc_offset": -28800,
  "id": 795649,
  "profile_use_background_image": true,
  "listed_count": 1586,
  "profile_text_color": "594F4F",
  "lang": "en",
  "followers_count": 276334,
  "protected": false,
  "notifications": true,
  "profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png",
  "profile_background_color": "45ADA8",
  "verified": false,
  "geo_enabled": true,
  "time_zone": "Pacific Time (US & Canada)",
  "description": "Director, Platform at Twitter. Detroit and Boston export. Foodie and over-the-hill hockey player. @devon's lesser half",
  "default_profile_image": false,
  "profile_background_image_url": "http://a0.twimg.com/profile_background_images/113854313/xa60e82408188860c483d73444d53e21.png",
  "status": {
    "coordinates": null,
    "favorited": false,
    "truncated": false,
    "created_at": "Sat Aug 25 19:33:11 +0000 2012",
    "retweeted_status": {
      "coordinates": null,
      "favorited": false,
      "truncated": false,
      "created_at": "Sat Aug 25 19:20:36 +0000 2012",
      "id_str": "239442171466493953",
      "entities": {
        "urls": [
          {
            "expanded_url": "http://nbcnews.to/NtkRTJ",
            "url": "http://t.co/f8ivBrVd",
            "indices": [
              102,
              122
            ],
            "display_url": "nbcnews.to/NtkRTJ"
          }
        ],
        "hashtags": [

        ],
        "user_mentions": [

        ]
      },
      "in_reply_to_user_id_str": null,
      "contributors": null,
      "text": "Neil Armstrong has died at the age of 82 from complications from heart operations he had 3 weeks ago. http://t.co/f8ivBrVd",
      "retweet_count": 112,
      "in_reply_to_status_id_str": null,
      "id": 239442171466493953,
      "geo": null,
      "retweeted": false,
      "possibly_sensitive": false,
      "in_reply_to_user_id": null,
      "place": null,
      "in_reply_to_screen_name": null,
      "source": "web",
      "in_reply_to_status_id": null
    },
    "id_str": "239445335481647105",
    "entities": {
      "urls": [
        {
          "expanded_url": "http://nbcnews.to/NtkRTJ",
          "url": "http://t.co/f8ivBrVd",
          "indices": [
            115,
            135
          ],
          "display_url": "nbcnews.to/NtkRTJ"
        }
      ],
      "hashtags": [

      ],
      "user_mentions": [
        {
          "name": "NBC News",
          "id_str": "14173315",
          "id": 14173315,
          "indices": [
            3,
            11
          ],
          "screen_name": "NBCNews"
        }
      ]
    },
    "in_reply_to_user_id_str": null,
    "contributors": null,
    "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",
    "retweet_count": 112,
    "in_reply_to_status_id_str": null,
    "id": 239445335481647105,
    "geo": null,
    "retweeted": false,
    "possibly_sensitive": false,
    "in_reply_to_user_id": null,
    "place": null,
    "in_reply_to_screen_name": null,
    "source": "Twitter for  iPhone",
    "in_reply_to_status_id": null
  },
  "statuses_count": 13728,
  "friends_count": 1780,
  "following": true,
  "show_all_inline_media": true,
  "screen_name": "rsarver"
}