Please note
We recently released user lookup, a set of Twitter API v2 endpoints that have the same functionality as this one. The new version is currently in development and serves adequate access for the majority of developers on our platform. While elevated levels of access are coming soon, developers in need of higher levels of access should continue to use this endpoint along with the Twitter API v2 version.
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: Bearer <bearer>'
$ 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¶
{user-object}
For more detail, see the user-object definition.