Users by ID

GET https://api.twitter.com/2/users?ids=

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 | null | | 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 |

HEADERS

| Key | Datatype | Required | Description |

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"}]}