Get Twitter community

Get details for an X community by community id or URL.

GET/v1/twitter/communities
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
urlstringrequiredquery

Community permalink or numeric id.

min 1 chars · max 4096 chars

Response fields
43

Endpoint-specific response payload.

datalookupStatus
string

Whether the community was found.

one of: found, not_found

Community details when available.

datacommunityplatform
string

Social platform for this community.

one of: twitter

datacommunityid
string

Numeric community identifier as a string.

min 1 chars

datacommunityurl
string

Canonical public community URL on x.com.

min 1 chars

datacommunityname
string

Community display name.

min 1 chars

datacommunitydescription
stringnullable

Short description text when available.

datacommunitycreatedAt
string

Creation time (ISO-8601).

datacommunitymemberCount
integer

Approximate member count.

≥ 0

datacommunityisNsfw
booleannullable

Whether the community is marked as sensitive. Null when X does not report it on this payload.

datacommunityjoinPolicy
string

Who can join this community.

one of: open, restricted

datacommunityprimaryTopic
stringnullable

Primary topic label when available.

datacommunitybannerImageUrl
stringnullable

Banner image URL when available.

Creator handle and verification flags when available.

datacommunitycreatorhandle
string

Creator screen name without the leading @.

min 1 chars

datacommunitycreatorverified
boolean

Whether X marks the creator with legacy verification.

datacommunitycreatorblueVerified
boolean

Whether the creator has X blue (paid) verification.

Published community rules.

datacommunityrules[]id
string

Stable rule identifier.

min 1 chars

datacommunityrules[]name
string

Short rule title.

min 1 chars

datacommunityrules[]description
stringnullable

Longer rule explanation when provided.

datacommunityrules[]order
integernullableoptional

Display order of the rule when X provides one.

≥ 0

datacommunityrules[]createdAt
stringnullableoptional

When the rule was created (ISO-8601 or the raw timestamp from X). Empty values are null.

Recent member avatar image URLs shown in the community preview.

datacommunitymemberFacepileAvatarUrls[]
stringoptional

min 1 chars

Trending hashtags associated with this community when available.

datacommunitytrendingHashtags[]
stringoptional

min 1 chars

datacommunityavatarUrl
stringnullable

Community avatar image URL when available.

datacommunitymoderatorCount
integernullable

Approximate moderator count when available.

≥ 0

datacommunityadminCount
integernullable

Approximate admin count when available.

≥ 0

datacommunitypinnedTweetId
stringnullable

Pinned tweet identifier when the community has one.

datacommunityisMember
booleannullableoptional

Whether the requesting viewer is a member of this community.

datacommunityisModerator
booleannullableoptional

Whether the requesting viewer is a moderator of this community.

datacommunityisAdmin
booleannullableoptional

Whether the requesting viewer is an admin of this community.

datacommunityisBanned
booleannullableoptional

Whether the requesting viewer is banned from this community.

datacommunitycanPost
booleannullableoptional

Whether the requesting viewer can post in this community.

datacommunityjoinRequestsEnabled
booleannullableoptional

Whether this community accepts join requests.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/twitter/communities?url=https://x.com/i/communities/1733520006279815231" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Community details.