This endpoint returns information about users. Specify users by their username.
请求示例请求示例
Shell
JavaScript
Java
Swift
curl--location--request GET 'https://api.twitter.com/2/users/by?usernames=TwitterDev,TwitterAPI,jack'
响应示例响应示例
200 - 示例 1
请求参数
Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Query 参数
usernames
必需
Required . A list of usernames, comma-separated. You can specify up to 100 usernames.
示例值:
TwitterDev,TwitterAPI,jack
expansions
可选
A comma separated list of fields to expand.
tweet.fields
可选
A comma separated list of Tweet fields to display.
user.fields
可选
A comma separated list of User fields to display.
返回响应
🟢200The request was successful
application/json
Body
data
array[object (User) {14}]
可选
>= 1 items
created_at
string<date-time>
可选
Creation time of this user.
description
string
可选
The text of this user's profile description (also known as bio), if the user provided one.
entities
object
可选
A list of metadata found in the user's profile description.
id
#/components/schemas/UserID
必需
location
string
可选
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.
name
string
必需
The friendly name of this user, as shown on their profile.
pinned_tweet_id
#/components/schemas/TweetID
可选
profile_image_url
string<uri>
可选
The URL to the profile image for this user.
protected
boolean
可选
Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private).
public_metrics
object
可选
A list of metrics for this user
url
string
可选
The URL specified in the user's profile.
username
#/components/schemas/UserName
必需
verified
boolean
可选
Indicate if this user is a verified Twitter User.
withheld
#/components/schemas/UserWithheld
可选
errors
array[null (Problem) {16}]
可选
>= 1 items
object
GenericProblem
可选
A generic problem with no additional information beyond that provided by the HTTP status code.
object
InvalidRequestProblem
可选
A problem that indicates this request is invalid.
object
ClientForbiddenProblem
可选
A problem that indicates your client is forbidden from making this request.
object
ResourceNotFoundProblem
可选
A problem that indicates that a given Tweet, User, etc. does not exist.
object
ResourceUnavailableProblem
可选
A problem that indicates a particular Tweet, User, etc. is not available to you.
object
ResourceUnauthorizedProblem
可选
A problem that indicates you are not allowed to see a particular Tweet, User, etc.
object
FieldUnauthorizedProblem
可选
A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.
object
DisallowedResourceProblem
可选
A problem that indicates that the resource requested violates the precepts of this API.
object
UnsupportedAuthenticationProblem
可选
A problem that indicates that the authentication used is not supported.
object
UsageCapExceededProblem
可选
A problem that indicates that a usage cap has been exceeded.
object
ConnectionExceptionProblem
可选
A problem that indicates something is wrong with the connection
object
ClientDisconnectedProblem
可选
Your client has gone away.
object
OperationalDisconnectProblem
可选
You have been disconnected for operational reasons.