Social API

One X (Twitter) community: name, members and creator

An X community by id: name, description, creation date, member count and the account that created it.

GET/api/external/social/social-community/{id}

What it returns

One X (Twitter) community by id: its name, description, creation date, member count, banner, the account that created it and the few members X shows on its page. The rules a community sets are not included. Not scoped to any chain. An id that names no community — deleted, or never existed — 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-community/<id>"
Parameters
ParameterDescription
id

path · string · required

One X (Twitter) community by its id (e.g. "2004692038084944260") — the decimal number at the end of the community's link, x.com/i/communities/<id>. Not an account username or a post id.

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) community: name, members and creator
FieldTypeDescription
idstringThe community id, as a decimal string (it does not fit a JSON number).
namestring | nullThe community's name. null when not stated.
descriptionstring | nullThe community's description. null when empty or not stated.
createdAtinteger | nullWhen the community was created, unix seconds. null when not known.
membersinteger | nullHow many accounts are members. null when not stated.
bannerImageUrlstring | nullThe community banner's URL. null when not stated.
creatorobject | nullThe account that created the community, as the community page shows it. null when not stated.
creator.usernamestring | nullThe username, without "@", as the account spells it. null when not stated.
creator.userIdstring | nullThe account's numeric X id, as a decimal string (it does not fit a JSON number). null when not stated.
creator.displayNamestring | nullThe account's display name. null when not stated.
creator.biostring | nullThe account's bio. null when empty or not stated.
creator.locationstring | nullThe location the account states. null when empty or not stated.
creator.websitestring | nullThe website the account links. null when empty or not stated.
creator.followersinteger | nullHow many accounts follow it. null when not stated.
creator.followinginteger | nullHow many accounts it follows. null when not stated.
creator.postsinteger | nullHow many posts it has made, reposts and replies included. null when not stated.
creator.createdAtinteger | nullWhen the account was created, unix seconds. null when not known.
creator.profileImageUrlstring | nullThe creator's profile image URL. null when not stated.
memberPreviewobject[]The few members X shows on the community page (five at most so far) — a sample, not a member list.
memberPreview[].userIdstringThe member's numeric X id, as a decimal string.
memberPreview[].avatarUrlstring | nullThe member's avatar 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