Follow, search, and get users
API Reference contents
GET followers/ids
GET followers/list
GET friends/ids
GET friends/list
GET friendships/incoming
GET friendships/lookup
GET friendships/no_retweets/ids
GET friendships/outgoing
GET friendships/show
GET users/lookup
GET users/search
GET users/show
GET users/suggestions
GET users/suggestions/:slug
GET users/suggestions/:slug/members
POST friendships/create
POST friendships/destroy
POST friendships/update
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¶
{user-object}