Social Fetch
Twitter

Get Twitter community

Returns metadata for a single X community by URL.

Operation

GET/v1/twitter/communities
Cost: 1 credit

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

urlstringrequired(query)

Community URL to look up.

min 1 chars · max 4096 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether the community was found or not found.

one of: found, not_found

datacommunity
objectrequirednullable

Community details when available.

datacommunityplatform
stringrequired

Social platform for this community.

one of: twitter

datacommunityid
stringrequired

Numeric community identifier as a string.

min 1 chars

datacommunityurl
stringrequired

Canonical public community URL on x.com.

min 1 chars

datacommunityname
stringrequired

Community display name.

min 1 chars

datacommunitydescription
stringrequirednullable

Short description text when available.

datacommunitycreatedAt
integerrequired

Creation time as Unix epoch milliseconds.

≥ 0

datacommunitymemberCount
integerrequired

Approximate member count.

≥ 0

datacommunityisNsfw
booleanrequired

Whether the community is marked as sensitive.

datacommunityjoinPolicy
stringrequired

Who can join this community.

one of: open, restricted

datacommunityprimaryTopic
stringrequirednullable

Primary topic label when available.

datacommunitybannerImageUrl
stringrequirednullable

Banner image URL when available.

datacommunitycreator
objectrequirednullable

Creator handle and verification flags when available.

datacommunitycreatorhandle
stringrequired

Creator screen name without the leading @.

min 1 chars

datacommunitycreatorverified
booleanrequired

Whether X marks the creator with legacy verification.

datacommunitycreatorblueVerified
booleanrequired

Whether the creator has X blue (paid) verification.

datacommunityrules
arrayrequired

Published community rules.

datacommunityrules[]id
stringrequired

Stable rule identifier.

min 1 chars

datacommunityrules[]name
stringrequired

Short rule title.

min 1 chars

datacommunityrules[]description
stringrequirednullable

Longer rule explanation when provided.

datacommunitymemberFacepileAvatarUrls
arrayrequired

Recent member avatar image URLs shown in the community preview.

datacommunitymemberFacepileAvatarUrls[]
string

min 1 chars

datacommunitytrendingHashtags
arrayrequired

Trending hashtags associated with this community when available.

datacommunitytrendingHashtags[]
string

min 1 chars

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Community details when available. Check `data.lookupStatus` for `found` vs `not_found`.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page