Get Twitter account transparency details

Get X account transparency details (location, verification, username history) by handle or numeric user id.

GET/v1/twitter/profiles/{handle}/about
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
handlestringrequiredpath

X (Twitter) profile handle without the leading @, or a numeric user id.

bystringoptionalquery

Treat the path value as a handle or a numeric user id. Defaults to id when the value is all digits.

one of: id, handle

Response fields
32

Endpoint-specific response payload.

datalookupStatus
string

Whether the account was found.

one of: found, not_found

Account transparency details when found.

dataaboutid
stringnullable

Numeric X user id as a string.

dataaboutusername
stringnullable

X screen name (handle) without the leading @.

dataaboutname
stringnullable

Display name shown on the profile.

dataaboutcreatedAt
stringnullable

Account creation time as returned by X (raw upstream string). Prefer `accountCreatedAt` for ISO-8601.

dataaboutaccountCreatedAt
stringoptional

Account creation time (ISO-8601) when derivable.

dataaboutverified
booleannullable

Whether X marks the account with legacy verification (not necessarily paid blue).

dataaboutisBlueVerified
booleannullable

Whether the account has X blue (paid) verification.

dataaboutisProtected
booleannullable

Whether the account is protected (private).

dataaboutavatarUrl
stringnullable

Best available square avatar image URL.

dataaboutprofileImageShape
stringnullable

Avatar crop shape reported by X, such as Circle or Square.

dataaboutverifiedSince
stringnullable

When X verification became effective (ISO-8601). Invalid upstream dates are null.

Affiliate or organization relationship when present.

dataaboutaffiliateusername
stringnullable

Affiliate organization username.

dataaboutaffiliatedescription
stringnullable

Affiliate label text shown on the profile.

dataaboutaffiliatebadgeUrl
stringnullable

Affiliate badge image URL.

Transparency payload (location, source, username history).

dataaboutaboutProfileaccountBasedIn
stringnullable

Country or region X associates with the account.

dataaboutaboutProfilelocationAccurate
booleannullable

Whether X considers the location signal accurate.

dataaboutaboutProfilelearnMoreUrl
stringnullable

Help URL explaining X account transparency or verification.

dataaboutaboutProfileaffiliateUsername
stringnullable

Affiliate organization username when X shows one.

dataaboutaboutProfilesource
stringnullable

Account creation source, such as an app store locale.

Username-change history when X provides it.

dataaboutaboutProfileusernameChangescount
integernullable

Number of username changes X reports for this account.

≥ 0

dataaboutaboutProfileusernameChangeslastChangedAt
stringnullable

When the username last changed (ISO-8601), when X reports a timestamp.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/twitter/profiles/nasa/about" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Twitter account transparency details.