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.
/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>"
| Parameter | Description |
|---|---|
usernamepath · 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.
| Field | Type | Description |
|---|---|---|
username | string | null | The username, without "@", as the account spells it. null when not stated. |
userId | string | null | The account's numeric X id, as a decimal string (it does not fit a JSON number). null when not stated. |
displayName | string | null | The account's display name. null when not stated. |
bio | string | null | The account's bio. null when empty or not stated. |
location | string | null | The location the account states. null when empty or not stated. |
website | string | null | The website the account links. null when empty or not stated. |
followers | integer | null | How many accounts follow it. null when not stated. |
following | integer | null | How many accounts it follows. null when not stated. |
posts | integer | null | How many posts it has made, reposts and replies included. null when not stated. |
createdAt | integer | null | When the account was created, unix seconds. null when not known. |
observedAt | integer | null | When these figures were read, unix seconds. null when not stated. |
suspended | boolean | null | Whether X has suspended the account. null when not known. |
deleted | boolean | null | Whether the account was deleted. null when not known. |
profileImageUrl | string | null | The 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