Sign in

v11

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0112893437.0 KB
Users

Get user profile with follower counts and verification

get/x/users/{id}

Path parameters

idstring required

X username (without @) or user ID

Response

User profile

idstring required
usernamestring required
namestring required
descriptionstring
followersinteger
followinginteger
verifiedboolean
isBlueVerifiedboolean

Whether X shows a blue verification badge

isVerifiedboolean

Whether X marks the profile as verified

profilePicturestring
coverPicturestring
profileBannerUrlstring

Original X profile banner field when available

locationstring
createdAtstring
statusesCountinteger
mediaCountinteger
protectedboolean

Whether the profile protects its posts

urlstring
favouritesCountinteger
hasCustomTimelinesboolean
isTranslatorboolean
withheldInCountriesstring[]
possiblySensitiveboolean
pinnedTweetIdsstring[]
isAutomatedboolean
automatedBystring
unavailableboolean
unavailableReasonstring
verifiedTypestring
businessAccountAffiliatesCountinteger
creatorSubscriptionsCountinteger
hasGraduatedAccessboolean
hasHiddenSubscriptionsOnProfileboolean
isProfileTranslatableboolean
parodyCommentaryFanLabelstring
profileDescriptionLanguagestring
profileImageShapestring
profileInterstitialTypestring
profileSortEnabledboolean
profileTranslatorTypestring
superFollowEligibleboolean
communityRolestring

Community role when returned by community member reads

profile_bioobject

Structured profile bio with entity annotations

Example response

{
  "id": "9876543210",
  "username": "elonmusk",
  "name": "Elon Musk",
  "description": "CEO of Tesla, SpaceX, and X",
  "followers": 150000000,
  "following": 500,
  "verified": true,
  "isBlueVerified": true,
  "isVerified": true,
  "profilePicture": "https://pbs.twimg.com/profile_images/example.jpg",
  "coverPicture": "https://pbs.twimg.com/profile_banners/example.jpg",
  "profileBannerUrl": "https://pbs.twimg.com/profile_banners/example.jpg",
  "location": "Austin, TX",
  "createdAt": "2009-06-02T20:12:29Z",
  "statusesCount": 35000,
  "mediaCount": 1200,
  "url": "https://xquik.com",
  "favouritesCount": 18000,
  "hasCustomTimelines": true,
  "withheldInCountries": [
    "DE"
  ],
  "pinnedTweetIds": [
    "1234567890"
  ],
  "automatedBy": "example_user",
  "unavailableReason": "suspended",
  "verifiedType": "Business",
  "communityRole": "Member",
  "profile_bio": {
    "description": "CEO of Tesla, SpaceX, and X",
    "entities": {
      "urls": []
    }
  }
}