Social Fetch
Twitter

List Twitter community tweets

Get tweets from an X community.

GET/v1/twitter/communities/tweets
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
url*stringquery

Community URL to look up.

min 1 chars · max 4096 chars

Response fields
174

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 (`rest_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
integer

Creation time as Unix epoch seconds.

≥ 0

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; null when `trim=true` omits per-tweet author data.

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.

Expanded quoted tweet (one level deep).

datatweets[]quotedTweetid
string

Tweet id (`rest_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
integer

Creation time as Unix epoch seconds.

≥ 0

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; null when `trim=true` omits per-tweet author data.

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.

Expanded reposted tweet (one level deep).

datatweets[]retweetedTweetid
string

Tweet id (`rest_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
integer

Creation time as Unix epoch seconds.

≥ 0

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; null when `trim=true` omits per-tweet author data.

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.

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

Code example

curl "https://api.socialfetch.dev/v1/twitter/communities/tweets?url=https://x.com/elonmusk/status/2044990537145753894" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Tweets for the requested community. Use `data.lookupStatus` to distinguish `found` vs `not_found`. A `found` result may still include an empty `data.tweets` array.

On this page

No Headings