User lookup by username - Twitter API v2

This endpoint returns information about a user. Specify user by username.

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

username

必需

Required. A username.

示例值:

TwitterDev

Query 参数

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

object (User)

可选

The Twitter User object

示例值:

{"created_at":"2013-12-14T04:35:55Z","id":"2244994945","name":"Twitter Dev","protected":false,"username":"TwitterDev"}

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.

#/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.

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

🔴500500