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.
Returns a variety of information about the user specified by the required
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.
|Requests / 15-min window (user auth)||900|
|Requests / 15-min window (app auth)||900|
|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|
$ 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
For more detail, see the user-object definition.