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 user’s 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) 900
Requests / 15-min window (app auth) 900

Parameters

Name Required Description Default Value Example
user_id required The ID of the user for whom to return results. Either an id or screen_name is required for this method.   12345
screen_name required The screen name of the user for whom to return results. Either a id or screen_name is required for this method.   noradio
include_entities optional The entities node will not be included when set to false.   false

Example Request

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

Example Response

{
  "id": 2244994945,
  "id_str": "2244994945",
  "name": "TwitterDev",
  "screen_name": "TwitterDev",
  "location": "Internet",
  "profile_location": null,
  "description": "Developer and Platform Relations @Twitter. We are developer advocates. We can't answer all your questions, but we listen to all of them!",
  "url": "https://t.co/66w26cua1O",
  "entities": {
    "url": {
      "urls": [
        {
          "url": "https://t.co/66w26cua1O",
          "expanded_url": "https://dev.twitter.com/",
          "display_url": "dev.twitter.com",
          "indices": [
            0,
            23
          ]
        }
      ]
    },
    "description": {
      "urls": []
    }
  },
  "protected": false,
  "followers_count": 429831,
  "friends_count": 1535,
  "listed_count": 999,
  "created_at": "Sat Dec 14 04:35:55 +0000 2013",
  "favourites_count": 1713,
  "utc_offset": -25200,
  "time_zone": "Pacific Time (US & Canada)",
  "geo_enabled": true,
  "verified": true,
  "statuses_count": 2588,
  "lang": "en",
  "status": {
    "created_at": "Tue Aug 30 10:52:20 +0000 2016",
    "id": 770574870841331700,
    "id_str": "770574870841331712",
    "text": "@lesterhan oops! Thanks for pointing that out, looks like the image is no longer available! we will fix in a future doc version! ^AP",
    "truncated": false,
    "entities": {
      "hashtags": [],
      "symbols": [],
      "user_mentions": [
        {
          "screen_name": "lesterhan",
          "name": "Lester Han",
          "id": 126025266,
          "id_str": "126025266",
          "indices": [
            0,
            10
          ]
        }
      ],
      "urls": []
    },
    "source": "<a href=\"https://about.twitter.com/products/tweetdeck\" rel=\"nofollow\">TweetDeck</a>",
    "in_reply_to_status_id": 770332467626672100,
    "in_reply_to_status_id_str": "770332467626672129",
    "in_reply_to_user_id": 126025266,
    "in_reply_to_user_id_str": "126025266",
    "in_reply_to_screen_name": "lesterhan",
    "geo": null,
    "coordinates": null,
    "place": null,
    "contributors": null,
    "is_quote_status": false,
    "retweet_count": 0,
    "favorite_count": 0,
    "favorited": false,
    "retweeted": false,
    "lang": "en"
  },
  "contributors_enabled": false,
  "is_translator": false,
  "is_translation_enabled": false,
  "profile_background_color": "FFFFFF",
  "profile_background_image_url": "http://abs.twimg.com/images/themes/theme1/bg.png",
  "profile_background_image_url_https": "https://abs.twimg.com/images/themes/theme1/bg.png",
  "profile_background_tile": false,
  "profile_image_url": "http://pbs.twimg.com/profile_images/530814764687949824/npQQVkq8_normal.png",
  "profile_image_url_https": "https://pbs.twimg.com/profile_images/530814764687949824/npQQVkq8_normal.png",
  "profile_banner_url": "https://pbs.twimg.com/profile_banners/2244994945/1396995246",
  "profile_link_color": "0084B4",
  "profile_sidebar_border_color": "FFFFFF",
  "profile_sidebar_fill_color": "DDEEF6",
  "profile_text_color": "333333",
  "profile_use_background_image": false,
  "has_extended_profile": false,
  "default_profile": false,
  "default_profile_image": false,
  "following": false,
  "follow_request_sent": false,
  "notifications": false,
  "translator_type": "regular"
}