Social API
One X (Twitter) account's profile and follower count over time
Snapshots of an X account's profile and its follower, following and post counts, newest first: how it grew, and when its name, bio or website changed.
/api/external/social/social-account-history/{username}What it returns
Snapshots of one X (Twitter) account's profile — display name, bio, location, website and the follower, following and post counts — newest first, up to 500 a page, about one a day, so the counts trace its growth over months. Follow nextPage for older ones. 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-history/<username>"
| Parameter | Description |
|---|---|
pagequery · integer · optional | Which page, from 1 (the newest) to 1000. Defaults to 1. Follow nextPage for the next one. |
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 | The username asked about, without "@". |
snapshots | object[] | Newest first. |
snapshots[].username | string | null | The username, without "@", as the account spells it. null when not stated. |
snapshots[].userId | string | null | The account's numeric X id, as a decimal string (it does not fit a JSON number). null when not stated. |
snapshots[].displayName | string | null | The account's display name. null when not stated. |
snapshots[].bio | string | null | The account's bio. null when empty or not stated. |
snapshots[].location | string | null | The location the account states. null when empty or not stated. |
snapshots[].website | string | null | The website the account links. null when empty or not stated. |
snapshots[].followers | integer | null | How many accounts follow it. null when not stated. |
snapshots[].following | integer | null | How many accounts it follows. null when not stated. |
snapshots[].posts | integer | null | How many posts it has made, reposts and replies included. null when not stated. |
snapshots[].observedAt | integer | null | When these figures were read, unix seconds. null when not stated. |
nextPage | integer | null | The page to ask for next. null on the last page. |
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