Sign in

v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB
Users

Get user by username

Get a user profile by their username (screen name). Returns comprehensive profile data including bio, follower/following counts, verification status, and account metadata. The most common way to look up a user profile.

get/v1/twitter/users/{username}/by_username

Path parameters

usernamestring required
Example:elonmusk

The username (screen name) of the user, without the @ symbol.

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"
}