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

$ curl --request GET 
  --url 'https://api.twitter.com/1.1/users/show.json?screen_name=twitterdev' 
  --header 'authorization: OAuth oauth_consumer_key="consumer-key-for-app", 
  oauth_nonce="generated-nonce", oauth_signature="generated-signature", 
  oauth_signature_method="HMAC-SHA1", oauth_timestamp="generated-timestamp", 
  oauth_version="1.0"'
$ twurl /1.1/users/show.json?screen_name=twitterdev

Example Response

{
  "id": 2244994945,
  "id_str": "2244994945",
  "name": "Twitter Dev",
  "screen_name": "TwitterDev",
  "location": "Internet",
  "profile_location": null,
  "description": "Your official source for Twitter Platform news, updates & events. Need technical help? Visit https://t.co/mGHnxZU8c1 ⌨️ #TapIntoTwitter",
  "url": "https://t.co/FGl7VOULyL",
  "entities": {
    "url": {
      "urls": [
        {
          "url": "https://t.co/FGl7VOULyL",
          "expanded_url": "https://developer.twitter.com/",
          "display_url": "developer.twitter.com",
          "indices": [
            0,
            23
          ]
        }
      ]
    },
    "description": {
      "urls": [
        {
          "url": "https://t.co/mGHnxZU8c1",
          "expanded_url": "https://twittercommunity.com/",
          "display_url": "twittercommunity.com",
          "indices": [
            93,
            116
          ]
        }
      ]
    }
  },
  "protected": false,
  "followers_count": 492751,
  "friends_count": 1488,
  "listed_count": 1296,
  "created_at": "Sat Dec 14 04:35:55 +0000 2013",
  "favourites_count": 2206,
  "utc_offset": -28800,
  "time_zone": "Pacific Time (US & Canada)",
  "geo_enabled": true,
  "verified": true,
  "statuses_count": 3309,
  "lang": "en",
  "status": {
    "created_at": "Mon Mar 05 14:00:36 +0000 2018",
    "id": 970660352487804928,
    "id_str": "970660352487804928",
    "text": "RT @TDC_israel: Join our 1st #TapIntoTwitter event at: 21/3nn@eladmeidar - Back to the 90s: Social text based gamingnRoee Sheelo - Tokyo Dr…",
    "truncated": false,
    "entities": {
      "hashtags": [
        {
          "text": "TapIntoTwitter",
          "indices": [
            29,
            44
          ]
        }
      ],
      "symbols": [],
      "user_mentions": [
        {
          "screen_name": "TDC_israel",
          "name": "Israel Developers Community",
          "id": 948969690650554369,
          "id_str": "948969690650554369",
          "indices": [
            3,
            14
          ]
        },
        {
          "screen_name": "eladmeidar",
          "name": "Lord Meidar",
          "id": 16815376,
          "id_str": "16815376",
          "indices": [
            61,
            72
          ]
        }
      ],
      "urls": []
    },
    "source": "<a href="https://about.twitter.com/products/tweetdeck" rel="nofollow">TweetDeck</a>",
    "in_reply_to_status_id": null,
    "in_reply_to_status_id_str": null,
    "in_reply_to_user_id": null,
    "in_reply_to_user_id_str": null,
    "in_reply_to_screen_name": null,
    "geo": null,
    "coordinates": null,
    "place": null,
    "contributors": null,
    "retweeted_status": {
      "created_at": "Sun Mar 04 19:44:05 +0000 2018",
      "id": 970384402705473543,
      "id_str": "970384402705473543",
      "text": "Join our 1st #TapIntoTwitter event at: 21/3nn@eladmeidar - Back to the 90s: Social text based gamingnRoee Sheelo -… https://t.co/7muTWy531w",
      "truncated": true,
      "entities": {
        "hashtags": [
          {
            "text": "TapIntoTwitter",
            "indices": [
              13,
              28
            ]
          }
        ],
        "symbols": [],
        "user_mentions": [
          {
            "screen_name": "eladmeidar",
            "name": "Lord Meidar",
            "id": 16815376,
            "id_str": "16815376",
            "indices": [
              45,
              56
            ]
          }
        ],
        "urls": [
          {
            "url": "https://t.co/7muTWy531w",
            "expanded_url": "https://twitter.com/i/web/status/970384402705473543",
            "display_url": "twitter.com/i/web/status/9…",
            "indices": [
              116,
              139
            ]
          }
        ]
      },
      "source": "<a href="http://twitter.com" rel="nofollow">Twitter Web Client</a>",
      "in_reply_to_status_id": null,
      "in_reply_to_status_id_str": null,
      "in_reply_to_user_id": null,
      "in_reply_to_user_id_str": null,
      "in_reply_to_screen_name": null,
      "geo": null,
      "coordinates": null,
      "place": null,
      "contributors": null,
      "is_quote_status": false,
      "retweet_count": 2,
      "favorite_count": 9,
      "favorited": false,
      "retweeted": false,
      "possibly_sensitive": false,
      "lang": "en"
    },
    "is_quote_status": false,
    "retweet_count": 2,
    "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/880136122604507136/xHrnqf1T_normal.jpg",
  "profile_image_url_https": "https://pbs.twimg.com/profile_images/880136122604507136/xHrnqf1T_normal.jpg",
  "profile_banner_url": "https://pbs.twimg.com/profile_banners/2244994945/1498675817",
  "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": null,
  "follow_request_sent": null,
  "notifications": null,
  "translator_type": "regular"
}