Twitter About Profile API - Extended Profile Data

Fetch “about this profile” metadata

Retrieve extended profile context for a Twitter account including professional category, and any linked entities. An account that does not exist is a 404 user_not_found ("No X account with handle @x."), and so is a suspended one (the error says it is suspended); a 404 is final, not retryable, and not billed (2026-11-13; before, it was a retryable 503).

POST /about-profile Profile
https://api.fetchlayer.dev/twitter/about-profile
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

handle string required

Twitter handle without @.

timeoutMs integer optional

Time limit for the whole request, in milliseconds (1000–120000; values outside are brought into that range). It can only shorten the time a request may take, which is about 90 seconds at most. With maxItems, a call that runs out returns the pages it has, billed for those, with hasMore and nextCursor; a call with nothing to return yet fails with a 503 you can retry. We answer at the latest about 2 seconds before timeoutMs runs out (15% of it, at least 0.75 s, for limits under 13 seconds), so you can set it to your own client’s timeout. Left out, the request takes the time it needs.

Response Fields

about-profile

Fetch “about this profile” metadata

scrapedAt string

ISO 8601 time the result was produced.

transport string

The data source: always the platform id, "twitter".

entityType string

Always twitter-about-profile.

profile object | null

The account in full, as user-profile-details returns it.

profile.id string | null

Numeric account id, as a string. It stays the same when the handle changes.

profile.name string | null

Display name.

profile.handle string | null

Handle without the @.

profile.description string | null

Bio text.

profile.location string | null

Location as the account wrote it.

profile.followersCount integer | null

Followers.

profile.followingCount integer | null

Accounts followed.

profile.tweetsCount integer | null

Posts, replies included.

profile.mediaCount integer | null

Posts with media.

profile.verified boolean | null

Whether the account carries a verification checkmark (see verification for which kind).

profile.avatarUrl string | null

Profile image URL.

profile.bannerUrl string | null

Header image URL, or null.

profile.createdAt string | null

When the account was created, as X writes it: "Wed Dec 19 20:20:32 +0000 2007" (UTC).

profile.favoritesCount integer | null

Posts the account has liked.

profile.listedCount integer | null

Lists the account is on. Currently always null: X no longer sends it.

profile.fastFollowersCount integer | null

Currently always null: X no longer sends it. Use followersCount.

profile.normalFollowersCount integer | null

Currently always null: X no longer sends it. Use followersCount.

profile.creatorSubscriptionsCount integer | null

Creator subscriptions the account has, or null when X leaves it out.

profile.pinnedTweetIds string[]

Ids of the pinned posts; empty when none.

profile.website object | null

The website link on the profile; null when there is none.

profile.website.url string | null

The t.co short link.

profile.website.expandedUrl string | null

The full address it leads to.

profile.website.displayUrl string | null

The shortened form X displays, e.g. nasa.gov.

profile.descriptionUrls object[]

Links in the bio, expanded; empty when none.

profile.descriptionUrls[].url string | null

The t.co short link.

profile.descriptionUrls[].expandedUrl string | null

The full address it leads to.

profile.descriptionUrls[].displayUrl string | null

The shortened form X displays, e.g. nasa.gov.

profile.avatarUrlLarge string | null

The profile image at 400x400.

profile.verifiedType string | null

The kind of verification, e.g. Business or Government; null for none.

profile.protected boolean | null

True when the account’s posts are visible to its followers only.

profile.profileLabel object | null

The affiliation badge shown next to the name (e.g. an organisation’s); null when there is none.

profile.profileLabel.description string | null

The badge’s label, e.g. the organisation’s name.

profile.profileLabel.badgeUrl string | null

The badge image.

profile.profileLabel.url string | null

Where the badge links to.

profile.profileLabel.urlType string | null

X’s link type, e.g. DeepLink.

profile.profileLabel.displayType string | null

How X shows it, e.g. Badge.

profile.profileLabel.type string | null

X’s label type, e.g. BusinessLabel.

profile.verification object

Which verification the account has.

profile.verification.blue boolean | null

Verified through a subscription (the blue checkmark).

profile.verification.verified boolean | null

Verified by X as notable (legacy verification).

profile.verification.identityVerified boolean | null

The account holder’s identity was verified; null when X does not say.

profile.verification.reason string | null

X’s own explanation of the checkmark, e.g. for a government account; null when it gives none.

aboutProfile object | null

X’s “About this account” panel; null when X shows none.

aboutProfile.accountBasedIn string | null

The country X says the account is based in.

aboutProfile.locationAccurate boolean | null

Whether X considers that location accurate.

aboutProfile.createdCountryAccurate boolean | null

Whether X considers the country the account was created in accurate.

aboutProfile.source string | null

How the account connected to X, as the panel says (e.g. an app store).

aboutProfile.affiliateUsername string | null

The organisation the account is affiliated with, when it has one.

aboutProfile.usernameChanges object | null

How often the handle has changed.

aboutProfile.usernameChanges.count integer | null

Number of handle changes.

aboutProfile.usernameChanges.lastChangedAtMsec string | null

When the handle last changed, in milliseconds since the epoch (as a string); null when it never has.

aboutProfile.learnMoreUrl string | null

X’s page explaining the panel.

Request

curl -X POST "https://api.fetchlayer.dev/twitter/about-profile" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"handle":"NASA"}'

Response

{
  "entityType": "twitter-about-profile",
  "profile": {
    "id": "11348282",
    "name": "NASA",
    "handle": "NASA",
    "followersCount": 92312272,
    "verified": true
  },
  "aboutProfile": {
    "accountBasedIn": "United States",
    "locationAccurate": true,
    "createdCountryAccurate": true,
    "source": null,
    "affiliateUsername": null,
    "usernameChanges": {
      "count": 0,
      "lastChangedAtMsec": null
    },
    "learnMoreUrl": "https://help.x.com/managing-your-account/about-twitter-verified-accounts"
  },
  "scrapedAt": "2026-10-25T19:15:00.000Z",
  "transport": "twitter"
}
Product overview Twitter API: what it returns, pricing and use cases