Twitter API Documentation
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.
Body
PARAM
| 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"
}
]
} |
Curl
curl -X GET 'https://api.twitter.com/2/users?ids=?ids=&user.fields=&expansions=&tweet.fields='