v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB

Users

Get user by ID

Get a user profile by their numeric Twitter ID. Returns comprehensive profile data including bio, follower/following counts, verification status, and account metadata. Use this when you have the numeric ID and need full profile details.

get/v1/twitter/users/{user_id}/by_id

Path parameters

user_idstring required

Example:44196397

The unique numeric ID of the user.

Response

Successfully retrieved user profile.

idstring required

Unique numeric user identifier.

usernamestring required

The user's screen name (handle).

namestring required

The user's display name.

descriptionstring nullable

The user's bio/description.

locationstring nullable

The user's self-reported location.

urlstring nullable

URL in the user's profile.

profile_image_urlstring nullable

URL of the user's profile image.

profile_banner_urlstring nullable

URL of the user's profile banner.

followers_countinteger

Number of followers.

following_countinteger

Number of accounts this user follows.

tweet_countinteger

Total number of tweets posted.

listed_countinteger

Number of lists this user appears on.

favourites_countinteger nullable

Number of tweets this user has liked.

media_countinteger nullable

Number of media items posted.

verifiedboolean

Whether the user is verified (legacy verification).

verified_typestring nullable

Type of verification (e.g., Government, Business).

is_blue_verifiedboolean nullable

Whether the user has a Twitter Blue/Premium subscription.

created_atstring required

Account creation timestamp.

created_at_datetimestring nullable

Account creation date in ISO 8601 format.

protectedboolean nullable

Whether the user's tweets are protected (private).

possibly_sensitiveboolean nullable

Whether the user's content may be sensitive.

followed_byboolean nullable

Whether this user follows the authenticated user.

followingboolean nullable

Whether the authenticated user follows this user.

can_dmboolean nullable

Whether the authenticated user can send a DM to this user.

professional_typestring nullable

Professional account type, if applicable.

pinned_tweet_idsstring[] nullable

IDs of the user's pinned tweets.

Example response

{
  "id": "44196397",
  "username": "elonmusk",
  "name": "Elon Musk",
  "description": "Mars & Cars, Chips & Dips",
  "location": "Mars",
  "created_at": "Tue Jun 02 20:12:29 +0000 2009"
}