User lookup by IDs
GET/2/usersThis endpoint returns information about users. Specify users by their ID.
Request
Required. A list of User IDs, comma-separated. You can specify up to 100 IDs.
A comma separated list of fields to expand.
A comma separated list of Tweet fields to display.
A comma separated list of User fields to display.
Request samples
Responses
Creation time of this user.
The text of this user's profile description (also known as bio), if the user provided one.
A list of metadata found in the user's profile description.
Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries.
The friendly name of this user, as shown on their profile.
Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
The URL to the profile image for this user.
Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private).
A list of metrics for this user
The URL specified in the user's profile.
The Twitter handle (screen name) of this user.
Indicate if this user is a verified Twitter User.
Indicates withholding details for withheld content.
A generic problem with no additional information beyond that provided by the HTTP status code.
A problem that indicates this request is invalid.
A problem that indicates your client is forbidden from making this request.
A problem that indicates that a given Tweet, User, etc. does not exist.
A problem that indicates a particular Tweet, User, etc. is not available to you.
A problem that indicates you are not allowed to see a particular Tweet, User, etc.
A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.
A problem that indicates that the resource requested violates the precepts of this API.
A problem that indicates that the authentication used is not supported.
A problem that indicates that a usage cap has been exceeded.
A problem that indicates something is wrong with the connection
Your client has gone away.
You have been disconnected for operational reasons.
You have exceeded the maximum number of rules.
The rule you have submitted is invalid.
The rule you have submitted is a duplicate.
You cannot create a new job if one is already in progress.
{
"data": [
{
"created_at": "2013-12-14T04:35:55Z",
"id": "2244994945",
"name": "Twitter Dev",
"protected": false,
"username": "TwitterDev"
}
],
"errors": [
{
"detail": "string",
"title": "string",
"status": 0,
"type": "about:blank"
}
],
"includes": {
"media": [
{
"height": 0,
"media_key": "string",
"width": 0,
"alt_text": "string",
"type": "photo",
"url": "http://example.com"
}
],
"places": [
{
"contained_within": [
"f7eb2fa2fea288b1"
],
"country": "United States",
"country_code": "US",
"full_name": "Lakewood, CO",
"geo": {
"bbox": [
-105.193475,
39.60973,
-105.053164,
39.761974
],
"geometry": {
"coordinates": [
-105.18816086351444,
40.247749999999996
],
"type": "Point"
},
"properties": {},
"type": "Feature"
},
"id": "f7eb2fa2fea288b1",
"name": "Lakewood",
"place_type": "city"
}
],
"polls": [
{
"duration_minutes": 0,
"end_datetime": "2019-08-24T14:15:22.123Z",
"id": "1365059861688410112",
"options": [
{
"label": "string",
"position": 0,
"votes": 0
},
{
"label": "string",
"position": 0,
"votes": 0
}
],
"voting_status": "open"
}
],
"tweets": [
{
"author_id": "2244994945",
"created_at": "Wed Jan 06 18:40:40 +0000 2021",
"id": "1346889436626259968",
"text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
}
],
"users": [
{
"created_at": "2013-12-14T04:35:55Z",
"id": "2244994945",
"name": "Twitter Dev",
"protected": false,
"username": "TwitterDev"
}
]
}
}