GET /api/v1/x/users/{id}

Users

Changed on Oct 20, 2026

Returns 1 public profile with counts and verification details.

get/api/v1/x/users/{id}

Request

Base URL: https://xquik.com
URL: https://xquik.com/api/v1/x/users/{id}
Auth: one of:
- API key in header x-api-key
- HTTP bearer
- none

Path parameters

idstring required

User ID, username with or without @, or URL-encoded profile URL, such as x.com/nasa or x.com/i/user/11348282. A number is a user ID. Writes look up a username's ID before sending. Anything else gets 400 invalid_user_id.

Query parameters

fieldsstring

Example:id,text,author.username

Fields to keep in each row, comma-separated. Use dots for nested fields, such as author.username. A list keeps the field in each item. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name answers 400 unknown_field with the valid names, before any read. The price stays the same. SDK row types then hold only the named fields. A longer URL fails at the edge before Xquik reads it.

omitstring

Example:entities,media

Fields to drop from each row, comma-separated. It takes the same names as fields. With fields, it drops from the kept fields. A longer URL fails at the edge before Xquik reads it.

Response

User profile

idstring required

usernamestring required

namestring required

descriptionstring

followersinteger

Omitted when X sends no count, as for the account that first posted reused media.

followinginteger

verifiedboolean

isBlueVerifiedboolean

Whether X shows a blue verification badge

isVerifiedboolean

Whether X marks the profile as verified

profilePicturestring

Profile picture at 48 px, as X sends it.

profilePictureOriginalstring

The same profile picture at full size, as the account uploaded it. Download this one for the image.

coverPicturestring

profileBannerUrlstring

Original X profile banner field when available

locationstring

Account owner's public profile location text

accountBasedInUnavailableboolean

True when X withheld accountBasedIn from this read. Retry later.

accountBasedInAccurateboolean

False when X notes accountBasedIn may be inaccurate.

connectedViastring

How the account first connected to X.

connectedViaAccurateboolean

False when X notes that country may be inaccurate.

affiliateUsernamestring

Handle of the organization X shows the account is affiliated with, from its About page.

emailstring

First email the account publishes on its profile, lowercased. Omitted when it publishes none.

retweetedAtstring date-time nullable

UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed. Otherwise omitted.

createdAtstring

Account creation time.

statusesCountinteger

mediaCountinteger

protectedboolean

Whether the profile protects its posts

urlstring

favouritesCountinteger

hasCustomTimelinesboolean

isTranslatorboolean

withheldInCountriesstring[]

withheldScopestring

Whether X withholds a post or user

possiblySensitiveboolean

professionalPublicMetadata

Public metadata whose fields X defines.

grokTranslatedBioPublicMetadata

Public metadata whose fields X defines.

pinnedTweetIdsstring[]

isAutomatedboolean

automatedBystring

unavailableboolean

unavailableReasonstring

verifiedTypestring

businessAccountAffiliatesCountinteger

Whole number from 0.

creatorSubscriptionsCountinteger

Whole number from 0.

hasGraduatedAccessboolean

hasHiddenSubscriptionsOnProfileboolean

isProfileTranslatableboolean

parodyCommentaryFanLabelstring

profileDescriptionLanguagestring

profileImageShapestring

profileInterstitialTypestring

profileSortEnabledboolean

profileTranslatorTypestring

redirectsToUsernamestring

Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself.

superFollowEligibleboolean

superFollowsUserProfileActiveboolean

Whether X marks the subscription profile as active.

listedCountinteger

Public lists that include the profile.

fastFollowersCountinteger

Followers X counts as fast followers.

normalFollowersCountinteger

Followers minus fast followers.

defaultProfileboolean

Whether the profile keeps X's default theme.

defaultProfileImageboolean

Whether the profile keeps X's default avatar.

hasExtendedProfileboolean

Whether the profile filled X's extended fields, such as a birth date. True or false.

isTranslationEnabledboolean

Whether the account turned on X's translation of its posts. True or false.

geoEnabledboolean

Whether the profile may add a location to posts.

advertiserAccountTypestring

The account's X Ads type. none for an account without ads, or promotable_user for one that may run them.

advertiserAccountServiceLevelsstring[]

X Ads services the account uses, such as analytics, media_studio or smb. Empty for an account without ads.

businessProfileStatestring

Whether X treats the profile as a business profile. none or enabled.

subscribersCountinteger

Accounts subscribed to the profile's paid Subscriptions. 0 when it has none.

communityRolestring

Community role when returned by community member reads

profile_bioPublicMetadata

Public metadata whose fields X defines.

Example response

{
  "id": "11348282",
  "username": "NASA",
  "name": "NASA",
  "followers": 92376187,
  "accountBasedIn": null,
  "following": 115,
  "verified": true,
  "isBlueVerified": true,
  "isVerified": true,
  "profilePicture": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg",
  "profilePictureOriginal": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB.jpg",
  "coverPicture": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
  "profileBannerUrl": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
  "description": "Making the seemingly impossible, possible. ✨",
  "location": "Pale Blue Dot",
  "createdAt": "Wed Dec 19 20:20:32 +0000 2007",
  "birthdate": {
    "day": 1,
    "month": 10,
    "year": 1958
  },
  "statusesCount": 74336,
  "mediaCount": 28160,
  "protected": false,
  "url": "http://www.nasa.gov/",
  "contactInfo": {
    "links": [
      {
        "url": "http://www.nasa.gov/",
        "network": "website",
        "source": "url"
      }
    ]
  },
  "favouritesCount": 17003,
  "possiblySensitive": false,
  "verifiedType": "Government",
  "profile_bio": {
    "description": "Making the seemingly impossible, possible. ✨",
    "entities": {
      "description": {},
      "url": {
        "urls": [
          {
            "display_url": "nasa.gov",
            "expanded_url": "http://www.nasa.gov/",
            "indices": [
              0,
              23
            ],
            "url": "https://t.co/9NkQJKAnuU"
          }
        ]
      }
    }
  },
  "businessAccountAffiliatesCount": 85,
  "creatorSubscriptionsCount": 0,
  "hasGraduatedAccess": true,
  "hasHiddenSubscriptionsOnProfile": false,
  "highlightsInfo": {
    "canHighlightTweets": true,
    "highlightedTweets": "280"
  },
  "identityVerification": {
    "isIdentityVerified": false,
    "verifiedSinceMsec": "1249674830941"
  },
  "isProfileTranslatable": false,
  "parodyCommentaryFanLabel": "None",
  "profileDescriptionLanguage": "en",
  "profileImageShape": "Square",
  "profileSortEnabled": true,
  "profileTranslatorType": "regular",
  "superFollowEligible": false,
  "verificationReason": {
    "entities": [
      {
        "fromIndex": 91,
        "toIndex": 101,
        "url": "https://help.twitter.com/en/rules-and-policies/profile-labels",
        "urlType": "ExternalUrl"
      }
    ],
    "text": "This account is verified because it is a government or multilateral organization account.  Learn more"
  }
}

Changes

Oct 20, 202645942c75fdc2 Revision changes
- warning
  added the new topup_in_progress enum value to the ///// response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the /////// response property for the response status

Operation history