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.

GET/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>"
Parameters
ParameterDescription
page

query · integer · optional

Which page, from 1 (the newest) to 1000. Defaults to 1. Follow nextPage for the next one.
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 and follower count over time
FieldTypeDescription
usernamestringThe username asked about, without "@".
snapshotsobject[]Newest first.
snapshots[].usernamestring | nullThe username, without "@", as the account spells it. null when not stated.
snapshots[].userIdstring | nullThe account's numeric X id, as a decimal string (it does not fit a JSON number). null when not stated.
snapshots[].displayNamestring | nullThe account's display name. null when not stated.
snapshots[].biostring | nullThe account's bio. null when empty or not stated.
snapshots[].locationstring | nullThe location the account states. null when empty or not stated.
snapshots[].websitestring | nullThe website the account links. null when empty or not stated.
snapshots[].followersinteger | nullHow many accounts follow it. null when not stated.
snapshots[].followinginteger | nullHow many accounts it follows. null when not stated.
snapshots[].postsinteger | nullHow many posts it has made, reposts and replies included. null when not stated.
snapshots[].observedAtinteger | nullWhen these figures were read, unix seconds. null when not stated.
nextPageinteger | nullThe 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