Get a single tweet by permalink or numeric id.
x-api-key* string header
API key (`sfk_...`)
url* string required query
Tweet permalink or numeric id.
min 1 chars · max 4096 chars
trim boolean optional query
Optional: omit the author profile card and replies for a smaller response.
Response fields 1177 Expand all Collapse all Collapse all Endpoint-specific response payload.
Whether the tweet was found or unavailable.
Author profile and metrics when not trimmed; null when `trim=true` or when not found.
Profile fields for the tweet author.
data . author . profile . platform
string
Social platform for this profile.
data . author . profile . handle
string
X screen name (handle) without the leading @.
data . author . profile . displayName
string nullable
Display name shown on the profile.
data . author . profile . bio
string nullable
Profile biography text.
data . author . profile . avatarUrl
string nullable
Best available square avatar image URL.
data . author . profile . bannerUrl
string nullable optional
Profile banner image URL when available.
data . author . profile . verified
boolean
Whether X marks the profile with legacy verification (not necessarily paid blue).
data . author . profile . blueVerified
boolean
Whether the account has X blue (paid) verification.
data . author . profile . profileUrl
string
Canonical public profile URL on x.com.
data . author . profile . privateAccount
boolean
Whether the account is protected (private).
data . author . profile . platformUserId
string optional
Numeric X user id as a string.
data . author . profile . accountCreatedAt
string optional
Account creation time (ISO-8601) when derivable.
data . author . profile . location
string nullable optional
Location string from the profile when provided.
data . author . profile . website
string nullable optional
Primary outbound link (expanded URL) from the profile.
data . author . profile . pinnedTweetId
string optional
Pinned tweet id when X exposes one.
data . author . profile . verificationInfo object optional
Structured verification metadata from X.
data . author . profile . verificationInfo . isIdentityVerified
boolean
Whether X marks the account as identity-verified.
data . author . profile . verificationInfo . verifiedSinceMsec
string optional
When verification became effective, as milliseconds since epoch (string from X).
data . author . profile . verificationInfo . reason object optional
Verification reason payload when X provides it.
data . author . profile . verificationInfo . reason . text
string optional
Human-readable verification reason text from X.
data . author . profile . tipJar object optional
Tip jar configuration when present.
data . author . profile . tipJar . isEnabled
boolean
Whether the X tip jar is enabled.
data . author . profile . tipJar . handles object optional
Per-service handles when any are present.
data . author . profile . tipJar . handles . bandcamp
string optional
Bandcamp handle from tip jar.
data . author . profile . tipJar . handles . bitcoin
string optional
Bitcoin address or handle.
data . author . profile . tipJar . handles . cashApp
string optional
Cash App handle.
data . author . profile . tipJar . handles . ethereum
string optional
Ethereum address or handle.
data . author . profile . tipJar . handles . goFundMe
string optional
GoFundMe handle.
data . author . profile . tipJar . handles . patreon
string optional
Patreon handle.
data . author . profile . tipJar . handles . payPal
string optional
PayPal handle.
data . author . profile . tipJar . handles . venmo
string optional
Venmo handle.
data . author . profile . highlights object optional
Tweet highlights metadata when present.
data . author . profile . highlights . canHighlightTweets
boolean
Whether the account may highlight tweets on the profile.
data . author . profile . highlights . highlightedTweetCount
integer
Count of highlighted tweets when reported by X.
data . author . profile . businessAccount object optional
Business-account details from X when present.
data . author . profile . businessAccount . affiliatesCount
integer optional
Accounts affiliated with this business account, when X reports it.
data . author . profile . creatorSubscriptionsCount
integer optional
Creator subscriptions count when X reports it.
data . author . profile . affiliateLabel object optional
Affiliate or business label when X provides one.
data . author . profile . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . author . profile . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . author . profile . affiliateLabel . url
string optional
Destination URL for the label link.
data . author . profile . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . author . profile . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . author . profile . isBlueVerified
boolean nullable
Whether X marks the account as blue-verified. Same signal as `blueVerified`.
data . author . profile . verifiedType
string nullable
X verification type label when provided (for example a government or organization note).
data . author . profile . pinnedTweetIds array nullable
Pinned tweet ids from X, in display order.
data . author . profile . pinnedTweetIds []
string optional
data . author . profile . favoritesCount
integer nullable
Total likes (favorites) on the profile. Prefer `metrics.favourites`.
data . author . profile . createdAt
string nullable
Account creation time as returned by X (raw string). Prefer `accountCreatedAt` for ISO-8601.
data . author . profile . professional object nullable
X professional-account metadata when the account is marked professional.
data . author . profile . professional . type
string nullable
Professional account type from X, when present.
data . author . profile . professional . category array nullable
Professional categories X shows on the profile.
data . author . profile . professional . category [] . id
integer nullable
X's numeric id for the category.
data . author . profile . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . author . profile . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . author . profile . professional . restId
string nullable
Professional account rest id from X, when present.
data . author . profile . withheldInCountries array nullable
Country codes where the profile is withheld.
data . author . profile . withheldInCountries []
string optional
data . author . profile . profileImageShape
string nullable optional
Avatar crop shape reported by X, such as Circle or Square.
data . author . profile . verifiedSince
string nullable optional
When X verification became effective (ISO-8601). Invalid dates are null. Prefer this over `verificationInfo.verifiedSinceMsec`.
data . author . profile . possiblySensitive
boolean nullable optional
Whether X marks the profile as possibly sensitive.
data . author . profile . profileInterstitialType
string nullable optional
Interstitial type shown on the profile when X reports one.
data . author . profile . hasHiddenSubscriptions
boolean nullable optional
Whether creator subscriptions are hidden on the profile.
data . author . profile . hasGraduatedAccess
boolean nullable optional
Whether X reports graduated access for this account.
data . author . profile . isProfileTranslatable
boolean nullable optional
Whether X considers the profile text translatable.
data . author . profile . hasCustomTimelines
boolean nullable optional
Whether the account has custom timelines.
data . author . profile . isTranslator
boolean nullable optional
Whether X marks the account as a translator.
data . author . profile . defaultProfile
boolean nullable optional
Whether the account still uses the default profile theme.
data . author . profile . defaultProfileImage
boolean nullable optional
Whether the account still uses the default avatar.
Aggregate counts for the tweet author.
data . 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 . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . author . metrics . followers
integer
Follower count from X.
data . author . metrics . following
integer
Following (friends) count from X.
data . author . metrics . tweets
integer
Total post (status) count from X.
data . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
Tweet body, metrics, and optional quoted tweet; null when not found.
Canonical public URL for this tweet on x.com.
data . tweet . conversationId
string
Conversation root tweet id.
data . tweet . createdAt
string nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
data . tweet . language
string
BCP 47 or X language code.
Full tweet text (includes long-form when available).
data . tweet . isLongForm
boolean
True when text was taken from note_tweet metadata instead of legacy.full_text alone.
data . tweet . displayTextRange array
Start/end character indices for visible text.
data . tweet . displayTextRange []
integer optional
Engagement metrics for a tweet.
data . tweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: views, favorites, retweets, replies, bookmarks, quotes (comma-separated)
data . tweet . metrics . availableFields []
string optional
one of: views, favorites, retweets, replies, bookmarks, quotes
data . tweet . metrics . views
integer
Impression count when reported by X.
data . tweet . metrics . favorites
integer
Favorite (like) count.
data . tweet . metrics . retweets
integer
Native repost count.
data . tweet . metrics . replies
integer
Reply count.
data . tweet . metrics . bookmarks
integer
Bookmark count.
data . tweet . metrics . quotes
integer
Quote tweet count.
Photo, video, or GIF attachments.
data . tweet . media []
optional
Entities aligned with `text`.
data . tweet . entities . hashtags array
Hashtag entities.
data . tweet . entities . hashtags [] . text
string
Hashtag text without #.
data . tweet . entities . userMentions array
User mention entities.
data . tweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweet . entities . urls [] . url
string
Short URL as it appears in text.
data . tweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweet . entities . symbols array
Symbol entities.
data . tweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . tweet . isReply
boolean
Whether this is a reply.
data . tweet . inReplyToTweetId
string optional
Parent tweet id when replying.
data . tweet . inReplyToUserId
string optional
Parent author user id when replying.
data . tweet . inReplyToScreenName
string optional
Parent author handle when replying.
data . tweet . isQuote
boolean
Whether this tweet quotes another.
data . tweet . quotedTweetId
string optional
Quoted tweet id when present.
data . tweet . isRetweet
boolean
Whether this is a native repost.
data . tweet . retweetedTweetId
string optional
Original tweet id for a repost.
data . tweet . possiblySensitive
boolean
Whether X marks the content sensitive.
Edit metadata when applicable.
data . tweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweet . editInfo . editTweetIds []
string optional
data . tweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . tweet . source
string optional
Client label text.
data . tweet . sourceUrl
string optional
Link target from the source anchor when present.
data . tweet . communityId
string nullable
Community id when the tweet was posted to a community.
data . tweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweet . 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 . tweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweet . 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 . tweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweet . card . title
string nullable
Preview title of the linked page.
data . tweet . card . description
string nullable
Preview description of the linked page.
data . tweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweet . card . imageUrl
string nullable
Preview image URL.
data . tweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
Poll when the tweet contains one.
data . tweet . poll . id
string nullable
Poll id.
data . tweet . poll . options [] . id
string nullable
Poll choice id.
data . tweet . poll . options [] . label
string nullable
Poll choice label.
data . tweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
X article when the tweet is a long-form article.
data . tweet . article . title
string nullable
Article title.
data . tweet . article . previewText
string nullable
Short preview of the article body.
data . tweet . article . id
string nullable optional
X article id.
data . tweet . article . text
string nullable optional
Full article body text when X returns it.
data . tweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
Tagged location when the author added one.
data . tweet . place . id
string nullable
X place id.
data . tweet . place . name
string nullable
Short place name.
data . tweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweet . place . country
string nullable
Country name.
data . tweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
Community Note text and link when one is shown on the tweet.
data . tweet . communityNote . id
string nullable
Community Note id.
data . tweet . communityNote . text
string nullable
Note text shown under the tweet.
data . tweet . communityNote . url
string nullable
Public URL of the note on X.
data . tweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweet . communityNote . sourceUrls []
string optional
data . tweet . isEdited
boolean nullable
Whether the tweet has been edited.
Quoted tweet expanded one level (no further nesting on this field). Null when this is not a quote.
data . tweet . quotedTweet . id
string
Tweet id.
data . tweet . quotedTweet . url
string
Canonical public URL for this tweet on x.com.
data . tweet . quotedTweet . conversationId
string
Conversation root tweet id.
data . tweet . quotedTweet . createdAt
string nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
data . tweet . quotedTweet . language
string
BCP 47 or X language code.
data . tweet . quotedTweet . text
string
Full tweet text (includes long-form when available).
data . tweet . quotedTweet . isLongForm
boolean
True when text was taken from note_tweet metadata instead of legacy.full_text alone.
data . tweet . quotedTweet . displayTextRange array
Start/end character indices for visible text.
data . tweet . quotedTweet . displayTextRange []
integer optional
data . tweet . quotedTweet . author object nullable
Author snapshot when available.
data . tweet . quotedTweet . author . handle
string
Author screen name without the leading @.
data . tweet . quotedTweet . author . displayName
string nullable
Author display name.
data . tweet . quotedTweet . author . avatarUrl
string nullable
Best available square avatar URL for the author.
data . tweet . quotedTweet . author . verified
boolean
Whether X marks the author with legacy verification.
data . tweet . quotedTweet . author . blueVerified
boolean
Whether the author has X blue (paid) verification.
data . tweet . quotedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . tweet . quotedTweet . author . bio
string nullable optional
Author profile bio when available.
data . tweet . quotedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . tweet . quotedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . tweet . quotedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . tweet . quotedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . tweet . quotedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . tweet . quotedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . tweet . quotedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . tweet . quotedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . tweet . quotedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . tweet . quotedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . tweet . quotedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . tweet . quotedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . tweet . quotedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . tweet . quotedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . tweet . quotedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . tweet . quotedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . tweet . quotedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . tweet . quotedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . tweet . quotedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . tweet . quotedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . tweet . 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 . tweet . quotedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . tweet . quotedTweet . author . metrics . followers
integer
Follower count from X.
data . tweet . quotedTweet . author . metrics . following
integer
Following (friends) count from X.
data . tweet . quotedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . tweet . quotedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . tweet . quotedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . tweet . quotedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . tweet . quotedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . tweet . quotedTweet . metrics object
Engagement metrics for a tweet.
data . tweet . quotedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: views, favorites, retweets, replies, bookmarks, quotes (comma-separated)
data . tweet . quotedTweet . metrics . availableFields []
string optional
one of: views, favorites, retweets, replies, bookmarks, quotes
data . tweet . quotedTweet . metrics . views
integer
Impression count when reported by X.
data . tweet . quotedTweet . metrics . favorites
integer
Favorite (like) count.
data . tweet . quotedTweet . metrics . retweets
integer
Native repost count.
data . tweet . quotedTweet . metrics . replies
integer
Reply count.
data . tweet . quotedTweet . metrics . bookmarks
integer
Bookmark count.
data . tweet . quotedTweet . metrics . quotes
integer
Quote tweet count.
data . tweet . quotedTweet . media array
Photo, video, or GIF attachments.
data . tweet . quotedTweet . media []
optional
data . tweet . quotedTweet . entities object
Entities aligned with `text`.
data . tweet . quotedTweet . entities . hashtags array
Hashtag entities.
data . tweet . quotedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . tweet . quotedTweet . entities . userMentions array
User mention entities.
data . tweet . quotedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweet . quotedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweet . quotedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweet . quotedTweet . entities . urls array
URL entities.
data . tweet . quotedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . tweet . quotedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweet . quotedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweet . quotedTweet . entities . symbols array
Symbol entities.
data . tweet . quotedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . tweet . quotedTweet . isReply
boolean
Whether this is a reply.
data . tweet . quotedTweet . inReplyToTweetId
string optional
Parent tweet id when replying.
data . tweet . quotedTweet . inReplyToUserId
string optional
Parent author user id when replying.
data . tweet . quotedTweet . inReplyToScreenName
string optional
Parent author handle when replying.
data . tweet . quotedTweet . isQuote
boolean
Whether this tweet quotes another.
data . tweet . quotedTweet . quotedTweetId
string optional
Quoted tweet id when present.
data . tweet . quotedTweet . isRetweet
boolean
Whether this is a native repost.
data . tweet . quotedTweet . retweetedTweetId
string optional
Original tweet id for a repost.
data . tweet . quotedTweet . possiblySensitive
boolean
Whether X marks the content sensitive.
data . tweet . quotedTweet . editInfo object optional
Edit metadata when applicable.
data . tweet . quotedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweet . quotedTweet . editInfo . editTweetIds []
string optional
data . tweet . quotedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweet . quotedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweet . quotedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . tweet . quotedTweet . source
string optional
Client label text.
data . tweet . quotedTweet . sourceUrl
string optional
Link target from the source anchor when present.
data . tweet . quotedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . tweet . quotedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweet . 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 . tweet . quotedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweet . 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 . tweet . quotedTweet . card object nullable optional
Link preview card when the tweet has one.
data . tweet . quotedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweet . quotedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweet . quotedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweet . quotedTweet . card . title
string nullable
Preview title of the linked page.
data . tweet . quotedTweet . card . description
string nullable
Preview description of the linked page.
data . tweet . quotedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweet . quotedTweet . card . imageUrl
string nullable
Preview image URL.
data . tweet . quotedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweet . quotedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . tweet . quotedTweet . poll object nullable optional
Poll when the tweet contains one.
data . tweet . quotedTweet . poll . id
string nullable
Poll id.
data . tweet . quotedTweet . poll . options array nullable
Poll choices.
data . tweet . quotedTweet . poll . options [] . id
string nullable
Poll choice id.
data . tweet . quotedTweet . poll . options [] . label
string nullable
Poll choice label.
data . tweet . quotedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweet . quotedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweet . quotedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweet . quotedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweet . quotedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweet . quotedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweet . quotedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . tweet . quotedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . tweet . quotedTweet . article . title
string nullable
Article title.
data . tweet . quotedTweet . article . previewText
string nullable
Short preview of the article body.
data . tweet . quotedTweet . article . id
string nullable optional
X article id.
data . tweet . quotedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . tweet . quotedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . tweet . quotedTweet . place object nullable optional
Tagged location when the author added one.
data . tweet . quotedTweet . place . id
string nullable
X place id.
data . tweet . quotedTweet . place . name
string nullable
Short place name.
data . tweet . quotedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweet . quotedTweet . place . country
string nullable
Country name.
data . tweet . quotedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweet . quotedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . tweet . quotedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . tweet . quotedTweet . communityNote . id
string nullable
Community Note id.
data . tweet . quotedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . tweet . quotedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . tweet . quotedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweet . quotedTweet . communityNote . sourceUrls []
string optional
data . tweet . quotedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . tweet . retweetedTweet object nullable
Reposted tweet expanded one level, plus its quoted tweet when it is a quote. Null when this is not a repost.
data . tweet . retweetedTweet . id
string
Tweet id.
data . tweet . retweetedTweet . url
string
Canonical public URL for this tweet on x.com.
data . tweet . retweetedTweet . conversationId
string
Conversation root tweet id.
data . tweet . retweetedTweet . createdAt
string nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
data . tweet . retweetedTweet . createdAtUnix
integer nullable
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
data . tweet . retweetedTweet . language
string
BCP 47 or X language code.
data . tweet . retweetedTweet . text
string
Full tweet text (includes long-form when available).
data . tweet . retweetedTweet . isLongForm
boolean
True when text was taken from note_tweet metadata instead of legacy.full_text alone.
data . tweet . retweetedTweet . displayTextRange array
Start/end character indices for visible text.
data . tweet . retweetedTweet . displayTextRange []
integer optional
data . tweet . retweetedTweet . author object nullable
Author snapshot when available.
data . tweet . retweetedTweet . author . handle
string
Author screen name without the leading @.
data . tweet . retweetedTweet . author . displayName
string nullable
Author display name.
data . tweet . retweetedTweet . author . avatarUrl
string nullable
Best available square avatar URL for the author.
data . tweet . retweetedTweet . author . verified
boolean
Whether X marks the author with legacy verification.
data . tweet . retweetedTweet . author . blueVerified
boolean
Whether the author has X blue (paid) verification.
data . tweet . retweetedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . tweet . retweetedTweet . author . bio
string nullable optional
Author profile bio when available.
data . tweet . retweetedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . tweet . retweetedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . tweet . retweetedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . tweet . retweetedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . tweet . retweetedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . tweet . retweetedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . tweet . retweetedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . tweet . retweetedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . tweet . retweetedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . tweet . retweetedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . tweet . retweetedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . tweet . retweetedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . tweet . retweetedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . tweet . retweetedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . tweet . retweetedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . tweet . retweetedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . tweet . retweetedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . tweet . retweetedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . tweet . retweetedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . tweet . retweetedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . tweet . 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 . tweet . retweetedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . tweet . retweetedTweet . author . metrics . followers
integer
Follower count from X.
data . tweet . retweetedTweet . author . metrics . following
integer
Following (friends) count from X.
data . tweet . retweetedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . tweet . retweetedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . tweet . retweetedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . tweet . retweetedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . tweet . retweetedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . tweet . retweetedTweet . metrics object
Engagement metrics for a tweet.
data . tweet . retweetedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: views, favorites, retweets, replies, bookmarks, quotes (comma-separated)
data . tweet . retweetedTweet . metrics . availableFields []
string optional
one of: views, favorites, retweets, replies, bookmarks, quotes
data . tweet . retweetedTweet . metrics . views
integer
Impression count when reported by X.
data . tweet . retweetedTweet . metrics . favorites
integer
Favorite (like) count.
data . tweet . retweetedTweet . metrics . retweets
integer
Native repost count.
data . tweet . retweetedTweet . metrics . replies
integer
Reply count.
data . tweet . retweetedTweet . metrics . bookmarks
integer
Bookmark count.
data . tweet . retweetedTweet . metrics . quotes
integer
Quote tweet count.
data . tweet . retweetedTweet . media array
Photo, video, or GIF attachments.
data . tweet . retweetedTweet . media []
optional
data . tweet . retweetedTweet . entities object
Entities aligned with `text`.
data . tweet . retweetedTweet . entities . hashtags array
Hashtag entities.
data . tweet . retweetedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . tweet . retweetedTweet . entities . userMentions array
User mention entities.
data . tweet . retweetedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweet . retweetedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweet . retweetedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweet . retweetedTweet . entities . urls array
URL entities.
data . tweet . retweetedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . tweet . retweetedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweet . retweetedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweet . retweetedTweet . entities . symbols array
Symbol entities.
data . tweet . retweetedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . tweet . retweetedTweet . isReply
boolean
Whether this is a reply.
data . tweet . retweetedTweet . inReplyToTweetId
string optional
Parent tweet id when replying.
data . tweet . retweetedTweet . inReplyToUserId
string optional
Parent author user id when replying.
data . tweet . retweetedTweet . inReplyToScreenName
string optional
Parent author handle when replying.
data . tweet . retweetedTweet . isQuote
boolean
Whether this tweet quotes another.
data . tweet . retweetedTweet . quotedTweetId
string optional
Quoted tweet id when present.
data . tweet . retweetedTweet . isRetweet
boolean
Whether this is a native repost.
data . tweet . retweetedTweet . retweetedTweetId
string optional
Original tweet id for a repost.
data . tweet . retweetedTweet . possiblySensitive
boolean
Whether X marks the content sensitive.
data . tweet . retweetedTweet . editInfo object optional
Edit metadata when applicable.
data . tweet . retweetedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweet . retweetedTweet . editInfo . editTweetIds []
string optional
data . tweet . retweetedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweet . retweetedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweet . retweetedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . tweet . retweetedTweet . source
string optional
Client label text.
data . tweet . retweetedTweet . sourceUrl
string optional
Link target from the source anchor when present.
data . tweet . retweetedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . tweet . retweetedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweet . 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 . tweet . retweetedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweet . 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 . tweet . retweetedTweet . card object nullable optional
Link preview card when the tweet has one.
data . tweet . retweetedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweet . retweetedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweet . retweetedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweet . retweetedTweet . card . title
string nullable
Preview title of the linked page.
data . tweet . retweetedTweet . card . description
string nullable
Preview description of the linked page.
data . tweet . retweetedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweet . retweetedTweet . card . imageUrl
string nullable
Preview image URL.
data . tweet . retweetedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweet . retweetedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . tweet . retweetedTweet . poll object nullable optional
Poll when the tweet contains one.
data . tweet . retweetedTweet . poll . id
string nullable
Poll id.
data . tweet . retweetedTweet . poll . options array nullable
Poll choices.
data . tweet . retweetedTweet . poll . options [] . id
string nullable
Poll choice id.
data . tweet . retweetedTweet . poll . options [] . label
string nullable
Poll choice label.
data . tweet . retweetedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweet . retweetedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweet . retweetedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweet . retweetedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweet . retweetedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweet . retweetedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweet . retweetedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . tweet . retweetedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . tweet . retweetedTweet . article . title
string nullable
Article title.
data . tweet . retweetedTweet . article . previewText
string nullable
Short preview of the article body.
data . tweet . retweetedTweet . article . id
string nullable optional
X article id.
data . tweet . retweetedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . tweet . retweetedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . tweet . retweetedTweet . place object nullable optional
Tagged location when the author added one.
data . tweet . retweetedTweet . place . id
string nullable
X place id.
data . tweet . retweetedTweet . place . name
string nullable
Short place name.
data . tweet . retweetedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweet . retweetedTweet . place . country
string nullable
Country name.
data . tweet . retweetedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweet . retweetedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . tweet . retweetedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . tweet . retweetedTweet . communityNote . id
string nullable
Community Note id.
data . tweet . retweetedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . tweet . retweetedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . tweet . retweetedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweet . retweetedTweet . communityNote . sourceUrls []
string optional
data . tweet . retweetedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . tweet . retweetedTweet . quotedTweet object nullable optional
Tweet quoted by the reposted tweet, when the repost is of a quote tweet.
data . tweet . retweetedTweet . quotedTweet . id
string
Tweet id.
data . tweet . retweetedTweet . quotedTweet . url
string
Canonical public URL for this tweet on x.com.
data . tweet . retweetedTweet . quotedTweet . conversationId
string
Conversation root tweet id.
data . tweet . retweetedTweet . quotedTweet . createdAt
string nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
data . tweet . retweetedTweet . quotedTweet . createdAtUnix
integer nullable
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
data . tweet . retweetedTweet . quotedTweet . language
string
BCP 47 or X language code.
data . tweet . retweetedTweet . quotedTweet . text
string
Full tweet text (includes long-form when available).
data . tweet . retweetedTweet . quotedTweet . isLongForm
boolean
True when text was taken from note_tweet metadata instead of legacy.full_text alone.
data . tweet . retweetedTweet . quotedTweet . displayTextRange array
Start/end character indices for visible text.
data . tweet . retweetedTweet . quotedTweet . displayTextRange []
integer optional
data . tweet . retweetedTweet . quotedTweet . author object nullable
Author snapshot when available.
data . tweet . retweetedTweet . quotedTweet . author . handle
string
Author screen name without the leading @.
data . tweet . retweetedTweet . quotedTweet . author . displayName
string nullable
Author display name.
data . tweet . retweetedTweet . quotedTweet . author . avatarUrl
string nullable
Best available square avatar URL for the author.
data . tweet . retweetedTweet . quotedTweet . author . verified
boolean
Whether X marks the author with legacy verification.
data . tweet . retweetedTweet . quotedTweet . author . blueVerified
boolean
Whether the author has X blue (paid) verification.
data . tweet . retweetedTweet . quotedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . tweet . retweetedTweet . quotedTweet . author . bio
string nullable optional
Author profile bio when available.
data . tweet . retweetedTweet . quotedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . tweet . retweetedTweet . quotedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . tweet . retweetedTweet . quotedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . tweet . retweetedTweet . quotedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . tweet . retweetedTweet . quotedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . tweet . retweetedTweet . quotedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . tweet . retweetedTweet . quotedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . tweet . retweetedTweet . quotedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . tweet . retweetedTweet . quotedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . tweet . retweetedTweet . quotedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . tweet . retweetedTweet . quotedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . tweet . retweetedTweet . quotedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . tweet . retweetedTweet . quotedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . tweet . retweetedTweet . quotedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . tweet . retweetedTweet . quotedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . tweet . retweetedTweet . quotedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . tweet . retweetedTweet . quotedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . tweet . retweetedTweet . quotedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . tweet . retweetedTweet . quotedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . tweet . retweetedTweet . quotedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . tweet . 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 . tweet . retweetedTweet . quotedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . tweet . retweetedTweet . quotedTweet . author . metrics . followers
integer
Follower count from X.
data . tweet . retweetedTweet . quotedTweet . author . metrics . following
integer
Following (friends) count from X.
data . tweet . retweetedTweet . quotedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . tweet . retweetedTweet . quotedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . tweet . retweetedTweet . quotedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . tweet . retweetedTweet . quotedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . tweet . retweetedTweet . quotedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . tweet . retweetedTweet . quotedTweet . metrics object
Engagement metrics for a tweet.
data . tweet . retweetedTweet . quotedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: views, favorites, retweets, replies, bookmarks, quotes (comma-separated)
data . tweet . retweetedTweet . quotedTweet . metrics . availableFields []
string optional
one of: views, favorites, retweets, replies, bookmarks, quotes
data . tweet . retweetedTweet . quotedTweet . metrics . views
integer
Impression count when reported by X.
data . tweet . retweetedTweet . quotedTweet . metrics . favorites
integer
Favorite (like) count.
data . tweet . retweetedTweet . quotedTweet . metrics . retweets
integer
Native repost count.
data . tweet . retweetedTweet . quotedTweet . metrics . replies
integer
Reply count.
data . tweet . retweetedTweet . quotedTweet . metrics . bookmarks
integer
Bookmark count.
data . tweet . retweetedTweet . quotedTweet . metrics . quotes
integer
Quote tweet count.
data . tweet . retweetedTweet . quotedTweet . media array
Photo, video, or GIF attachments.
data . tweet . retweetedTweet . quotedTweet . media []
optional
data . tweet . retweetedTweet . quotedTweet . entities object
Entities aligned with `text`.
data . tweet . retweetedTweet . quotedTweet . entities . hashtags array
Hashtag entities.
data . tweet . retweetedTweet . quotedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . tweet . retweetedTweet . quotedTweet . entities . userMentions array
User mention entities.
data . tweet . retweetedTweet . quotedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweet . retweetedTweet . quotedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweet . retweetedTweet . quotedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweet . retweetedTweet . quotedTweet . entities . urls array
URL entities.
data . tweet . retweetedTweet . quotedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . tweet . retweetedTweet . quotedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweet . retweetedTweet . quotedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweet . retweetedTweet . quotedTweet . entities . symbols array
Symbol entities.
data . tweet . retweetedTweet . quotedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . tweet . retweetedTweet . quotedTweet . isReply
boolean
Whether this is a reply.
data . tweet . retweetedTweet . quotedTweet . inReplyToTweetId
string optional
Parent tweet id when replying.
data . tweet . retweetedTweet . quotedTweet . inReplyToUserId
string optional
Parent author user id when replying.
data . tweet . retweetedTweet . quotedTweet . inReplyToScreenName
string optional
Parent author handle when replying.
data . tweet . retweetedTweet . quotedTweet . isQuote
boolean
Whether this tweet quotes another.
data . tweet . retweetedTweet . quotedTweet . quotedTweetId
string optional
Quoted tweet id when present.
data . tweet . retweetedTweet . quotedTweet . isRetweet
boolean
Whether this is a native repost.
data . tweet . retweetedTweet . quotedTweet . retweetedTweetId
string optional
Original tweet id for a repost.
data . tweet . retweetedTweet . quotedTweet . possiblySensitive
boolean
Whether X marks the content sensitive.
data . tweet . retweetedTweet . quotedTweet . editInfo object optional
Edit metadata when applicable.
data . tweet . retweetedTweet . quotedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweet . retweetedTweet . quotedTweet . editInfo . editTweetIds []
string optional
data . tweet . retweetedTweet . quotedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweet . retweetedTweet . quotedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweet . retweetedTweet . quotedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . tweet . retweetedTweet . quotedTweet . source
string optional
Client label text.
data . tweet . retweetedTweet . quotedTweet . sourceUrl
string optional
Link target from the source anchor when present.
data . tweet . retweetedTweet . quotedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . tweet . retweetedTweet . quotedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweet . 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 . tweet . retweetedTweet . quotedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweet . 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 . tweet . retweetedTweet . quotedTweet . card object nullable optional
Link preview card when the tweet has one.
data . tweet . retweetedTweet . quotedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweet . retweetedTweet . quotedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweet . retweetedTweet . quotedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweet . retweetedTweet . quotedTweet . card . title
string nullable
Preview title of the linked page.
data . tweet . retweetedTweet . quotedTweet . card . description
string nullable
Preview description of the linked page.
data . tweet . retweetedTweet . quotedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweet . retweetedTweet . quotedTweet . card . imageUrl
string nullable
Preview image URL.
data . tweet . retweetedTweet . quotedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweet . retweetedTweet . quotedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . tweet . retweetedTweet . quotedTweet . poll object nullable optional
Poll when the tweet contains one.
data . tweet . retweetedTweet . quotedTweet . poll . id
string nullable
Poll id.
data . tweet . retweetedTweet . quotedTweet . poll . options array nullable
Poll choices.
data . tweet . retweetedTweet . quotedTweet . poll . options [] . id
string nullable
Poll choice id.
data . tweet . retweetedTweet . quotedTweet . poll . options [] . label
string nullable
Poll choice label.
data . tweet . retweetedTweet . quotedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweet . retweetedTweet . quotedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweet . retweetedTweet . quotedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweet . retweetedTweet . quotedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweet . retweetedTweet . quotedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweet . retweetedTweet . quotedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweet . retweetedTweet . quotedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . tweet . retweetedTweet . quotedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . tweet . retweetedTweet . quotedTweet . article . title
string nullable
Article title.
data . tweet . retweetedTweet . quotedTweet . article . previewText
string nullable
Short preview of the article body.
data . tweet . retweetedTweet . quotedTweet . article . id
string nullable optional
X article id.
data . tweet . retweetedTweet . quotedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . tweet . retweetedTweet . quotedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . tweet . retweetedTweet . quotedTweet . place object nullable optional
Tagged location when the author added one.
data . tweet . retweetedTweet . quotedTweet . place . id
string nullable
X place id.
data . tweet . retweetedTweet . quotedTweet . place . name
string nullable
Short place name.
data . tweet . retweetedTweet . quotedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweet . retweetedTweet . quotedTweet . place . country
string nullable
Country name.
data . tweet . retweetedTweet . quotedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweet . retweetedTweet . quotedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . tweet . retweetedTweet . quotedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . tweet . retweetedTweet . quotedTweet . communityNote . id
string nullable
Community Note id.
data . tweet . retweetedTweet . quotedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . tweet . retweetedTweet . quotedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . tweet . retweetedTweet . quotedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweet . retweetedTweet . quotedTweet . communityNote . sourceUrls []
string optional
data . tweet . retweetedTweet . quotedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . tweet . type
string nullable
Tweet kind: `tweet`, `reply`, `quote`, or `retweet`.
Parent tweet when this is a reply.
data . tweet . replyTo . tweetId
string nullable
Parent tweet id.
data . tweet . replyTo . userId
string nullable
Parent author user id.
data . tweet . replyTo . username
string nullable
Parent author handle.
First page of replies, in the same shape as `GET /v1/twitter/tweets/replies` (relevance order). Empty when not found; omitted when `trim=true`.
data . replies [] . url
string nullable
Canonical public URL for the tweet when available.
data . replies [] . text
string
Full tweet text when available.
data . replies [] . createdAt
string nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
data . replies [] . createdAtUnix
integer nullable
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
data . replies [] . createdAtLabel
string nullable
Human-readable creation timestamp string when available.
data . replies [] . language
string nullable
Language code for the tweet when available.
data . replies [] . conversationId
string nullable
Conversation identifier when supplied.
data . replies [] . inReplyToStatusId
string nullable
Parent post identifier when this post is a reply.
data . replies [] . inReplyToUserId
string nullable optional
Parent post author user id when this post is a reply.
data . replies [] . inReplyToScreenName
string nullable optional
Parent post author handle when this post is a reply.
data . replies [] . quotedStatusId
string nullable
Quoted post identifier when this post quotes another.
data . replies [] . retweetTweetId
string nullable
Original post identifier when this post is an engagement repost.
Author metadata for the tweet when available.
data . replies [] . author . handle
string
Author handle without the leading @.
data . replies [] . author . displayName
string nullable
Display name shown for the author.
data . replies [] . author . avatarUrl
string nullable
Profile image URL for the author when available.
data . replies [] . author . profileUrl
string nullable
Canonical public profile URL for the author when available.
data . replies [] . author . verified
boolean
Whether the author has legacy verification on X.
data . replies [] . author . blueVerified
boolean
Whether the author has paid blue verification on X.
data . replies [] . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . replies [] . author . bio
string nullable optional
Author profile bio when available.
data . replies [] . author . location
string nullable optional
Location string from the author profile when provided.
data . replies [] . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . replies [] . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . replies [] . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . replies [] . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . replies [] . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . replies [] . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . replies [] . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . replies [] . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . replies [] . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . replies [] . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . replies [] . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . replies [] . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . replies [] . author . professional . type
string nullable
Professional account type from X, when present.
data . replies [] . author . professional . category array nullable
Professional categories X shows on the profile.
data . replies [] . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . replies [] . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . replies [] . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . replies [] . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . replies [] . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . replies [] . 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 . replies [] . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . replies [] . author . metrics . followers
integer
Follower count from X.
data . replies [] . author . metrics . following
integer
Following (friends) count from X.
data . replies [] . author . metrics . tweets
integer
Total post (status) count from X.
data . replies [] . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . replies [] . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . replies [] . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . replies [] . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
Engagement metrics for a tweet.
data . replies [] . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: likes, retweets, replies, quotes, views, bookmarkCount (comma-separated)
data . replies [] . metrics . availableFields []
string optional
one of: likes, retweets, replies, quotes, views, bookmarkCount
data . replies [] . metrics . likes
integer
Like count.
data . replies [] . metrics . retweets
integer
Retweet count.
data . replies [] . metrics . replies
integer
Reply count.
data . replies [] . metrics . quotes
integer
Quote count.
data . replies [] . metrics . views
integer nullable
View count when available.
data . replies [] . metrics . bookmarkCount
integer nullable
Bookmark count when available.
Media attachments returned for the tweet.
data . replies [] . media [] . url
string
Direct media URL when available.
data . replies [] . media [] . type
string
Media type when Social Fetch can classify it confidently.
one of: photo, video, animated_gif
data . replies [] . media [] . thumbnailUrl
string optional
Poster or thumbnail URL for video media when distinguishable.
data . replies [] . media [] . contentType
string optional
MIME type reported for streamed media.
data . replies [] . media [] . bitrate
integer optional
Bitrate in bits per second when supplied for streamed media.
data . replies [] . media [] . width
integer optional
Width in pixels when available.
data . replies [] . media [] . height
integer optional
Height in pixels when available.
data . replies [] . media [] . id
string optional
X media id. Video variants of the same attachment share one id.
data . replies [] . media [] . altText
string nullable optional
Alternative text for the media when provided.
data . replies [] . media [] . durationMs
integer optional
Video or GIF duration in milliseconds when known.
data . replies [] . expandedUrl
string nullable
Expanded URL attached to the tweet when available.
data . replies [] . isRetweet
boolean
Whether the tweet is marked as a retweet.
data . replies [] . isReply
boolean optional
Whether the tweet is a reply to another post.
data . replies [] . isQuote
boolean optional
Whether the tweet quotes another post.
data . replies [] . source
string nullable
Source label such as `Twitter Web App` when available.
data . replies [] . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . replies [] . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . replies [] . 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 . replies [] . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . replies [] . 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 . replies [] . possiblySensitive
boolean nullable optional
Whether X marks the content sensitive.
Hashtags, mentions, links, and cashtags in the tweet text.
data . replies [] . entities . hashtags array
Hashtag entities.
data . replies [] . entities . hashtags [] . text
string
Hashtag text without #.
data . replies [] . entities . userMentions array
User mention entities.
data . replies [] . entities . userMentions [] . handle
string
Mentioned screen name.
data . replies [] . entities . userMentions [] . displayName
string optional
Display name when available.
data . replies [] . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . replies [] . entities . urls array
URL entities.
data . replies [] . entities . urls [] . url
string
Short URL as it appears in text.
data . replies [] . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . replies [] . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . replies [] . entities . symbols array
Symbol entities.
data . replies [] . entities . symbols [] . text
string
Cashtag or symbol text.
Edit metadata when the tweet is editable or edited.
data . replies [] . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . replies [] . editInfo . editTweetIds []
string optional
data . replies [] . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . replies [] . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . replies [] . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
Link preview card when the tweet has one.
data . replies [] . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . replies [] . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . replies [] . card . url
string nullable
Link the card points to, usually a t.co short link.
data . replies [] . card . title
string nullable
Preview title of the linked page.
data . replies [] . card . description
string nullable
Preview description of the linked page.
data . replies [] . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . replies [] . card . imageUrl
string nullable
Preview image URL.
data . replies [] . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . replies [] . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
Poll when the tweet contains one.
data . replies [] . poll . id
string nullable
Poll id.
data . replies [] . poll . options array nullable
Poll choices.
data . replies [] . poll . options [] . id
string nullable
Poll choice id.
data . replies [] . poll . options [] . label
string nullable
Poll choice label.
data . replies [] . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . replies [] . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . replies [] . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . replies [] . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . replies [] . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . replies [] . poll . totalVotes
integer nullable
Total votes across all choices.
data . replies [] . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
X article when the tweet is a long-form article.
data . replies [] . article . title
string nullable
Article title.
data . replies [] . article . previewText
string nullable
Short preview of the article body.
data . replies [] . article . id
string nullable optional
X article id.
data . replies [] . article . text
string nullable optional
Full article body text when X returns it.
data . replies [] . article . coverImageUrl
string nullable optional
Article cover image URL when available.
Tagged location when the author added one.
data . replies [] . place . id
string nullable
X place id.
data . replies [] . place . name
string nullable
Short place name.
data . replies [] . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . replies [] . place . country
string nullable
Country name.
data . replies [] . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . replies [] . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . replies [] . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . replies [] . communityNote . id
string nullable
Community Note id.
data . replies [] . communityNote . text
string nullable
Note text shown under the tweet.
data . replies [] . communityNote . url
string nullable
Public URL of the note on X.
data . replies [] . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . replies [] . communityNote . sourceUrls []
string optional
data . replies [] . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . replies [] . quotedTweet object nullable optional
Quoted tweet expanded one level (no further nesting).
data . replies [] . quotedTweet . id
string
Tweet id.
data . replies [] . quotedTweet . url
string nullable
Canonical public URL for the tweet when available.
data . replies [] . quotedTweet . text
string
Full tweet text when available.
data . replies [] . quotedTweet . createdAt
string nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
data . replies [] . quotedTweet . createdAtUnix
integer nullable
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
data . replies [] . quotedTweet . createdAtLabel
string nullable
Human-readable creation timestamp string when available.
data . replies [] . quotedTweet . language
string nullable
Language code for the tweet when available.
data . replies [] . quotedTweet . conversationId
string nullable
Conversation identifier when supplied.
data . replies [] . quotedTweet . inReplyToStatusId
string nullable
Parent post identifier when this post is a reply.
data . replies [] . quotedTweet . inReplyToUserId
string nullable optional
Parent post author user id when this post is a reply.
data . replies [] . quotedTweet . inReplyToScreenName
string nullable optional
Parent post author handle when this post is a reply.
data . replies [] . quotedTweet . quotedStatusId
string nullable
Quoted post identifier when this post quotes another.
data . replies [] . quotedTweet . retweetTweetId
string nullable
Original post identifier when this post is an engagement repost.
data . replies [] . quotedTweet . author object nullable
Author metadata for the tweet when available.
data . replies [] . quotedTweet . author . handle
string
Author handle without the leading @.
data . replies [] . quotedTweet . author . displayName
string nullable
Display name shown for the author.
data . replies [] . quotedTweet . author . avatarUrl
string nullable
Profile image URL for the author when available.
data . replies [] . quotedTweet . author . profileUrl
string nullable
Canonical public profile URL for the author when available.
data . replies [] . quotedTweet . author . verified
boolean
Whether the author has legacy verification on X.
data . replies [] . quotedTweet . author . blueVerified
boolean
Whether the author has paid blue verification on X.
data . replies [] . quotedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . replies [] . quotedTweet . author . bio
string nullable optional
Author profile bio when available.
data . replies [] . quotedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . replies [] . quotedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . replies [] . quotedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . replies [] . quotedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . replies [] . quotedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . replies [] . quotedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . replies [] . quotedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . replies [] . quotedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . replies [] . quotedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . replies [] . quotedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . replies [] . quotedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . replies [] . quotedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . replies [] . quotedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . replies [] . quotedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . replies [] . quotedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . replies [] . quotedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . replies [] . quotedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . replies [] . quotedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . replies [] . quotedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . replies [] . quotedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . replies [] . 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 . replies [] . quotedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . replies [] . quotedTweet . author . metrics . followers
integer
Follower count from X.
data . replies [] . quotedTweet . author . metrics . following
integer
Following (friends) count from X.
data . replies [] . quotedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . replies [] . quotedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . replies [] . quotedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . replies [] . quotedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . replies [] . quotedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . replies [] . quotedTweet . metrics object
Engagement metrics for a tweet.
data . replies [] . quotedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: likes, retweets, replies, quotes, views, bookmarkCount (comma-separated)
data . replies [] . quotedTweet . metrics . availableFields []
string optional
one of: likes, retweets, replies, quotes, views, bookmarkCount
data . replies [] . quotedTweet . metrics . likes
integer
Like count.
data . replies [] . quotedTweet . metrics . retweets
integer
Retweet count.
data . replies [] . quotedTweet . metrics . replies
integer
Reply count.
data . replies [] . quotedTweet . metrics . quotes
integer
Quote count.
data . replies [] . quotedTweet . metrics . views
integer nullable
View count when available.
data . replies [] . quotedTweet . metrics . bookmarkCount
integer nullable
Bookmark count when available.
data . replies [] . quotedTweet . media array
Media attachments returned for the tweet.
data . replies [] . quotedTweet . media [] . url
string
Direct media URL when available.
data . replies [] . quotedTweet . media [] . type
string
Media type when Social Fetch can classify it confidently.
one of: photo, video, animated_gif
data . replies [] . quotedTweet . media [] . thumbnailUrl
string optional
Poster or thumbnail URL for video media when distinguishable.
data . replies [] . quotedTweet . media [] . contentType
string optional
MIME type reported for streamed media.
data . replies [] . quotedTweet . media [] . bitrate
integer optional
Bitrate in bits per second when supplied for streamed media.
data . replies [] . quotedTweet . media [] . width
integer optional
Width in pixels when available.
data . replies [] . quotedTweet . media [] . height
integer optional
Height in pixels when available.
data . replies [] . quotedTweet . media [] . id
string optional
X media id. Video variants of the same attachment share one id.
data . replies [] . quotedTweet . media [] . altText
string nullable optional
Alternative text for the media when provided.
data . replies [] . quotedTweet . media [] . durationMs
integer optional
Video or GIF duration in milliseconds when known.
data . replies [] . quotedTweet . expandedUrl
string nullable
Expanded URL attached to the tweet when available.
data . replies [] . quotedTweet . isRetweet
boolean
Whether the tweet is marked as a retweet.
data . replies [] . quotedTweet . isReply
boolean optional
Whether the tweet is a reply to another post.
data . replies [] . quotedTweet . isQuote
boolean optional
Whether the tweet quotes another post.
data . replies [] . quotedTweet . source
string nullable
Source label such as `Twitter Web App` when available.
data . replies [] . quotedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . replies [] . quotedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . replies [] . 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 . replies [] . quotedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . replies [] . 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 . replies [] . quotedTweet . possiblySensitive
boolean nullable optional
Whether X marks the content sensitive.
data . replies [] . quotedTweet . entities object optional
Hashtags, mentions, links, and cashtags in the tweet text.
data . replies [] . quotedTweet . entities . hashtags array
Hashtag entities.
data . replies [] . quotedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . replies [] . quotedTweet . entities . userMentions array
User mention entities.
data . replies [] . quotedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . replies [] . quotedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . replies [] . quotedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . replies [] . quotedTweet . entities . urls array
URL entities.
data . replies [] . quotedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . replies [] . quotedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . replies [] . quotedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . replies [] . quotedTweet . entities . symbols array
Symbol entities.
data . replies [] . quotedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . replies [] . quotedTweet . editInfo object optional
Edit metadata when the tweet is editable or edited.
data . replies [] . quotedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . replies [] . quotedTweet . editInfo . editTweetIds []
string optional
data . replies [] . quotedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . replies [] . quotedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . replies [] . quotedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . replies [] . quotedTweet . card object nullable optional
Link preview card when the tweet has one.
data . replies [] . quotedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . replies [] . quotedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . replies [] . quotedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . replies [] . quotedTweet . card . title
string nullable
Preview title of the linked page.
data . replies [] . quotedTweet . card . description
string nullable
Preview description of the linked page.
data . replies [] . quotedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . replies [] . quotedTweet . card . imageUrl
string nullable
Preview image URL.
data . replies [] . quotedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . replies [] . quotedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . replies [] . quotedTweet . poll object nullable optional
Poll when the tweet contains one.
data . replies [] . quotedTweet . poll . id
string nullable
Poll id.
data . replies [] . quotedTweet . poll . options array nullable
Poll choices.
data . replies [] . quotedTweet . poll . options [] . id
string nullable
Poll choice id.
data . replies [] . quotedTweet . poll . options [] . label
string nullable
Poll choice label.
data . replies [] . quotedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . replies [] . quotedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . replies [] . quotedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . replies [] . quotedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . replies [] . quotedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . replies [] . quotedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . replies [] . quotedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . replies [] . quotedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . replies [] . quotedTweet . article . title
string nullable
Article title.
data . replies [] . quotedTweet . article . previewText
string nullable
Short preview of the article body.
data . replies [] . quotedTweet . article . id
string nullable optional
X article id.
data . replies [] . quotedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . replies [] . quotedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . replies [] . quotedTweet . place object nullable optional
Tagged location when the author added one.
data . replies [] . quotedTweet . place . id
string nullable
X place id.
data . replies [] . quotedTweet . place . name
string nullable
Short place name.
data . replies [] . quotedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . replies [] . quotedTweet . place . country
string nullable
Country name.
data . replies [] . quotedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . replies [] . quotedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . replies [] . quotedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . replies [] . quotedTweet . communityNote . id
string nullable
Community Note id.
data . replies [] . quotedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . replies [] . quotedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . replies [] . quotedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . replies [] . quotedTweet . communityNote . sourceUrls []
string optional
data . replies [] . quotedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . replies [] . retweetedTweet object nullable optional
Reposted tweet expanded one level, plus its quoted tweet when it is a quote.
data . replies [] . retweetedTweet . id
string
Tweet id.
data . replies [] . retweetedTweet . url
string nullable
Canonical public URL for the tweet when available.
data . replies [] . retweetedTweet . text
string
Full tweet text when available.
data . replies [] . retweetedTweet . createdAt
string nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
data . replies [] . retweetedTweet . createdAtUnix
integer nullable
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
data . replies [] . retweetedTweet . createdAtLabel
string nullable
Human-readable creation timestamp string when available.
data . replies [] . retweetedTweet . language
string nullable
Language code for the tweet when available.
data . replies [] . retweetedTweet . conversationId
string nullable
Conversation identifier when supplied.
data . replies [] . retweetedTweet . inReplyToStatusId
string nullable
Parent post identifier when this post is a reply.
data . replies [] . retweetedTweet . inReplyToUserId
string nullable optional
Parent post author user id when this post is a reply.
data . replies [] . retweetedTweet . inReplyToScreenName
string nullable optional
Parent post author handle when this post is a reply.
data . replies [] . retweetedTweet . quotedStatusId
string nullable
Quoted post identifier when this post quotes another.
data . replies [] . retweetedTweet . retweetTweetId
string nullable
Original post identifier when this post is an engagement repost.
data . replies [] . retweetedTweet . author object nullable
Author metadata for the tweet when available.
data . replies [] . retweetedTweet . author . handle
string
Author handle without the leading @.
data . replies [] . retweetedTweet . author . displayName
string nullable
Display name shown for the author.
data . replies [] . retweetedTweet . author . avatarUrl
string nullable
Profile image URL for the author when available.
data . replies [] . retweetedTweet . author . profileUrl
string nullable
Canonical public profile URL for the author when available.
data . replies [] . retweetedTweet . author . verified
boolean
Whether the author has legacy verification on X.
data . replies [] . retweetedTweet . author . blueVerified
boolean
Whether the author has paid blue verification on X.
data . replies [] . retweetedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . replies [] . retweetedTweet . author . bio
string nullable optional
Author profile bio when available.
data . replies [] . retweetedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . replies [] . retweetedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . replies [] . retweetedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . replies [] . retweetedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . replies [] . retweetedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . replies [] . retweetedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . replies [] . retweetedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . replies [] . retweetedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . replies [] . retweetedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . replies [] . retweetedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . replies [] . retweetedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . replies [] . retweetedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . replies [] . retweetedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . replies [] . retweetedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . replies [] . retweetedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . replies [] . retweetedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . replies [] . retweetedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . replies [] . retweetedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . replies [] . retweetedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . replies [] . retweetedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . replies [] . 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 . replies [] . retweetedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . replies [] . retweetedTweet . author . metrics . followers
integer
Follower count from X.
data . replies [] . retweetedTweet . author . metrics . following
integer
Following (friends) count from X.
data . replies [] . retweetedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . replies [] . retweetedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . replies [] . retweetedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . replies [] . retweetedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . replies [] . retweetedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . replies [] . retweetedTweet . metrics object
Engagement metrics for a tweet.
data . replies [] . retweetedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: likes, retweets, replies, quotes, views, bookmarkCount (comma-separated)
data . replies [] . retweetedTweet . metrics . availableFields []
string optional
one of: likes, retweets, replies, quotes, views, bookmarkCount
data . replies [] . retweetedTweet . metrics . likes
integer
Like count.
data . replies [] . retweetedTweet . metrics . retweets
integer
Retweet count.
data . replies [] . retweetedTweet . metrics . replies
integer
Reply count.
data . replies [] . retweetedTweet . metrics . quotes
integer
Quote count.
data . replies [] . retweetedTweet . metrics . views
integer nullable
View count when available.
data . replies [] . retweetedTweet . metrics . bookmarkCount
integer nullable
Bookmark count when available.
data . replies [] . retweetedTweet . media array
Media attachments returned for the tweet.
data . replies [] . retweetedTweet . media [] . url
string
Direct media URL when available.
data . replies [] . retweetedTweet . media [] . type
string
Media type when Social Fetch can classify it confidently.
one of: photo, video, animated_gif
data . replies [] . retweetedTweet . media [] . thumbnailUrl
string optional
Poster or thumbnail URL for video media when distinguishable.
data . replies [] . retweetedTweet . media [] . contentType
string optional
MIME type reported for streamed media.
data . replies [] . retweetedTweet . media [] . bitrate
integer optional
Bitrate in bits per second when supplied for streamed media.
data . replies [] . retweetedTweet . media [] . width
integer optional
Width in pixels when available.
data . replies [] . retweetedTweet . media [] . height
integer optional
Height in pixels when available.
data . replies [] . retweetedTweet . media [] . id
string optional
X media id. Video variants of the same attachment share one id.
data . replies [] . retweetedTweet . media [] . altText
string nullable optional
Alternative text for the media when provided.
data . replies [] . retweetedTweet . media [] . durationMs
integer optional
Video or GIF duration in milliseconds when known.
data . replies [] . retweetedTweet . expandedUrl
string nullable
Expanded URL attached to the tweet when available.
data . replies [] . retweetedTweet . isRetweet
boolean
Whether the tweet is marked as a retweet.
data . replies [] . retweetedTweet . isReply
boolean optional
Whether the tweet is a reply to another post.
data . replies [] . retweetedTweet . isQuote
boolean optional
Whether the tweet quotes another post.
data . replies [] . retweetedTweet . source
string nullable
Source label such as `Twitter Web App` when available.
data . replies [] . retweetedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . replies [] . retweetedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . replies [] . 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 . replies [] . retweetedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . replies [] . 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 . replies [] . retweetedTweet . possiblySensitive
boolean nullable optional
Whether X marks the content sensitive.
data . replies [] . retweetedTweet . entities object optional
Hashtags, mentions, links, and cashtags in the tweet text.
data . replies [] . retweetedTweet . entities . hashtags array
Hashtag entities.
data . replies [] . retweetedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . replies [] . retweetedTweet . entities . userMentions array
User mention entities.
data . replies [] . retweetedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . replies [] . retweetedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . replies [] . retweetedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . replies [] . retweetedTweet . entities . urls array
URL entities.
data . replies [] . retweetedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . replies [] . retweetedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . replies [] . retweetedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . replies [] . retweetedTweet . entities . symbols array
Symbol entities.
data . replies [] . retweetedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . replies [] . retweetedTweet . editInfo object optional
Edit metadata when the tweet is editable or edited.
data . replies [] . retweetedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . replies [] . retweetedTweet . editInfo . editTweetIds []
string optional
data . replies [] . retweetedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . replies [] . retweetedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . replies [] . retweetedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . replies [] . retweetedTweet . card object nullable optional
Link preview card when the tweet has one.
data . replies [] . retweetedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . replies [] . retweetedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . replies [] . retweetedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . replies [] . retweetedTweet . card . title
string nullable
Preview title of the linked page.
data . replies [] . retweetedTweet . card . description
string nullable
Preview description of the linked page.
data . replies [] . retweetedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . replies [] . retweetedTweet . card . imageUrl
string nullable
Preview image URL.
data . replies [] . retweetedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . replies [] . retweetedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . replies [] . retweetedTweet . poll object nullable optional
Poll when the tweet contains one.
data . replies [] . retweetedTweet . poll . id
string nullable
Poll id.
data . replies [] . retweetedTweet . poll . options array nullable
Poll choices.
data . replies [] . retweetedTweet . poll . options [] . id
string nullable
Poll choice id.
data . replies [] . retweetedTweet . poll . options [] . label
string nullable
Poll choice label.
data . replies [] . retweetedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . replies [] . retweetedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . replies [] . retweetedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . replies [] . retweetedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . replies [] . retweetedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . replies [] . retweetedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . replies [] . retweetedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . replies [] . retweetedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . replies [] . retweetedTweet . article . title
string nullable
Article title.
data . replies [] . retweetedTweet . article . previewText
string nullable
Short preview of the article body.
data . replies [] . retweetedTweet . article . id
string nullable optional
X article id.
data . replies [] . retweetedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . replies [] . retweetedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . replies [] . retweetedTweet . place object nullable optional
Tagged location when the author added one.
data . replies [] . retweetedTweet . place . id
string nullable
X place id.
data . replies [] . retweetedTweet . place . name
string nullable
Short place name.
data . replies [] . retweetedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . replies [] . retweetedTweet . place . country
string nullable
Country name.
data . replies [] . retweetedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . replies [] . retweetedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . replies [] . retweetedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . replies [] . retweetedTweet . communityNote . id
string nullable
Community Note id.
data . replies [] . retweetedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . replies [] . retweetedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . replies [] . retweetedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . replies [] . retweetedTweet . communityNote . sourceUrls []
string optional
data . replies [] . retweetedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . replies [] . retweetedTweet . quotedTweet object nullable optional
Tweet quoted by the reposted tweet, when the repost is of a quote tweet.
data . replies [] . retweetedTweet . quotedTweet . id
string
Tweet id.
data . replies [] . retweetedTweet . quotedTweet . url
string nullable
Canonical public URL for the tweet when available.
data . replies [] . retweetedTweet . quotedTweet . text
string
Full tweet text when available.
data . replies [] . retweetedTweet . quotedTweet . createdAt
string nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
data . replies [] . retweetedTweet . quotedTweet . createdAtUnix
integer nullable
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
data . replies [] . retweetedTweet . quotedTweet . createdAtLabel
string nullable
Human-readable creation timestamp string when available.
data . replies [] . retweetedTweet . quotedTweet . language
string nullable
Language code for the tweet when available.
data . replies [] . retweetedTweet . quotedTweet . conversationId
string nullable
Conversation identifier when supplied.
data . replies [] . retweetedTweet . quotedTweet . inReplyToStatusId
string nullable
Parent post identifier when this post is a reply.
data . replies [] . retweetedTweet . quotedTweet . inReplyToUserId
string nullable optional
Parent post author user id when this post is a reply.
data . replies [] . retweetedTweet . quotedTweet . inReplyToScreenName
string nullable optional
Parent post author handle when this post is a reply.
data . replies [] . retweetedTweet . quotedTweet . quotedStatusId
string nullable
Quoted post identifier when this post quotes another.
data . replies [] . retweetedTweet . quotedTweet . retweetTweetId
string nullable
Original post identifier when this post is an engagement repost.
data . replies [] . retweetedTweet . quotedTweet . author object nullable
Author metadata for the tweet when available.
data . replies [] . retweetedTweet . quotedTweet . author . handle
string
Author handle without the leading @.
data . replies [] . retweetedTweet . quotedTweet . author . displayName
string nullable
Display name shown for the author.
data . replies [] . retweetedTweet . quotedTweet . author . avatarUrl
string nullable
Profile image URL for the author when available.
data . replies [] . retweetedTweet . quotedTweet . author . profileUrl
string nullable
Canonical public profile URL for the author when available.
data . replies [] . retweetedTweet . quotedTweet . author . verified
boolean
Whether the author has legacy verification on X.
data . replies [] . retweetedTweet . quotedTweet . author . blueVerified
boolean
Whether the author has paid blue verification on X.
data . replies [] . retweetedTweet . quotedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . replies [] . retweetedTweet . quotedTweet . author . bio
string nullable optional
Author profile bio when available.
data . replies [] . retweetedTweet . quotedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . replies [] . retweetedTweet . quotedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . replies [] . retweetedTweet . quotedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . replies [] . retweetedTweet . quotedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . replies [] . retweetedTweet . quotedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . replies [] . retweetedTweet . quotedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . replies [] . retweetedTweet . quotedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . replies [] . retweetedTweet . quotedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . replies [] . retweetedTweet . quotedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . replies [] . retweetedTweet . quotedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . replies [] . retweetedTweet . quotedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . replies [] . retweetedTweet . quotedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . replies [] . retweetedTweet . quotedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . replies [] . retweetedTweet . quotedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . replies [] . retweetedTweet . quotedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . replies [] . retweetedTweet . quotedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . replies [] . retweetedTweet . quotedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . replies [] . retweetedTweet . quotedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . replies [] . retweetedTweet . quotedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . replies [] . retweetedTweet . quotedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . replies [] . 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 . replies [] . retweetedTweet . quotedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . replies [] . retweetedTweet . quotedTweet . author . metrics . followers
integer
Follower count from X.
data . replies [] . retweetedTweet . quotedTweet . author . metrics . following
integer
Following (friends) count from X.
data . replies [] . retweetedTweet . quotedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . replies [] . retweetedTweet . quotedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . replies [] . retweetedTweet . quotedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . replies [] . retweetedTweet . quotedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . replies [] . retweetedTweet . quotedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . replies [] . retweetedTweet . quotedTweet . metrics object
Engagement metrics for a tweet.
data . replies [] . retweetedTweet . quotedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: likes, retweets, replies, quotes, views, bookmarkCount (comma-separated)
data . replies [] . retweetedTweet . quotedTweet . metrics . availableFields []
string optional
one of: likes, retweets, replies, quotes, views, bookmarkCount
data . replies [] . retweetedTweet . quotedTweet . metrics . likes
integer
Like count.
data . replies [] . retweetedTweet . quotedTweet . metrics . retweets
integer
Retweet count.
data . replies [] . retweetedTweet . quotedTweet . metrics . replies
integer
Reply count.
data . replies [] . retweetedTweet . quotedTweet . metrics . quotes
integer
Quote count.
data . replies [] . retweetedTweet . quotedTweet . metrics . views
integer nullable
View count when available.
data . replies [] . retweetedTweet . quotedTweet . metrics . bookmarkCount
integer nullable
Bookmark count when available.
data . replies [] . retweetedTweet . quotedTweet . media array
Media attachments returned for the tweet.
data . replies [] . retweetedTweet . quotedTweet . media [] . url
string
Direct media URL when available.
data . replies [] . retweetedTweet . quotedTweet . media [] . type
string
Media type when Social Fetch can classify it confidently.
one of: photo, video, animated_gif
data . replies [] . retweetedTweet . quotedTweet . media [] . thumbnailUrl
string optional
Poster or thumbnail URL for video media when distinguishable.
data . replies [] . retweetedTweet . quotedTweet . media [] . contentType
string optional
MIME type reported for streamed media.
data . replies [] . retweetedTweet . quotedTweet . media [] . bitrate
integer optional
Bitrate in bits per second when supplied for streamed media.
data . replies [] . retweetedTweet . quotedTweet . media [] . width
integer optional
Width in pixels when available.
data . replies [] . retweetedTweet . quotedTweet . media [] . height
integer optional
Height in pixels when available.
data . replies [] . retweetedTweet . quotedTweet . media [] . id
string optional
X media id. Video variants of the same attachment share one id.
data . replies [] . retweetedTweet . quotedTweet . media [] . altText
string nullable optional
Alternative text for the media when provided.
data . replies [] . retweetedTweet . quotedTweet . media [] . durationMs
integer optional
Video or GIF duration in milliseconds when known.
data . replies [] . retweetedTweet . quotedTweet . expandedUrl
string nullable
Expanded URL attached to the tweet when available.
data . replies [] . retweetedTweet . quotedTweet . isRetweet
boolean
Whether the tweet is marked as a retweet.
data . replies [] . retweetedTweet . quotedTweet . isReply
boolean optional
Whether the tweet is a reply to another post.
data . replies [] . retweetedTweet . quotedTweet . isQuote
boolean optional
Whether the tweet quotes another post.
data . replies [] . retweetedTweet . quotedTweet . source
string nullable
Source label such as `Twitter Web App` when available.
data . replies [] . retweetedTweet . quotedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . replies [] . retweetedTweet . quotedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . replies [] . 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 . replies [] . retweetedTweet . quotedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . replies [] . 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 . replies [] . retweetedTweet . quotedTweet . possiblySensitive
boolean nullable optional
Whether X marks the content sensitive.
data . replies [] . retweetedTweet . quotedTweet . entities object optional
Hashtags, mentions, links, and cashtags in the tweet text.
data . replies [] . retweetedTweet . quotedTweet . entities . hashtags array
Hashtag entities.
data . replies [] . retweetedTweet . quotedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . replies [] . retweetedTweet . quotedTweet . entities . userMentions array
User mention entities.
data . replies [] . retweetedTweet . quotedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . replies [] . retweetedTweet . quotedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . replies [] . retweetedTweet . quotedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . replies [] . retweetedTweet . quotedTweet . entities . urls array
URL entities.
data . replies [] . retweetedTweet . quotedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . replies [] . retweetedTweet . quotedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . replies [] . retweetedTweet . quotedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . replies [] . retweetedTweet . quotedTweet . entities . symbols array
Symbol entities.
data . replies [] . retweetedTweet . quotedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . replies [] . retweetedTweet . quotedTweet . editInfo object optional
Edit metadata when the tweet is editable or edited.
data . replies [] . retweetedTweet . quotedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . replies [] . retweetedTweet . quotedTweet . editInfo . editTweetIds []
string optional
data . replies [] . retweetedTweet . quotedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . replies [] . retweetedTweet . quotedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . replies [] . retweetedTweet . quotedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . replies [] . retweetedTweet . quotedTweet . card object nullable optional
Link preview card when the tweet has one.
data . replies [] . retweetedTweet . quotedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . replies [] . retweetedTweet . quotedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . replies [] . retweetedTweet . quotedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . replies [] . retweetedTweet . quotedTweet . card . title
string nullable
Preview title of the linked page.
data . replies [] . retweetedTweet . quotedTweet . card . description
string nullable
Preview description of the linked page.
data . replies [] . retweetedTweet . quotedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . replies [] . retweetedTweet . quotedTweet . card . imageUrl
string nullable
Preview image URL.
data . replies [] . retweetedTweet . quotedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . replies [] . retweetedTweet . quotedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . replies [] . retweetedTweet . quotedTweet . poll object nullable optional
Poll when the tweet contains one.
data . replies [] . retweetedTweet . quotedTweet . poll . id
string nullable
Poll id.
data . replies [] . retweetedTweet . quotedTweet . poll . options array nullable
Poll choices.
data . replies [] . retweetedTweet . quotedTweet . poll . options [] . id
string nullable
Poll choice id.
data . replies [] . retweetedTweet . quotedTweet . poll . options [] . label
string nullable
Poll choice label.
data . replies [] . retweetedTweet . quotedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . replies [] . retweetedTweet . quotedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . replies [] . retweetedTweet . quotedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . replies [] . retweetedTweet . quotedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . replies [] . retweetedTweet . quotedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . replies [] . retweetedTweet . quotedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . replies [] . retweetedTweet . quotedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . replies [] . retweetedTweet . quotedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . replies [] . retweetedTweet . quotedTweet . article . title
string nullable
Article title.
data . replies [] . retweetedTweet . quotedTweet . article . previewText
string nullable
Short preview of the article body.
data . replies [] . retweetedTweet . quotedTweet . article . id
string nullable optional
X article id.
data . replies [] . retweetedTweet . quotedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . replies [] . retweetedTweet . quotedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . replies [] . retweetedTweet . quotedTweet . place object nullable optional
Tagged location when the author added one.
data . replies [] . retweetedTweet . quotedTweet . place . id
string nullable
X place id.
data . replies [] . retweetedTweet . quotedTweet . place . name
string nullable
Short place name.
data . replies [] . retweetedTweet . quotedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . replies [] . retweetedTweet . quotedTweet . place . country
string nullable
Country name.
data . replies [] . retweetedTweet . quotedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . replies [] . retweetedTweet . quotedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . replies [] . retweetedTweet . quotedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . replies [] . retweetedTweet . quotedTweet . communityNote . id
string nullable
Community Note id.
data . replies [] . retweetedTweet . quotedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . replies [] . retweetedTweet . quotedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . replies [] . retweetedTweet . quotedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . replies [] . retweetedTweet . quotedTweet . communityNote . sourceUrls []
string optional
data . replies [] . retweetedTweet . quotedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
Pass `nextCursor` as `cursor` to `GET /v1/twitter/tweets/replies` with the same `url` to continue the replies. Omitted when `trim=true`.
data . repliesPage . nextCursor
string nullable
Cursor to pass as `cursor` in the next request when another page exists.
data . repliesPage . hasMore
boolean
Whether another page can be requested.
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.