Social Fetch
Dashboard
Twitter

List Twitter community tweets

List tweets from an X community by community id or URL.

Try in Playground
GET/v1/twitter/communities/tweets
1credit

Headers

Get your API key
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
urlstringrequiredquery

Community permalink or numeric id.

min 1 chars · max 4096 chars

cursorstringoptionalquery

Opaque pagination cursor returned by a previous response.

min 1 chars

sortBystringoptionalquery

Community tweet sort order. Defaults to `relevance`.

one of: relevance, recency

Response fields
193

Endpoint-specific response payload.

datalookupStatus
string

Whether tweet data was returned for this community.

one of: found, not_found

Tweets returned for the requested community. This array may be empty when `lookupStatus` is `found` and no tweets are returned in this response, or when `lookupStatus` is `not_found`.

datatweets[]id
string

Tweet id.

min 1 chars

datatweets[]url
string

Canonical public URL for this tweet on x.com.

min 1 chars

datatweets[]conversationId
string

Conversation root tweet id.

min 1 chars

datatweets[]createdAt
string

Creation time (ISO-8601).

datatweets[]language
string

BCP 47 or X language code.

min 1 chars

datatweets[]text
string

Full tweet text (includes long-form when available).

datatweets[]isLongForm
boolean

True when text was taken from note_tweet metadata instead of legacy.full_text alone.

Start/end character indices for visible text.

datatweets[]displayTextRange[]
integeroptional

≥ 0

Author snapshot when available.

datatweets[]authorhandle
string

Author screen name without the leading @.

min 1 chars

datatweets[]authordisplayName
stringnullable

Author display name.

datatweets[]authoravatarUrl
stringnullable

Best available square avatar URL for the author.

datatweets[]authorverified
boolean

Whether X marks the author with legacy verification.

datatweets[]authorblueVerified
boolean

Whether the author has X blue (paid) verification.

datatweets[]authorplatformUserId
stringoptional

Numeric X user id for the author as a string.

Engagement metrics for a tweet.

datatweets[]metricsviews
integer

Impression count when reported by X.

≥ 0

datatweets[]metricsfavorites
integer

Favorite (like) count.

≥ 0

datatweets[]metricsretweets
integer

Native repost count.

≥ 0

datatweets[]metricsreplies
integer

Reply count.

≥ 0

datatweets[]metricsbookmarks
integer

Bookmark count.

≥ 0

datatweets[]metricsquotes
integer

Quote tweet count.

≥ 0

Photo, video, or GIF attachments.

datatweets[]media[]
optional

Entities aligned with `text`.

Hashtag entities.

datatweets[]entitieshashtags[]text
string

Hashtag text without #.

User mention entities.

datatweets[]entitiesuserMentions[]handle
string

Mentioned screen name.

min 1 chars

datatweets[]entitiesuserMentions[]displayName
stringoptional

Display name when available.

datatweets[]entitiesuserMentions[]platformUserId
stringoptional

Numeric user id for the mention when available.

URL entities.

datatweets[]entitiesurls[]url
string

Short URL as it appears in text.

min 1 chars

datatweets[]entitiesurls[]displayUrl
string

Human-readable display host/path.

min 1 chars

datatweets[]entitiesurls[]expandedUrl
string

Fully expanded destination URL.

min 1 chars

Symbol entities.

datatweets[]entitiessymbols[]text
string

Cashtag or symbol text.

min 1 chars

datatweets[]isReply
boolean

Whether this is a reply.

datatweets[]inReplyToTweetId
stringoptional

Parent tweet id when replying.

datatweets[]inReplyToUserId
stringoptional

Parent author user id when replying.

datatweets[]inReplyToScreenName
stringoptional

Parent author handle when replying.

datatweets[]isQuote
boolean

Whether this tweet quotes another.

datatweets[]quotedTweetId
stringoptional

Quoted tweet id when present.

datatweets[]isRetweet
boolean

Whether this is a native repost.

datatweets[]retweetedTweetId
stringoptional

