List Twitter community tweets List tweets from an X community by community id or URL.
GET /v1/twitter/communities/tweets
x-api-key* string header
API key (`sfk_...`)
url* string required query
Community permalink or numeric id.
min 1 chars · max 4096 chars
cursor string optional query
Opaque pagination cursor returned by a previous response.
min 1 chars
sortBy string optional query
Community tweet sort order. Defaults to `relevance`.
one of: relevance, recency
Response fields 551 Expand all Collapse all Collapse all Endpoint-specific response payload.
Whether tweet data was returned for this community.
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`.
Canonical public URL for this tweet on x.com.
data . tweets [] . conversationId
string
Conversation root tweet id.
data . tweets [] . createdAt
string
Creation time (ISO-8601).
data . tweets [] . language
string
BCP 47 or X language code.
Full tweet text (includes long-form when available).
data . tweets [] . isLongForm
boolean
True when text was taken from note_tweet metadata instead of legacy.full_text alone.
data . tweets [] . displayTextRange array
Start/end character indices for visible text.
data . tweets [] . displayTextRange []
integer optional
Author snapshot when available.
data . tweets [] . author . handle
string
Author screen name without the leading @.
data . tweets [] . author . displayName
string nullable
Author display name.
data . tweets [] . author . avatarUrl
string nullable
Best available square avatar URL for the author.
data . tweets [] . author . verified
boolean
Whether X marks the author with legacy verification.
data . tweets [] . author . blueVerified
boolean
Whether the author has X blue (paid) verification.
data . tweets [] . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . tweets [] . author . bio
string nullable optional
Author profile bio when available.
data . tweets [] . author . location
string nullable optional
Location string from the author profile when provided.
data . tweets [] . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . tweets [] . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . tweets [] . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . tweets [] . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . tweets [] . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . tweets [] . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . tweets [] . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . tweets [] . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . tweets [] . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . tweets [] . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . tweets [] . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . tweets [] . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . tweets [] . author . professional . type
string nullable
Professional account type from X, when present.
data . tweets [] . author . professional . category array nullable
Professional categories X shows on the profile.
data . tweets [] . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . tweets [] . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . tweets [] . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . tweets [] . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . tweets [] . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . tweets [] . author . metrics . availableFields array optional
Metrics actually reported; an unavailable legacy numeric value must not be treated as an observation.
any of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount (comma-separated)
data . tweets [] . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . tweets [] . author . metrics . followers
integer
Follower count from X.
data . tweets [] . author . metrics . following
integer
Following (friends) count from X.
data . tweets [] . author . metrics . tweets
integer
Total post (status) count from X.
data . tweets [] . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . tweets [] . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . tweets [] . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . tweets [] . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
Engagement metrics for a tweet.
data . tweets [] . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: views, favorites, retweets, replies, bookmarks, quotes (comma-separated)
data . tweets [] . metrics . availableFields []
string optional
one of: views, favorites, retweets, replies, bookmarks, quotes
data . tweets [] . metrics . views
integer
Impression count when reported by X.
data . tweets [] . metrics . favorites
integer
Favorite (like) count.
data . tweets [] . metrics . retweets
integer
Native repost count.
data . tweets [] . metrics . replies
integer
Reply count.
data . tweets [] . metrics . bookmarks
integer
Bookmark count.
data . tweets [] . metrics . quotes
integer
Quote tweet count.
Photo, video, or GIF attachments.
data . tweets [] . media []
optional
Entities aligned with `text`.
data . tweets [] . entities . hashtags array
Hashtag entities.
data . tweets [] . entities . hashtags [] . text
string
Hashtag text without #.
data . tweets [] . entities . userMentions array
User mention entities.
data . tweets [] . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweets [] . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweets [] . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweets [] . entities . urls array
URL entities.
data . tweets [] . entities . urls [] . url
string
Short URL as it appears in text.
data . tweets [] . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweets [] . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweets [] . entities . symbols array
Symbol entities.
data . tweets [] . entities . symbols [] . text
string
Cashtag or symbol text.
data . tweets [] . isReply
boolean
Whether this is a reply.
data . tweets [] . inReplyToTweetId
string optional
Parent tweet id when replying.
data . tweets [] . inReplyToUserId
string optional
Parent author user id when replying.
data . tweets [] . inReplyToScreenName
string optional
Parent author handle when replying.
data . tweets [] . isQuote
boolean
Whether this tweet quotes another.
data . tweets [] . quotedTweetId
string optional
Quoted tweet id when present.
data . tweets [] . isRetweet
boolean
Whether this is a native repost.
data . tweets [] . retweetedTweetId
string optional
Original tweet id for a repost.
data . tweets [] . possiblySensitive
boolean
Whether X marks the content sensitive.
Edit metadata when applicable.
data . tweets [] . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweets [] . editInfo . editTweetIds []
string optional
data . tweets [] . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweets [] . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweets [] . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . tweets [] . source
string optional
Client label text.
data . tweets [] . sourceUrl
string optional
Link target from the source anchor when present.
data . tweets [] . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . tweets [] . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweets [] . isPaidPromotion
boolean nullable optional
Whether the author labeled the tweet as a paid partnership (X's disclosure label). Not X ads or Promote status, which X does not expose on tweets.
data . tweets [] . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweets [] . hasBirdwatchNotes
boolean nullable optional
X's Community Notes flag for this tweet. It can be false while a note is shown; use `communityNote` for the note X displays.
Link preview card when the tweet has one.
data . tweets [] . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweets [] . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweets [] . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweets [] . card . title
string nullable
Preview title of the linked page.
data . tweets [] . card . description
string nullable
Preview description of the linked page.
data . tweets [] . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweets [] . card . imageUrl
string nullable
Preview image URL.
data . tweets [] . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweets [] . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
Poll when the tweet contains one.
data . tweets [] . poll . id
string nullable
Poll id.
data . tweets [] . poll . options array nullable
Poll choices.
data . tweets [] . poll . options [] . id
string nullable
Poll choice id.
data . tweets [] . poll . options [] . label
string nullable
Poll choice label.
data . tweets [] . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweets [] . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweets [] . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweets [] . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweets [] . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweets [] . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweets [] . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
X article when the tweet is a long-form article.
data . tweets [] . article . title
string nullable
Article title.
data . tweets [] . article . previewText
string nullable
Short preview of the article body.
data . tweets [] . article . id
string nullable optional
X article id.
data . tweets [] . article . text
string nullable optional
Full article body text when X returns it.
data . tweets [] . article . coverImageUrl
string nullable optional
Article cover image URL when available.
Tagged location when the author added one.
data . tweets [] . place . id
string nullable
X place id.
data . tweets [] . place . name
string nullable
Short place name.
data . tweets [] . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweets [] . place . country
string nullable
Country name.
data . tweets [] . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweets [] . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . tweets [] . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . tweets [] . communityNote . id
string nullable
Community Note id.
data . tweets [] . communityNote . text
string nullable
Note text shown under the tweet.
data . tweets [] . communityNote . url
string nullable
Public URL of the note on X.
data . tweets [] . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweets [] . communityNote . sourceUrls []
string optional
data . tweets [] . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . tweets [] . quotedTweet object optional
Expanded quoted tweet (one level deep).
data . tweets [] . quotedTweet . id
string
Tweet id.
data . tweets [] . quotedTweet . url
string
Canonical public URL for this tweet on x.com.
data . tweets [] . quotedTweet . conversationId
string
Conversation root tweet id.
data . tweets [] . quotedTweet . createdAt
string
Creation time (ISO-8601).
data . tweets [] . quotedTweet . language
string
BCP 47 or X language code.
data . tweets [] . quotedTweet . text
string
Full tweet text (includes long-form when available).
data . tweets [] . quotedTweet . isLongForm
boolean
True when text was taken from note_tweet metadata instead of legacy.full_text alone.
data . tweets [] . quotedTweet . displayTextRange array
Start/end character indices for visible text.
data . tweets [] . quotedTweet . displayTextRange []
integer optional
data . tweets [] . quotedTweet . author object nullable
Author snapshot when available.
data . tweets [] . quotedTweet . author . handle
string
Author screen name without the leading @.
data . tweets [] . quotedTweet . author . displayName
string nullable
Author display name.
data . tweets [] . quotedTweet . author . avatarUrl
string nullable
Best available square avatar URL for the author.
data . tweets [] . quotedTweet . author . verified
boolean
Whether X marks the author with legacy verification.
data . tweets [] . quotedTweet . author . blueVerified
boolean
Whether the author has X blue (paid) verification.
data . tweets [] . quotedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . tweets [] . quotedTweet . author . bio
string nullable optional
Author profile bio when available.
data . tweets [] . quotedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . tweets [] . quotedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . tweets [] . quotedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . tweets [] . quotedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . tweets [] . quotedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . tweets [] . quotedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . tweets [] . quotedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . tweets [] . quotedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . tweets [] . quotedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . tweets [] . quotedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . tweets [] . quotedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . tweets [] . quotedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . tweets [] . quotedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . tweets [] . quotedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . tweets [] . quotedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . tweets [] . quotedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . tweets [] . quotedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . tweets [] . quotedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . tweets [] . quotedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . tweets [] . quotedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . tweets [] . quotedTweet . author . metrics . availableFields array optional
Metrics actually reported; an unavailable legacy numeric value must not be treated as an observation.
any of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount (comma-separated)
data . tweets [] . quotedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . tweets [] . quotedTweet . author . metrics . followers
integer
Follower count from X.
data . tweets [] . quotedTweet . author . metrics . following
integer
Following (friends) count from X.
data . tweets [] . quotedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . tweets [] . quotedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . tweets [] . quotedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . tweets [] . quotedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . tweets [] . quotedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . tweets [] . quotedTweet . metrics object
Engagement metrics for a tweet.
data . tweets [] . quotedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: views, favorites, retweets, replies, bookmarks, quotes (comma-separated)
data . tweets [] . quotedTweet . metrics . availableFields []
string optional
one of: views, favorites, retweets, replies, bookmarks, quotes
data . tweets [] . quotedTweet . metrics . views
integer
Impression count when reported by X.
data . tweets [] . quotedTweet . metrics . favorites
integer
Favorite (like) count.
data . tweets [] . quotedTweet . metrics . retweets
integer
Native repost count.
data . tweets [] . quotedTweet . metrics . replies
integer
Reply count.
data . tweets [] . quotedTweet . metrics . bookmarks
integer
Bookmark count.
data . tweets [] . quotedTweet . metrics . quotes
integer
Quote tweet count.
data . tweets [] . quotedTweet . media array
Photo, video, or GIF attachments.
data . tweets [] . quotedTweet . media []
optional
data . tweets [] . quotedTweet . entities object
Entities aligned with `text`.
data . tweets [] . quotedTweet . entities . hashtags array
Hashtag entities.
data . tweets [] . quotedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . tweets [] . quotedTweet . entities . userMentions array
User mention entities.
data . tweets [] . quotedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweets [] . quotedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweets [] . quotedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweets [] . quotedTweet . entities . urls array
URL entities.
data . tweets [] . quotedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . tweets [] . quotedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweets [] . quotedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweets [] . quotedTweet . entities . symbols array
Symbol entities.
data . tweets [] . quotedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . tweets [] . quotedTweet . isReply
boolean
Whether this is a reply.
data . tweets [] . quotedTweet . inReplyToTweetId
string optional
Parent tweet id when replying.
data . tweets [] . quotedTweet . inReplyToUserId
string optional
Parent author user id when replying.
data . tweets [] . quotedTweet . inReplyToScreenName
string optional
Parent author handle when replying.
data . tweets [] . quotedTweet . isQuote
boolean
Whether this tweet quotes another.
data . tweets [] . quotedTweet . quotedTweetId
string optional
Quoted tweet id when present.
data . tweets [] . quotedTweet . isRetweet
boolean
Whether this is a native repost.
data . tweets [] . quotedTweet . retweetedTweetId
string optional
Original tweet id for a repost.
data . tweets [] . quotedTweet . possiblySensitive
boolean
Whether X marks the content sensitive.
data . tweets [] . quotedTweet . editInfo object optional
Edit metadata when applicable.
data . tweets [] . quotedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweets [] . quotedTweet . editInfo . editTweetIds []
string optional
data . tweets [] . quotedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweets [] . quotedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweets [] . quotedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . tweets [] . quotedTweet . source
string optional
Client label text.
data . tweets [] . quotedTweet . sourceUrl
string optional
Link target from the source anchor when present.
data . tweets [] . quotedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . tweets [] . quotedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweets [] . quotedTweet . isPaidPromotion
boolean nullable optional
Whether the author labeled the tweet as a paid partnership (X's disclosure label). Not X ads or Promote status, which X does not expose on tweets.
data . tweets [] . quotedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweets [] . quotedTweet . hasBirdwatchNotes
boolean nullable optional
X's Community Notes flag for this tweet. It can be false while a note is shown; use `communityNote` for the note X displays.
data . tweets [] . quotedTweet . card object nullable optional
Link preview card when the tweet has one.
data . tweets [] . quotedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweets [] . quotedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweets [] . quotedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweets [] . quotedTweet . card . title
string nullable
Preview title of the linked page.
data . tweets [] . quotedTweet . card . description
string nullable
Preview description of the linked page.
data . tweets [] . quotedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweets [] . quotedTweet . card . imageUrl
string nullable
Preview image URL.
data . tweets [] . quotedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweets [] . quotedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . tweets [] . quotedTweet . poll object nullable optional
Poll when the tweet contains one.
data . tweets [] . quotedTweet . poll . id
string nullable
Poll id.
data . tweets [] . quotedTweet . poll . options array nullable
Poll choices.
data . tweets [] . quotedTweet . poll . options [] . id
string nullable
Poll choice id.
data . tweets [] . quotedTweet . poll . options [] . label
string nullable
Poll choice label.
data . tweets [] . quotedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweets [] . quotedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweets [] . quotedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweets [] . quotedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweets [] . quotedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweets [] . quotedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweets [] . quotedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . tweets [] . quotedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . tweets [] . quotedTweet . article . title
string nullable
Article title.
data . tweets [] . quotedTweet . article . previewText
string nullable
Short preview of the article body.
data . tweets [] . quotedTweet . article . id
string nullable optional
X article id.
data . tweets [] . quotedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . tweets [] . quotedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . tweets [] . quotedTweet . place object nullable optional
Tagged location when the author added one.
data . tweets [] . quotedTweet . place . id
string nullable
X place id.
data . tweets [] . quotedTweet . place . name
string nullable
Short place name.
data . tweets [] . quotedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweets [] . quotedTweet . place . country
string nullable
Country name.
data . tweets [] . quotedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweets [] . quotedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . tweets [] . quotedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . tweets [] . quotedTweet . communityNote . id
string nullable
Community Note id.
data . tweets [] . quotedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . tweets [] . quotedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . tweets [] . quotedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweets [] . quotedTweet . communityNote . sourceUrls []
string optional
data . tweets [] . quotedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . tweets [] . retweetedTweet object optional
Expanded reposted tweet (one level deep), plus its quoted tweet when it is a quote.
data . tweets [] . retweetedTweet . id
string
Tweet id.
data . tweets [] . retweetedTweet . url
string
Canonical public URL for this tweet on x.com.
data . tweets [] . retweetedTweet . conversationId
string
Conversation root tweet id.
data . tweets [] . retweetedTweet . createdAt
string
Creation time (ISO-8601).
data . tweets [] . retweetedTweet . language
string
BCP 47 or X language code.
data . tweets [] . retweetedTweet . text
string
Full tweet text (includes long-form when available).
data . tweets [] . retweetedTweet . isLongForm
boolean
True when text was taken from note_tweet metadata instead of legacy.full_text alone.
data . tweets [] . retweetedTweet . displayTextRange array
Start/end character indices for visible text.
data . tweets [] . retweetedTweet . displayTextRange []
integer optional
data . tweets [] . retweetedTweet . author object nullable
Author snapshot when available.
data . tweets [] . retweetedTweet . author . handle
string
Author screen name without the leading @.
data . tweets [] . retweetedTweet . author . displayName
string nullable
Author display name.
data . tweets [] . retweetedTweet . author . avatarUrl
string nullable
Best available square avatar URL for the author.
data . tweets [] . retweetedTweet . author . verified
boolean
Whether X marks the author with legacy verification.
data . tweets [] . retweetedTweet . author . blueVerified
boolean
Whether the author has X blue (paid) verification.
data . tweets [] . retweetedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . tweets [] . retweetedTweet . author . bio
string nullable optional
Author profile bio when available.
data . tweets [] . retweetedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . tweets [] . retweetedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . tweets [] . retweetedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . tweets [] . retweetedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . tweets [] . retweetedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . tweets [] . retweetedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . tweets [] . retweetedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . tweets [] . retweetedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . tweets [] . retweetedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . tweets [] . retweetedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . tweets [] . retweetedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . tweets [] . retweetedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . tweets [] . retweetedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . tweets [] . retweetedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . tweets [] . retweetedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . tweets [] . retweetedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . tweets [] . retweetedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . tweets [] . retweetedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . tweets [] . retweetedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . tweets [] . retweetedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . tweets [] . retweetedTweet . author . metrics . availableFields array optional
Metrics actually reported; an unavailable legacy numeric value must not be treated as an observation.
any of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount (comma-separated)
data . tweets [] . retweetedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . tweets [] . retweetedTweet . author . metrics . followers
integer
Follower count from X.
data . tweets [] . retweetedTweet . author . metrics . following
integer
Following (friends) count from X.
data . tweets [] . retweetedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . tweets [] . retweetedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . tweets [] . retweetedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . tweets [] . retweetedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . tweets [] . retweetedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . tweets [] . retweetedTweet . metrics object
Engagement metrics for a tweet.
data . tweets [] . retweetedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: views, favorites, retweets, replies, bookmarks, quotes (comma-separated)
data . tweets [] . retweetedTweet . metrics . availableFields []
string optional
one of: views, favorites, retweets, replies, bookmarks, quotes
data . tweets [] . retweetedTweet . metrics . views
integer
Impression count when reported by X.
data . tweets [] . retweetedTweet . metrics . favorites
integer
Favorite (like) count.
data . tweets [] . retweetedTweet . metrics . retweets
integer
Native repost count.
data . tweets [] . retweetedTweet . metrics . replies
integer
Reply count.
data . tweets [] . retweetedTweet . metrics . bookmarks
integer
Bookmark count.
data . tweets [] . retweetedTweet . metrics . quotes
integer
Quote tweet count.
data . tweets [] . retweetedTweet . media array
Photo, video, or GIF attachments.
data . tweets [] . retweetedTweet . media []
optional
data . tweets [] . retweetedTweet . entities object
Entities aligned with `text`.
data . tweets [] . retweetedTweet . entities . hashtags array
Hashtag entities.
data . tweets [] . retweetedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . tweets [] . retweetedTweet . entities . userMentions array
User mention entities.
data . tweets [] . retweetedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweets [] . retweetedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweets [] . retweetedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweets [] . retweetedTweet . entities . urls array
URL entities.
data . tweets [] . retweetedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . tweets [] . retweetedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweets [] . retweetedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweets [] . retweetedTweet . entities . symbols array
Symbol entities.
data . tweets [] . retweetedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . tweets [] . retweetedTweet . isReply
boolean
Whether this is a reply.
data . tweets [] . retweetedTweet . inReplyToTweetId
string optional
Parent tweet id when replying.
data . tweets [] . retweetedTweet . inReplyToUserId
string optional
Parent author user id when replying.
data . tweets [] . retweetedTweet . inReplyToScreenName
string optional
Parent author handle when replying.
data . tweets [] . retweetedTweet . isQuote
boolean
Whether this tweet quotes another.
data . tweets [] . retweetedTweet . quotedTweetId
string optional
Quoted tweet id when present.
data . tweets [] . retweetedTweet . isRetweet
boolean
Whether this is a native repost.
data . tweets [] . retweetedTweet . retweetedTweetId
string optional
Original tweet id for a repost.
data . tweets [] . retweetedTweet . possiblySensitive
boolean
Whether X marks the content sensitive.
data . tweets [] . retweetedTweet . editInfo object optional
Edit metadata when applicable.
data . tweets [] . retweetedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweets [] . retweetedTweet . editInfo . editTweetIds []
string optional
data . tweets [] . retweetedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweets [] . retweetedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweets [] . retweetedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . tweets [] . retweetedTweet . source
string optional
Client label text.
data . tweets [] . retweetedTweet . sourceUrl
string optional
Link target from the source anchor when present.
data . tweets [] . retweetedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . tweets [] . retweetedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweets [] . retweetedTweet . isPaidPromotion
boolean nullable optional
Whether the author labeled the tweet as a paid partnership (X's disclosure label). Not X ads or Promote status, which X does not expose on tweets.
data . tweets [] . retweetedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweets [] . retweetedTweet . hasBirdwatchNotes
boolean nullable optional
X's Community Notes flag for this tweet. It can be false while a note is shown; use `communityNote` for the note X displays.
data . tweets [] . retweetedTweet . card object nullable optional
Link preview card when the tweet has one.
data . tweets [] . retweetedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweets [] . retweetedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweets [] . retweetedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweets [] . retweetedTweet . card . title
string nullable
Preview title of the linked page.
data . tweets [] . retweetedTweet . card . description
string nullable
Preview description of the linked page.
data . tweets [] . retweetedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweets [] . retweetedTweet . card . imageUrl
string nullable
Preview image URL.
data . tweets [] . retweetedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweets [] . retweetedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . tweets [] . retweetedTweet . poll object nullable optional
Poll when the tweet contains one.
data . tweets [] . retweetedTweet . poll . id
string nullable
Poll id.
data . tweets [] . retweetedTweet . poll . options array nullable
Poll choices.
data . tweets [] . retweetedTweet . poll . options [] . id
string nullable
Poll choice id.
data . tweets [] . retweetedTweet . poll . options [] . label
string nullable
Poll choice label.
data . tweets [] . retweetedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweets [] . retweetedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweets [] . retweetedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweets [] . retweetedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweets [] . retweetedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweets [] . retweetedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweets [] . retweetedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . tweets [] . retweetedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . tweets [] . retweetedTweet . article . title
string nullable
Article title.
data . tweets [] . retweetedTweet . article . previewText
string nullable
Short preview of the article body.
data . tweets [] . retweetedTweet . article . id
string nullable optional
X article id.
data . tweets [] . retweetedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . tweets [] . retweetedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . tweets [] . retweetedTweet . place object nullable optional
Tagged location when the author added one.
data . tweets [] . retweetedTweet . place . id
string nullable
X place id.
data . tweets [] . retweetedTweet . place . name
string nullable
Short place name.
data . tweets [] . retweetedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweets [] . retweetedTweet . place . country
string nullable
Country name.
data . tweets [] . retweetedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweets [] . retweetedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . tweets [] . retweetedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . tweets [] . retweetedTweet . communityNote . id
string nullable
Community Note id.
data . tweets [] . retweetedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . tweets [] . retweetedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . tweets [] . retweetedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweets [] . retweetedTweet . communityNote . sourceUrls []
string optional
data . tweets [] . retweetedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . tweets [] . retweetedTweet . quotedTweet object nullable optional
Tweet quoted by the reposted tweet, when the repost is of a quote tweet.
data . tweets [] . retweetedTweet . quotedTweet . id
string
Tweet id.
data . tweets [] . retweetedTweet . quotedTweet . url
string
Canonical public URL for this tweet on x.com.
data . tweets [] . retweetedTweet . quotedTweet . conversationId
string
Conversation root tweet id.
data . tweets [] . retweetedTweet . quotedTweet . createdAt
string
Creation time (ISO-8601).
data . tweets [] . retweetedTweet . quotedTweet . createdAtUnix
integer
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
data . tweets [] . retweetedTweet . quotedTweet . language
string
BCP 47 or X language code.
data . tweets [] . retweetedTweet . quotedTweet . text
string
Full tweet text (includes long-form when available).
data . tweets [] . retweetedTweet . quotedTweet . isLongForm
boolean
True when text was taken from note_tweet metadata instead of legacy.full_text alone.
data . tweets [] . retweetedTweet . quotedTweet . displayTextRange array
Start/end character indices for visible text.
data . tweets [] . retweetedTweet . quotedTweet . displayTextRange []
integer optional
data . tweets [] . retweetedTweet . quotedTweet . author object nullable
Author snapshot when available.
data . tweets [] . retweetedTweet . quotedTweet . author . handle
string
Author screen name without the leading @.
data . tweets [] . retweetedTweet . quotedTweet . author . displayName
string nullable
Author display name.
data . tweets [] . retweetedTweet . quotedTweet . author . avatarUrl
string nullable
Best available square avatar URL for the author.
data . tweets [] . retweetedTweet . quotedTweet . author . verified
boolean
Whether X marks the author with legacy verification.
data . tweets [] . retweetedTweet . quotedTweet . author . blueVerified
boolean
Whether the author has X blue (paid) verification.
data . tweets [] . retweetedTweet . quotedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . tweets [] . retweetedTweet . quotedTweet . author . bio
string nullable optional
Author profile bio when available.
data . tweets [] . retweetedTweet . quotedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . tweets [] . retweetedTweet . quotedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . tweets [] . retweetedTweet . quotedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . tweets [] . retweetedTweet . quotedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . tweets [] . retweetedTweet . quotedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . tweets [] . retweetedTweet . quotedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . tweets [] . retweetedTweet . quotedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . availableFields array optional
Metrics actually reported; an unavailable legacy numeric value must not be treated as an observation.
any of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount (comma-separated)
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . followers
integer
Follower count from X.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . following
integer
Following (friends) count from X.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . tweets [] . retweetedTweet . quotedTweet . metrics object
Engagement metrics for a tweet.
data . tweets [] . retweetedTweet . quotedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: views, favorites, retweets, replies, bookmarks, quotes (comma-separated)
data . tweets [] . retweetedTweet . quotedTweet . metrics . availableFields []
string optional
one of: views, favorites, retweets, replies, bookmarks, quotes
data . tweets [] . retweetedTweet . quotedTweet . metrics . views
integer
Impression count when reported by X.
data . tweets [] . retweetedTweet . quotedTweet . metrics . favorites
integer
Favorite (like) count.
data . tweets [] . retweetedTweet . quotedTweet . metrics . retweets
integer
Native repost count.
data . tweets [] . retweetedTweet . quotedTweet . metrics . replies
integer
Reply count.
data . tweets [] . retweetedTweet . quotedTweet . metrics . bookmarks
integer
Bookmark count.
data . tweets [] . retweetedTweet . quotedTweet . metrics . quotes
integer
Quote tweet count.
data . tweets [] . retweetedTweet . quotedTweet . media array
Photo, video, or GIF attachments.
data . tweets [] . retweetedTweet . quotedTweet . media []
optional
data . tweets [] . retweetedTweet . quotedTweet . entities object
Entities aligned with `text`.
data . tweets [] . retweetedTweet . quotedTweet . entities . hashtags array
Hashtag entities.
data . tweets [] . retweetedTweet . quotedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . tweets [] . retweetedTweet . quotedTweet . entities . userMentions array
User mention entities.
data . tweets [] . retweetedTweet . quotedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweets [] . retweetedTweet . quotedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweets [] . retweetedTweet . quotedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweets [] . retweetedTweet . quotedTweet . entities . urls array
URL entities.
data . tweets [] . retweetedTweet . quotedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . tweets [] . retweetedTweet . quotedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweets [] . retweetedTweet . quotedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweets [] . retweetedTweet . quotedTweet . entities . symbols array
Symbol entities.
data . tweets [] . retweetedTweet . quotedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . tweets [] . retweetedTweet . quotedTweet . isReply
boolean
Whether this is a reply.
data . tweets [] . retweetedTweet . quotedTweet . inReplyToTweetId
string optional
Parent tweet id when replying.
data . tweets [] . retweetedTweet . quotedTweet . inReplyToUserId
string optional
Parent author user id when replying.
data . tweets [] . retweetedTweet . quotedTweet . inReplyToScreenName
string optional
Parent author handle when replying.
data . tweets [] . retweetedTweet . quotedTweet . isQuote
boolean
Whether this tweet quotes another.
data . tweets [] . retweetedTweet . quotedTweet . quotedTweetId
string optional
Quoted tweet id when present.
data . tweets [] . retweetedTweet . quotedTweet . isRetweet
boolean
Whether this is a native repost.
data . tweets [] . retweetedTweet . quotedTweet . retweetedTweetId
string optional
Original tweet id for a repost.
data . tweets [] . retweetedTweet . quotedTweet . possiblySensitive
boolean
Whether X marks the content sensitive.
data . tweets [] . retweetedTweet . quotedTweet . editInfo object optional
Edit metadata when applicable.
data . tweets [] . retweetedTweet . quotedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweets [] . retweetedTweet . quotedTweet . editInfo . editTweetIds []
string optional
data . tweets [] . retweetedTweet . quotedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweets [] . retweetedTweet . quotedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweets [] . retweetedTweet . quotedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . tweets [] . retweetedTweet . quotedTweet . source
string optional
Client label text.
data . tweets [] . retweetedTweet . quotedTweet . sourceUrl
string optional
Link target from the source anchor when present.
data . tweets [] . retweetedTweet . quotedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . tweets [] . retweetedTweet . quotedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweets [] . retweetedTweet . quotedTweet . isPaidPromotion
boolean nullable optional
Whether the author labeled the tweet as a paid partnership (X's disclosure label). Not X ads or Promote status, which X does not expose on tweets.
data . tweets [] . retweetedTweet . quotedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweets [] . retweetedTweet . quotedTweet . hasBirdwatchNotes
boolean nullable optional
X's Community Notes flag for this tweet. It can be false while a note is shown; use `communityNote` for the note X displays.
data . tweets [] . retweetedTweet . quotedTweet . card object nullable optional
Link preview card when the tweet has one.
data . tweets [] . retweetedTweet . quotedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweets [] . retweetedTweet . quotedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweets [] . retweetedTweet . quotedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweets [] . retweetedTweet . quotedTweet . card . title
string nullable
Preview title of the linked page.
data . tweets [] . retweetedTweet . quotedTweet . card . description
string nullable
Preview description of the linked page.
data . tweets [] . retweetedTweet . quotedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweets [] . retweetedTweet . quotedTweet . card . imageUrl
string nullable
Preview image URL.
data . tweets [] . retweetedTweet . quotedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweets [] . retweetedTweet . quotedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . tweets [] . retweetedTweet . quotedTweet . poll object nullable optional
Poll when the tweet contains one.
data . tweets [] . retweetedTweet . quotedTweet . poll . id
string nullable
Poll id.
data . tweets [] . retweetedTweet . quotedTweet . poll . options array nullable
Poll choices.
data . tweets [] . retweetedTweet . quotedTweet . poll . options [] . id
string nullable
Poll choice id.
data . tweets [] . retweetedTweet . quotedTweet . poll . options [] . label
string nullable
Poll choice label.
data . tweets [] . retweetedTweet . quotedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweets [] . retweetedTweet . quotedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweets [] . retweetedTweet . quotedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweets [] . retweetedTweet . quotedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweets [] . retweetedTweet . quotedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweets [] . retweetedTweet . quotedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweets [] . retweetedTweet . quotedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . tweets [] . retweetedTweet . quotedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . tweets [] . retweetedTweet . quotedTweet . article . title
string nullable
Article title.
data . tweets [] . retweetedTweet . quotedTweet . article . previewText
string nullable
Short preview of the article body.
data . tweets [] . retweetedTweet . quotedTweet . article . id
string nullable optional
X article id.
data . tweets [] . retweetedTweet . quotedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . tweets [] . retweetedTweet . quotedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . tweets [] . retweetedTweet . quotedTweet . place object nullable optional
Tagged location when the author added one.
data . tweets [] . retweetedTweet . quotedTweet . place . id
string nullable
X place id.
data . tweets [] . retweetedTweet . quotedTweet . place . name
string nullable
Short place name.
data . tweets [] . retweetedTweet . quotedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweets [] . retweetedTweet . quotedTweet . place . country
string nullable
Country name.
data . tweets [] . retweetedTweet . quotedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweets [] . retweetedTweet . quotedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . tweets [] . retweetedTweet . quotedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . tweets [] . retweetedTweet . quotedTweet . communityNote . id
string nullable
Community Note id.
data . tweets [] . retweetedTweet . quotedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . tweets [] . retweetedTweet . quotedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . tweets [] . retweetedTweet . quotedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweets [] . retweetedTweet . quotedTweet . communityNote . sourceUrls []
string optional
data . tweets [] . retweetedTweet . quotedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
Cursor pagination for this community tweet list.
Whether another page is available.
data . page . nextCursor
string nullable
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
meta . creditsCharged
integer
Credits charged for this request.
Public API version that served the response.
meta . cached
boolean optional
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.