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.
/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>"
| Parameter | Description |
|---|---|
idpath · 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.
| Field | Type | Description |
|---|---|---|
id | string | The community id, as a decimal string (it does not fit a JSON number). |
name | string | null | The community's name. null when not stated. |
description | string | null | The community's description. null when empty or not stated. |
createdAt | integer | null | When the community was created, unix seconds. null when not known. |
members | integer | null | How many accounts are members. null when not stated. |
bannerImageUrl | string | null | The community banner's URL. null when not stated. |
creator | object | null | The account that created the community, as the community page shows it. null when not stated. |
creator.username | string | null | The username, without "@", as the account spells it. null when not stated. |
creator.userId | string | null | The account's numeric X id, as a decimal string (it does not fit a JSON number). null when not stated. |
creator.displayName | string | null | The account's display name. null when not stated. |
creator.bio | string | null | The account's bio. null when empty or not stated. |
creator.location | string | null | The location the account states. null when empty or not stated. |
creator.website | string | null | The website the account links. null when empty or not stated. |
creator.followers | integer | null | How many accounts follow it. null when not stated. |
creator.following | integer | null | How many accounts it follows. null when not stated. |
creator.posts | integer | null | How many posts it has made, reposts and replies included. null when not stated. |
creator.createdAt | integer | null | When the account was created, unix seconds. null when not known. |
creator.profileImageUrl | string | null | The creator's profile image URL. null when not stated. |
memberPreview | object[] | The few members X shows on the community page (five at most so far) — a sample, not a member list. |
memberPreview[].userId | string | The member's numeric X id, as a decimal string. |
memberPreview[].avatarUrl | string | null | The 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