Original tweet id for a repost.

datatweets[]possiblySensitive
boolean

Whether X marks the content sensitive.

Edit metadata when applicable.

Tweet ids in this edit chain.

datatweets[]editInfoeditTweetIds[]
stringoptional

min 1 chars

datatweets[]editInfoeditableUntilMsec
string

Epoch milliseconds until edits are locked.

datatweets[]editInfoisEditEligible
boolean

Whether the tweet can still be edited.

datatweets[]editInfoeditsRemaining
string

Remaining edits in the window, as reported by X.

datatweets[]source
stringoptional

Client label text.

datatweets[]sourceUrl
stringoptional

Link target from the source anchor when present.

datatweets[]communityId
stringnullableoptional

Community id when the tweet was posted to a community.

datatweets[]hasAIGeneratedMedia
booleannullableoptional

Whether X marks the tweet as containing AI-generated media.

datatweets[]isPaidPromotion
booleannullableoptional

Whether X marks the tweet as a paid promotion.

datatweets[]isTranslatable
booleannullableoptional

Whether X considers the tweet text translatable.

datatweets[]hasBirdwatchNotes
booleannullableoptional

Whether Community Notes are attached to this tweet.

Expanded quoted tweet (one level deep).

datatweets[]quotedTweetid
string

Tweet id.

min 1 chars

datatweets[]quotedTweeturl
string

Canonical public URL for this tweet on x.com.

min 1 chars

datatweets[]quotedTweetconversationId
string

Conversation root tweet id.

min 1 chars

datatweets[]quotedTweetcreatedAt
string

Creation time (ISO-8601).

datatweets[]quotedTweetlanguage
string

BCP 47 or X language code.

min 1 chars

datatweets[]quotedTweettext
string

Full tweet text (includes long-form when available).

datatweets[]quotedTweetisLongForm
boolean

True when text was taken from note_tweet metadata instead of legacy.full_text alone.

Start/end character indices for visible text.

datatweets[]quotedTweetdisplayTextRange[]
integeroptional

≥ 0

Author snapshot when available.

datatweets[]quotedTweetauthorhandle
string

Author screen name without the leading @.

min 1 chars

datatweets[]quotedTweetauthordisplayName
stringnullable

Author display name.

datatweets[]quotedTweetauthoravatarUrl
stringnullable

Best available square avatar URL for the author.

datatweets[]quotedTweetauthorverified
boolean

Whether X marks the author with legacy verification.

datatweets[]quotedTweetauthorblueVerified
boolean

Whether the author has X blue (paid) verification.

datatweets[]quotedTweetauthorplatformUserId
stringoptional

Numeric X user id for the author as a string.

Engagement metrics for a tweet.

datatweets[]quotedTweetmetricsviews
integer

Impression count when reported by X.

≥ 0

datatweets[]quotedTweetmetricsfavorites
integer

Favorite (like) count.

≥ 0

datatweets[]quotedTweetmetricsretweets
integer

Native repost count.

≥ 0

datatweets[]quotedTweetmetricsreplies
integer

Reply count.

≥ 0

datatweets[]quotedTweetmetricsbookmarks
integer

Bookmark count.

≥ 0

datatweets[]quotedTweetmetricsquotes
integer

Quote tweet count.

≥ 0

Photo, video, or GIF attachments.

datatweets[]quotedTweetmedia[]
optional

Entities aligned with `text`.

Hashtag entities.

datatweets[]quotedTweetentitieshashtags[]text
string

Hashtag text without #.

User mention entities.

datatweets[]quotedTweetentitiesuserMentions[]handle
string

Mentioned screen name.

min 1 chars

datatweets[]quotedTweetentitiesuserMentions[]displayName
stringoptional

Display name when available.

datatweets[]quotedTweetentitiesuserMentions[]platformUserId
stringoptional

Numeric user id for the mention when available.

URL entities.

datatweets[]quotedTweetentitiesurls[]url
string

Short URL as it appears in text.

min 1 chars

