Search Twitter communities

Search X communities by keyword.

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

API key (`sfk_...`)

Parameters
2
querystringrequiredquery

Search query for X (Twitter) communities.

min 1 chars · max 200 chars

cursorstringoptionalquery

Opaque pagination cursor returned by a previous response.

min 1 chars

Response fields
20

Endpoint-specific response payload.

Communities matching the requested query.

datacommunities[]id
string

Numeric community identifier as a string.

min 1 chars

datacommunities[]name
string

Community display name.

min 1 chars

datacommunities[]memberCount
integernullable

Approximate member count when available.

≥ 0

datacommunities[]topic
stringnullable

Primary topic label when available.

datacommunities[]isNsfw
boolean

Whether the community is marked as sensitive.

datacommunities[]bannerUrl
stringnullable

Banner image URL when available.

datacommunities[]url
string

Canonical public community URL on x.com.

min 1 chars

datacommunities[]defaultBannerUrl
stringnullableoptional

Fallback banner image URL when X provides one.

Member avatar URLs shown in the community search preview.

datacommunities[]membersFacepile[]
stringoptional

min 1 chars

Pagination information for the current response.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

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/search?query=programming" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Community search results.