Social API

One X (Twitter) account's profile now

An X account's current profile: name, bio, website, followers, following, post count, creation date, and whether it is suspended or deleted.

GET/api/external/social/social-account/{username}

What it returns

One X (Twitter) account's profile as it stands now: display name, bio, location, website, follower, following and post counts, creation date, profile image, and whether it is suspended or deleted. observedAt says when the figures were read — normally seconds ago, at worst the last stored reading. Not scoped to any chain. A username no tracked account has answers 404.

Chains

This endpoint is not tied to a chain: it takes no chain in its request.

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/social/social-account/<username>"
Parameters
ParameterDescription
username

path · string · required

An X (Twitter) account by its username, with or without the leading "@" (e.g. "solana"), in any case — 1 to 15 letters, digits or underscores. Not a wallet address, and not scoped to any chain.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of One X (Twitter) account's profile now
FieldTypeDescription
usernamestring | nullThe username, without "@", as the account spells it. null when not stated.
userIdstring | nullThe account's numeric X id, as a decimal string (it does not fit a JSON number). null when not stated.
displayNamestring | nullThe account's display name. null when not stated.
biostring | nullThe account's bio. null when empty or not stated.
locationstring | nullThe location the account states. null when empty or not stated.
websitestring | nullThe website the account links. null when empty or not stated.
followersinteger | nullHow many accounts follow it. null when not stated.
followinginteger | nullHow many accounts it follows. null when not stated.
postsinteger | nullHow many posts it has made, reposts and replies included. null when not stated.
createdAtinteger | nullWhen the account was created, unix seconds. null when not known.
observedAtinteger | nullWhen these figures were read, unix seconds. null when not stated.
suspendedboolean | nullWhether X has suspended the account. null when not known.
deletedboolean | nullWhether the account was deleted. null when not known.
profileImageUrlstring | nullThe profile image's URL. null when not stated.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key