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).
/about-profile Profile https://api.fetchlayer.dev/twitter/about-profile 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"
}