Users by ID
GET https://api.twitter.com/2/users?ids=2244994945,783214,6253282
This endpoint returns details about up to 100 users by ID.
For full details, see the API reference for this endpoint.
Sign up for the Twitter API
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
ids | string | Required. Enter up to 100 comma-separated user IDs. | |
user.fields | null | Comma-separated fields for the user object. |
Allowed values: created_at,description,entities,id,location,name,pinned_tweet_id,profile_image_url,protected,public_metrics,url,username,verified,withheld
Default values:
id,name,username |
| expansions
| null | | Expansions enable requests to expand an ID into a full object in the includes response object.
Allowed value: pinned_tweet_id
Default value: none |
| tweet.fields
| null | | Comma-separated list of fields for the Tweet object. Expansion required.
Allowed values: attachments,author_id,context_annotations,conversation_id,created_at,entities,geo,id,in_reply_to_user_id,lang,non_public_metrics,organic_metrics,possibly_sensitive,promoted_metrics,public_metrics,referenced_tweets,reply_settings,source,text,withheld
Default values: id,text
OAuth1.0a User Context authorization required if any of the following fields are included in the request: non_public_metrics,organic_metrics,promoted_metrics |
RESPONSES
status: OK
{"data":[{"id":"12","name":"jack","username":"jack"},{"id":"2244994945","name":"Twitter Dev","username":"TwitterDev"}],"errors":[{"detail":"Could not find user with ids: [2244994946].","title":"Not Found Error","resource_type":"user","parameter":"ids","value":"2244994946","type":"https://api.twitter.com/2/problems/resource-not-found"}]}