get-users-show

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.x.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.x.com/1.1/users/show.json?screen_name=twitterdev' 
    --header 'authorization: Bearer <bearer>'

$ curl --request GET 
  --url 'https://api.x.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¶

{user-object}

For more detail, see the user-object definition.