datatweets[]quotedTweetentitiesurls[]displayUrl
string

Human-readable display host/path.

min 1 chars

datatweets[]quotedTweetentitiesurls[]expandedUrl
string

Fully expanded destination URL.

min 1 chars

Symbol entities.

datatweets[]quotedTweetentitiessymbols[]text
string

Cashtag or symbol text.

min 1 chars

datatweets[]quotedTweetisReply
boolean

Whether this is a reply.

datatweets[]quotedTweetinReplyToTweetId
stringoptional

Parent tweet id when replying.

datatweets[]quotedTweetinReplyToUserId
stringoptional

Parent author user id when replying.

datatweets[]quotedTweetinReplyToScreenName
stringoptional

Parent author handle when replying.

datatweets[]quotedTweetisQuote
boolean

Whether this tweet quotes another.

datatweets[]quotedTweetquotedTweetId
stringoptional

Quoted tweet id when present.

datatweets[]quotedTweetisRetweet
boolean

Whether this is a native repost.

datatweets[]quotedTweetretweetedTweetId
stringoptional

Original tweet id for a repost.

datatweets[]quotedTweetpossiblySensitive
boolean

Whether X marks the content sensitive.

Edit metadata when applicable.

Tweet ids in this edit chain.

datatweets[]quotedTweeteditInfoeditTweetIds[]
stringoptional

min 1 chars

datatweets[]quotedTweeteditInfoeditableUntilMsec
string

Epoch milliseconds until edits are locked.

datatweets[]quotedTweeteditInfoisEditEligible
boolean

Whether the tweet can still be edited.

datatweets[]quotedTweeteditInfoeditsRemaining
string

Remaining edits in the window, as reported by X.

datatweets[]quotedTweetsource
stringoptional

Client label text.

datatweets[]quotedTweetsourceUrl
stringoptional

Link target from the source anchor when present.

datatweets[]quotedTweetcommunityId
stringnullableoptional

Community id when the tweet was posted to a community.

datatweets[]quotedTweethasAIGeneratedMedia
booleannullableoptional

Whether X marks the tweet as containing AI-generated media.

datatweets[]quotedTweetisPaidPromotion
booleannullableoptional

Whether X marks the tweet as a paid promotion.

datatweets[]quotedTweetisTranslatable
booleannullableoptional

Whether X considers the tweet text translatable.

datatweets[]quotedTweethasBirdwatchNotes
booleannullableoptional

Whether Community Notes are attached to this tweet.

Expanded reposted tweet (one level deep).

datatweets[]retweetedTweetid
string

Tweet id.

min 1 chars

datatweets[]retweetedTweeturl
string

Canonical public URL for this tweet on x.com.

min 1 chars

datatweets[]retweetedTweetconversationId
string

Conversation root tweet id.

min 1 chars

datatweets[]retweetedTweetcreatedAt
string

Creation time (ISO-8601).

datatweets[]retweetedTweetlanguage
string

BCP 47 or X language code.

min 1 chars

datatweets[]retweetedTweettext
string

Full tweet text (includes long-form when available).

datatweets[]retweetedTweetisLongForm
boolean

True when text was taken from note_tweet metadata instead of legacy.full_text alone.

Start/end character indices for visible text.

datatweets[]retweetedTweetdisplayTextRange[]
integeroptional

≥ 0

Author snapshot when available.

datatweets[]retweetedTweetauthorhandle
string

Author screen name without the leading @.

min 1 chars

datatweets[]retweetedTweetauthordisplayName
stringnullable

Author display name.

datatweets[]retweetedTweetauthoravatarUrl
stringnullable

Best available square avatar URL for the author.

datatweets[]retweetedTweetauthorverified
boolean

Whether X marks the author with legacy verification.

datatweets[]retweetedTweetauthorblueVerified
boolean

Whether the author has X blue (paid) verification.

datatweets[]retweetedTweetauthorplatformUserId
stringoptional

Numeric X user id for the author as a string.

Engagement metrics for a tweet.

datatweets[]retweetedTweetmetricsviews
integer

