Vee3

Get X user info

Look up an X (Twitter) user profile by handle or numeric user id.

← All X / Twitter endpoints · Capability overview

GET/v1/x-twitter/user-info

https://api.vee3.io/v1/x-twitter/user-info

2 tokens

Look up an X (Twitter) user profile by handle or numeric user id.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

x-twitter.user_info
Parameters2 fields
user_namestringOptional

X handle without the leading @ (for example elonmusk). Required when rest_id is omitted.

max length 50

rest_idstringOptional

Numeric X user id (rest_id). When provided, user_name is ignored.

max length 32

Response26 fields
statusstring

Profile lookup status from the upstream provider.

profilestring

X screen name (handle).

rest_idstring

Numeric X user id.

namestring

Display name shown on the profile.

descstring

Profile bio / description.

avatarstring

Profile avatar image URL.

header_imagestring

Profile banner image URL.

blue_verifiedboolean

Whether the account has X blue verification.

protectedboolean

Whether the account is protected (private).

friendsinteger

Number of accounts the user follows.

sub_countinteger

Follower count.

statuses_countinteger

Total post count.

media_countinteger

Total media item count.

created_atstring

Account creation timestamp from X.

locationstring

Profile location string.

verification_typestring

Verification type label from X when present.

idstring

Numeric X user id (may duplicate rest_id).

pinned_tweet_ids_strstring[]

Pinned tweet ids for the profile when present.

affiliatesobject
2 fields

Affiliate account metadata when present (object or empty array from the provider). Additional provider-specific fields may appear.

urlstring

Affiliate profile or badge URL when provided.

descriptionstring

Affiliate description text when provided.

business_accountobject
4 fields

Business account metadata when present (object with counts or empty array from the provider when not applicable).

affiliates_countinteger

Number of affiliate accounts when provided.

categoryobject
2 fields

Business category metadata when provided.

namestring

Business category name.

idstring

Business category id.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, x_user_not_found, x_twitter_not_configured, x_twitter_upstream_error