Twitter API v2
  • General
  • Tweets
  • Users
    • Returns user objects that have liked the provided Tweet IDGET
    • Returns user objects that have retweeted the provided Tweet IDGET
    • User lookup by IDsGET
    • User lookup by usernamesGET
    • User lookup by usernameGET
    • User lookup by IDGET
    • Returns user objects that are blocked by provided user IDGET
    • Block User by User IDPOST
    • Returns user objects that follow the provided user IDGET
    • Following by User IDGET
    • Follow UserPOST
    • Mute User by User IDPOST
    • Unblock User by User IDDELETE
    • Unfollow UserDELETE
    • Unmute User by User IDDELETE
logoPowered by Apifox
  1. Users

User lookup by usernames

GET/2/users/by

This endpoint returns information about users. Specify users by their username.

请求参数

Authorization: Bearer Token
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token
示例
Authorization: Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379
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.

示例代码

返回响应

The request was successful(200)
500(500)
The request was successful
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
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
必需
Could not resolve '#/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
可选
Could not resolve '#/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
必需
Could not resolve '#/components/schemas/UserName'
verified
boolean 
可选

Indicate if this user is a verified Twitter User.

withheld
#/components/schemas/UserWithheld
可选
Could not resolve '#/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.

object 
RulesCapProblem
可选

You have exceeded the maximum number of rules.

object 
InvalidRuleProblem
可选

The rule you have submitted is invalid.

object 
DuplicateRuleProblem
可选

The rule you have submitted is a duplicate.

includes
object (Expansions) 
可选
media
array[object (Media) {4}] 
可选
>= 1 items
places
array[object (Place) {8}] 
可选
>= 1 items
polls
array[object (Poll) {5}] 
可选
>= 1 items
tweets
array[object (Tweet) {20}] 
可选
>= 1 items
users
array[object (User) {14}] 
可选
>= 1 items
示例
未设置
最后修改时间： 3 年前