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