Impression count when reported by X.

≥ 0

datatweets[]retweetedTweetmetricsfavorites
integer

Favorite (like) count.

≥ 0

datatweets[]retweetedTweetmetricsretweets
integer

Native repost count.

≥ 0

datatweets[]retweetedTweetmetricsreplies
integer

Reply count.

≥ 0

datatweets[]retweetedTweetmetricsbookmarks
integer

Bookmark count.

≥ 0

datatweets[]retweetedTweetmetricsquotes
integer

Quote tweet count.

≥ 0

Photo, video, or GIF attachments.

datatweets[]retweetedTweetmedia[]
optional

Entities aligned with `text`.

Hashtag entities.

datatweets[]retweetedTweetentitieshashtags[]text
string

Hashtag text without #.

User mention entities.

datatweets[]retweetedTweetentitiesuserMentions[]handle
string

Mentioned screen name.

min 1 chars

datatweets[]retweetedTweetentitiesuserMentions[]displayName
stringoptional

Display name when available.

datatweets[]retweetedTweetentitiesuserMentions[]platformUserId
stringoptional

Numeric user id for the mention when available.

URL entities.

datatweets[]retweetedTweetentitiesurls[]url
string

Short URL as it appears in text.

min 1 chars

datatweets[]retweetedTweetentitiesurls[]displayUrl
string

Human-readable display host/path.

min 1 chars

datatweets[]retweetedTweetentitiesurls[]expandedUrl
string

Fully expanded destination URL.

min 1 chars

Symbol entities.

datatweets[]retweetedTweetentitiessymbols[]text
string

Cashtag or symbol text.

min 1 chars

datatweets[]retweetedTweetisReply
boolean

Whether this is a reply.

datatweets[]retweetedTweetinReplyToTweetId
stringoptional

Parent tweet id when replying.

datatweets[]retweetedTweetinReplyToUserId
stringoptional

Parent author user id when replying.

datatweets[]retweetedTweetinReplyToScreenName
stringoptional

Parent author handle when replying.

datatweets[]retweetedTweetisQuote
boolean

Whether this tweet quotes another.

datatweets[]retweetedTweetquotedTweetId
stringoptional

Quoted tweet id when present.

datatweets[]retweetedTweetisRetweet
boolean

Whether this is a native repost.

datatweets[]retweetedTweetretweetedTweetId
stringoptional

Original tweet id for a repost.

datatweets[]retweetedTweetpossiblySensitive
boolean

Whether X marks the content sensitive.

Edit metadata when applicable.

Tweet ids in this edit chain.

datatweets[]retweetedTweeteditInfoeditTweetIds[]
stringoptional

min 1 chars

datatweets[]retweetedTweeteditInfoeditableUntilMsec
string

Epoch milliseconds until edits are locked.

datatweets[]retweetedTweeteditInfoisEditEligible
boolean

Whether the tweet can still be edited.

datatweets[]retweetedTweeteditInfoeditsRemaining
string

Remaining edits in the window, as reported by X.

datatweets[]retweetedTweetsource
stringoptional

Client label text.

datatweets[]retweetedTweetsourceUrl
stringoptional

Link target from the source anchor when present.

datatweets[]retweetedTweetcommunityId
stringnullableoptional

Community id when the tweet was posted to a community.

datatweets[]retweetedTweethasAIGeneratedMedia
booleannullableoptional

Whether X marks the tweet as containing AI-generated media.

datatweets[]retweetedTweetisPaidPromotion
booleannullableoptional

Whether X marks the tweet as a paid promotion.

datatweets[]retweetedTweetisTranslatable
booleannullableoptional

Whether X considers the tweet text translatable.

datatweets[]retweetedTweethasBirdwatchNotes
booleannullableoptional

Whether Community Notes are attached to this tweet.

Cursor pagination for this community tweet list.

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/tweets?url=https://x.com/i/communities/1733520006279815231" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Tweets for the requested community.

Community

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

Community members

List members of an X community by community URL or id.