List Twitter profile tweets List tweets from an X profile by handle or numeric user id.
GET /v1/twitter/profiles/{handle}/tweets
x-api-key* string header
API key (`sfk_...`)
handle* string required path
X (Twitter) profile handle without the leading @, or a numeric user id.
limit integer optional query
Requested page size (1–100). Best-effort; the actual page size may differ.
≥ 1 · ≤ 100
cursor string optional query
Opaque pagination cursor returned by a previous response.
min 1 chars
includeReplies boolean optional query
When true, includes reply tweets. Defaults to false.
includePinned boolean optional query
When true, includes the pinned tweet when available.
by string optional query
Treat the path value as a handle or a numeric user id. Defaults to id when the value is all digits.
one of: id, handle
Response fields 603 Expand all Collapse all Collapse all Endpoint-specific response payload.
Whether the handle resolved for this list request. `found` means the handle resolved; `private` means the account is protected, so `tweets` is empty and `profile` is returned when available; `not_found` means it did not resolve. `found` may still include an empty `tweets` array when the profile has no eligible tweets in the returned page.
one of: found, private, not_found
Collection coverage and pagination outcome.
data . collectionQuality . receivedCount
integer
data . collectionQuality . acceptedCount
integer
data . collectionQuality . droppedCount
integer
data . collectionQuality . termination
string
one of: continuation, exhausted, anomalous
data . collectionQuality . reason
string
one of: next_page, end_of_list, empty_continuation, repeated_cursor, invalid_rows
Profile card from the resolved user when the handle was looked up, otherwise from the first tweet author; null when neither is available.
data . profile . platform
string
Social platform for this profile.
data . profile . handle
string
Screen name without @.
data . profile . displayName
string nullable
Display name for the profile.
data . profile . bio
string nullable
Profile bio when the account includes one.
data . profile . location
string nullable
Profile location when the account includes one.
data . profile . avatarUrl
string nullable
Best available square avatar URL.
data . profile . bannerUrl
string nullable
Profile banner image URL when available.
data . profile . verified
boolean
Legacy verified flag from X.
data . profile . blueVerified
boolean
Paid blue verification flag from X.
data . profile . profileUrl
string
Canonical profile URL on x.com.
data . profile . platformUserId
string optional
Numeric user id as a string.
Tweets returned for the requested profile page. May be empty when `lookupStatus` is `found` and no eligible tweets are returned, or when `lookupStatus` is `not_found`.
data . tweets [] . url
string nullable
Canonical public URL for the tweet when available.
Full tweet text when available.
data . tweets [] . createdAt
string
Creation time (ISO-8601).
data . tweets [] . createdAtLabel
string nullable
Human-readable creation timestamp string when available.
data . tweets [] . language
string nullable
Language code for the tweet when available.
data . tweets [] . conversationId
string nullable
Conversation identifier when supplied.
data . tweets [] . inReplyToStatusId
string nullable
Parent post identifier when this post is a reply.
data . tweets [] . inReplyToUserId
string nullable optional
Parent post author user id when this post is a reply.
data . tweets [] . inReplyToScreenName
string nullable optional
Parent post author handle when this post is a reply.
data . tweets [] . quotedStatusId
string nullable
Quoted post identifier when this post quotes another.
data . tweets [] . retweetTweetId
string nullable
Original post identifier when this post is an engagement repost.
Author metadata for the tweet when available.
data . tweets [] . author . handle
string
Author handle without the leading @.
data . tweets [] . author . displayName
string nullable
Display name shown for the author.
data . tweets [] . author . avatarUrl
string nullable
Profile image URL for the author when available.
data . tweets [] . author . profileUrl
string nullable
Canonical public profile URL for the author when available.
data . tweets [] . author . verified
boolean
Whether the author has legacy verification on X.
data . tweets [] . author . blueVerified
boolean
Whether the author has paid blue verification on X.
data . tweets [] . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . tweets [] . author . bio
string nullable optional
Author profile bio when available.
data . tweets [] . author . location
string nullable optional
Location string from the author profile when provided.
data . tweets [] . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . tweets [] . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . tweets [] . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . tweets [] . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . tweets [] . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . tweets [] . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . tweets [] . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . tweets [] . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . tweets [] . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . tweets [] . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . tweets [] . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . tweets [] . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . tweets [] . author . professional . type
string nullable
Professional account type from X, when present.
data . tweets [] . author . professional . category array nullable
Professional categories X shows on the profile.
data . tweets [] . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . tweets [] . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . tweets [] . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . tweets [] . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . tweets [] . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . tweets [] . author . metrics . availableFields array optional
Metrics actually reported; an unavailable legacy numeric value must not be treated as an observation.
any of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount (comma-separated)
data . tweets [] . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . tweets [] . author . metrics . followers
integer
Follower count from X.
data . tweets [] . author . metrics . following
integer
Following (friends) count from X.
data . tweets [] . author . metrics . tweets
integer
Total post (status) count from X.
data . tweets [] . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . tweets [] . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . tweets [] . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . tweets [] . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
Engagement metrics for a tweet.
data . tweets [] . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: likes, retweets, replies, quotes, views, bookmarkCount (comma-separated)
data . tweets [] . metrics . availableFields []
string optional
one of: likes, retweets, replies, quotes, views, bookmarkCount
data . tweets [] . metrics . likes
integer
Like count.
data . tweets [] . metrics . retweets
integer
Retweet count.
data . tweets [] . metrics . replies
integer
Reply count.
data . tweets [] . metrics . quotes
integer
Quote count.
data . tweets [] . metrics . views
integer nullable
View count when available.
data . tweets [] . metrics . bookmarkCount
integer nullable
Bookmark count when available.
Media attachments returned for the tweet.
data . tweets [] . media [] . url
string
Direct media URL when available.
data . tweets [] . media [] . type
string
Media type when Social Fetch can classify it confidently.
one of: photo, video, animated_gif
data . tweets [] . media [] . thumbnailUrl
string optional
Poster or thumbnail URL for video media when distinguishable.
data . tweets [] . media [] . contentType
string optional
MIME type reported for streamed media.
data . tweets [] . media [] . bitrate
integer optional
Bitrate in bits per second when supplied for streamed media.
data . tweets [] . media [] . width
integer optional
Width in pixels when available.
data . tweets [] . media [] . height
integer optional
Height in pixels when available.
data . tweets [] . media [] . id
string optional
X media id. Video variants of the same attachment share one id.
data . tweets [] . media [] . altText
string nullable optional
Alternative text for the media when provided.
data . tweets [] . media [] . durationMs
integer optional
Video or GIF duration in milliseconds when known.
data . tweets [] . expandedUrl
string nullable
Expanded URL attached to the tweet when available.
data . tweets [] . isRetweet
boolean
Whether the tweet is marked as a retweet.
data . tweets [] . isReply
boolean optional
Whether the tweet is a reply to another post.
data . tweets [] . isQuote
boolean optional
Whether the tweet quotes another post.
data . tweets [] . source
string nullable
Source label such as `Twitter Web App` when available.
data . tweets [] . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . tweets [] . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweets [] . isPaidPromotion
boolean nullable optional
Whether the author labeled the tweet as a paid partnership (X's disclosure label). Not X ads or Promote status, which X does not expose on tweets.
data . tweets [] . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweets [] . hasBirdwatchNotes
boolean nullable optional
X's Community Notes flag for this tweet. It can be false while a note is shown; use `communityNote` for the note X displays.
data . tweets [] . possiblySensitive
boolean nullable optional
Whether X marks the content sensitive.
Hashtags, mentions, links, and cashtags in the tweet text.
data . tweets [] . entities . hashtags array
Hashtag entities.
data . tweets [] . entities . hashtags [] . text
string
Hashtag text without #.
data . tweets [] . entities . userMentions array
User mention entities.
data . tweets [] . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweets [] . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweets [] . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweets [] . entities . urls array
URL entities.
data . tweets [] . entities . urls [] . url
string
Short URL as it appears in text.
data . tweets [] . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweets [] . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweets [] . entities . symbols array
Symbol entities.
data . tweets [] . entities . symbols [] . text
string
Cashtag or symbol text.
Edit metadata when the tweet is editable or edited.
data . tweets [] . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweets [] . editInfo . editTweetIds []
string optional
data . tweets [] . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweets [] . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweets [] . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
Link preview card when the tweet has one.
data . tweets [] . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweets [] . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweets [] . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweets [] . card . title
string nullable
Preview title of the linked page.
data . tweets [] . card . description
string nullable
Preview description of the linked page.
data . tweets [] . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweets [] . card . imageUrl
string nullable
Preview image URL.
data . tweets [] . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweets [] . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
Poll when the tweet contains one.
data . tweets [] . poll . id
string nullable
Poll id.
data . tweets [] . poll . options array nullable
Poll choices.
data . tweets [] . poll . options [] . id
string nullable
Poll choice id.
data . tweets [] . poll . options [] . label
string nullable
Poll choice label.
data . tweets [] . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweets [] . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweets [] . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweets [] . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweets [] . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweets [] . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweets [] . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
X article when the tweet is a long-form article.
data . tweets [] . article . title
string nullable
Article title.
data . tweets [] . article . previewText
string nullable
Short preview of the article body.
data . tweets [] . article . id
string nullable optional
X article id.
data . tweets [] . article . text
string nullable optional
Full article body text when X returns it.
data . tweets [] . article . coverImageUrl
string nullable optional
Article cover image URL when available.
Tagged location when the author added one.
data . tweets [] . place . id
string nullable
X place id.
data . tweets [] . place . name
string nullable
Short place name.
data . tweets [] . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweets [] . place . country
string nullable
Country name.
data . tweets [] . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweets [] . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . tweets [] . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . tweets [] . communityNote . id
string nullable
Community Note id.
data . tweets [] . communityNote . text
string nullable
Note text shown under the tweet.
data . tweets [] . communityNote . url
string nullable
Public URL of the note on X.
data . tweets [] . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweets [] . communityNote . sourceUrls []
string optional
data . tweets [] . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . tweets [] . quotedTweet object nullable optional
Quoted tweet expanded one level (no further nesting).
data . tweets [] . quotedTweet . id
string
Tweet id.
data . tweets [] . quotedTweet . url
string nullable
Canonical public URL for the tweet when available.
data . tweets [] . quotedTweet . text
string
Full tweet text when available.
data . tweets [] . quotedTweet . createdAt
string
Creation time (ISO-8601).
data . tweets [] . quotedTweet . createdAtUnix
integer
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
data . tweets [] . quotedTweet . createdAtLabel
string nullable
Human-readable creation timestamp string when available.
data . tweets [] . quotedTweet . language
string nullable
Language code for the tweet when available.
data . tweets [] . quotedTweet . conversationId
string nullable
Conversation identifier when supplied.
data . tweets [] . quotedTweet . inReplyToStatusId
string nullable
Parent post identifier when this post is a reply.
data . tweets [] . quotedTweet . inReplyToUserId
string nullable optional
Parent post author user id when this post is a reply.
data . tweets [] . quotedTweet . inReplyToScreenName
string nullable optional
Parent post author handle when this post is a reply.
data . tweets [] . quotedTweet . quotedStatusId
string nullable
Quoted post identifier when this post quotes another.
data . tweets [] . quotedTweet . retweetTweetId
string nullable
Original post identifier when this post is an engagement repost.
data . tweets [] . quotedTweet . author object nullable
Author metadata for the tweet when available.
data . tweets [] . quotedTweet . author . handle
string
Author handle without the leading @.
data . tweets [] . quotedTweet . author . displayName
string nullable
Display name shown for the author.
data . tweets [] . quotedTweet . author . avatarUrl
string nullable
Profile image URL for the author when available.
data . tweets [] . quotedTweet . author . profileUrl
string nullable
Canonical public profile URL for the author when available.
data . tweets [] . quotedTweet . author . verified
boolean
Whether the author has legacy verification on X.
data . tweets [] . quotedTweet . author . blueVerified
boolean
Whether the author has paid blue verification on X.
data . tweets [] . quotedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . tweets [] . quotedTweet . author . bio
string nullable optional
Author profile bio when available.
data . tweets [] . quotedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . tweets [] . quotedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . tweets [] . quotedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . tweets [] . quotedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . tweets [] . quotedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . tweets [] . quotedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . tweets [] . quotedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . tweets [] . quotedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . tweets [] . quotedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . tweets [] . quotedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . tweets [] . quotedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . tweets [] . quotedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . tweets [] . quotedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . tweets [] . quotedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . tweets [] . quotedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . tweets [] . quotedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . tweets [] . quotedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . tweets [] . quotedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . tweets [] . quotedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . tweets [] . quotedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . tweets [] . quotedTweet . author . metrics . availableFields array optional
Metrics actually reported; an unavailable legacy numeric value must not be treated as an observation.
any of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount (comma-separated)
data . tweets [] . quotedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . tweets [] . quotedTweet . author . metrics . followers
integer
Follower count from X.
data . tweets [] . quotedTweet . author . metrics . following
integer
Following (friends) count from X.
data . tweets [] . quotedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . tweets [] . quotedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . tweets [] . quotedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . tweets [] . quotedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . tweets [] . quotedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . tweets [] . quotedTweet . metrics object
Engagement metrics for a tweet.
data . tweets [] . quotedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: likes, retweets, replies, quotes, views, bookmarkCount (comma-separated)
data . tweets [] . quotedTweet . metrics . availableFields []
string optional
one of: likes, retweets, replies, quotes, views, bookmarkCount
data . tweets [] . quotedTweet . metrics . likes
integer
Like count.
data . tweets [] . quotedTweet . metrics . retweets
integer
Retweet count.
data . tweets [] . quotedTweet . metrics . replies
integer
Reply count.
data . tweets [] . quotedTweet . metrics . quotes
integer
Quote count.
data . tweets [] . quotedTweet . metrics . views
integer nullable
View count when available.
data . tweets [] . quotedTweet . metrics . bookmarkCount
integer nullable
Bookmark count when available.
data . tweets [] . quotedTweet . media array
Media attachments returned for the tweet.
data . tweets [] . quotedTweet . media [] . url
string
Direct media URL when available.
data . tweets [] . quotedTweet . media [] . type
string
Media type when Social Fetch can classify it confidently.
one of: photo, video, animated_gif
data . tweets [] . quotedTweet . media [] . thumbnailUrl
string optional
Poster or thumbnail URL for video media when distinguishable.
data . tweets [] . quotedTweet . media [] . contentType
string optional
MIME type reported for streamed media.
data . tweets [] . quotedTweet . media [] . bitrate
integer optional
Bitrate in bits per second when supplied for streamed media.
data . tweets [] . quotedTweet . media [] . width
integer optional
Width in pixels when available.
data . tweets [] . quotedTweet . media [] . height
integer optional
Height in pixels when available.
data . tweets [] . quotedTweet . media [] . id
string optional
X media id. Video variants of the same attachment share one id.
data . tweets [] . quotedTweet . media [] . altText
string nullable optional
Alternative text for the media when provided.
data . tweets [] . quotedTweet . media [] . durationMs
integer optional
Video or GIF duration in milliseconds when known.
data . tweets [] . quotedTweet . expandedUrl
string nullable
Expanded URL attached to the tweet when available.
data . tweets [] . quotedTweet . isRetweet
boolean
Whether the tweet is marked as a retweet.
data . tweets [] . quotedTweet . isReply
boolean optional
Whether the tweet is a reply to another post.
data . tweets [] . quotedTweet . isQuote
boolean optional
Whether the tweet quotes another post.
data . tweets [] . quotedTweet . source
string nullable
Source label such as `Twitter Web App` when available.
data . tweets [] . quotedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . tweets [] . quotedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweets [] . quotedTweet . isPaidPromotion
boolean nullable optional
Whether the author labeled the tweet as a paid partnership (X's disclosure label). Not X ads or Promote status, which X does not expose on tweets.
data . tweets [] . quotedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweets [] . quotedTweet . hasBirdwatchNotes
boolean nullable optional
X's Community Notes flag for this tweet. It can be false while a note is shown; use `communityNote` for the note X displays.
data . tweets [] . quotedTweet . possiblySensitive
boolean nullable optional
Whether X marks the content sensitive.
data . tweets [] . quotedTweet . entities object optional
Hashtags, mentions, links, and cashtags in the tweet text.
data . tweets [] . quotedTweet . entities . hashtags array
Hashtag entities.
data . tweets [] . quotedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . tweets [] . quotedTweet . entities . userMentions array
User mention entities.
data . tweets [] . quotedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweets [] . quotedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweets [] . quotedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweets [] . quotedTweet . entities . urls array
URL entities.
data . tweets [] . quotedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . tweets [] . quotedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweets [] . quotedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweets [] . quotedTweet . entities . symbols array
Symbol entities.
data . tweets [] . quotedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . tweets [] . quotedTweet . editInfo object optional
Edit metadata when the tweet is editable or edited.
data . tweets [] . quotedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweets [] . quotedTweet . editInfo . editTweetIds []
string optional
data . tweets [] . quotedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweets [] . quotedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweets [] . quotedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . tweets [] . quotedTweet . card object nullable optional
Link preview card when the tweet has one.
data . tweets [] . quotedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweets [] . quotedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweets [] . quotedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweets [] . quotedTweet . card . title
string nullable
Preview title of the linked page.
data . tweets [] . quotedTweet . card . description
string nullable
Preview description of the linked page.
data . tweets [] . quotedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweets [] . quotedTweet . card . imageUrl
string nullable
Preview image URL.
data . tweets [] . quotedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweets [] . quotedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . tweets [] . quotedTweet . poll object nullable optional
Poll when the tweet contains one.
data . tweets [] . quotedTweet . poll . id
string nullable
Poll id.
data . tweets [] . quotedTweet . poll . options array nullable
Poll choices.
data . tweets [] . quotedTweet . poll . options [] . id
string nullable
Poll choice id.
data . tweets [] . quotedTweet . poll . options [] . label
string nullable
Poll choice label.
data . tweets [] . quotedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweets [] . quotedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweets [] . quotedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweets [] . quotedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweets [] . quotedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweets [] . quotedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweets [] . quotedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . tweets [] . quotedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . tweets [] . quotedTweet . article . title
string nullable
Article title.
data . tweets [] . quotedTweet . article . previewText
string nullable
Short preview of the article body.
data . tweets [] . quotedTweet . article . id
string nullable optional
X article id.
data . tweets [] . quotedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . tweets [] . quotedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . tweets [] . quotedTweet . place object nullable optional
Tagged location when the author added one.
data . tweets [] . quotedTweet . place . id
string nullable
X place id.
data . tweets [] . quotedTweet . place . name
string nullable
Short place name.
data . tweets [] . quotedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweets [] . quotedTweet . place . country
string nullable
Country name.
data . tweets [] . quotedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweets [] . quotedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . tweets [] . quotedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . tweets [] . quotedTweet . communityNote . id
string nullable
Community Note id.
data . tweets [] . quotedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . tweets [] . quotedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . tweets [] . quotedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweets [] . quotedTweet . communityNote . sourceUrls []
string optional
data . tweets [] . quotedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . tweets [] . retweetedTweet object nullable optional
Reposted tweet expanded one level, plus its quoted tweet when it is a quote.
data . tweets [] . retweetedTweet . id
string
Tweet id.
data . tweets [] . retweetedTweet . url
string nullable
Canonical public URL for the tweet when available.
data . tweets [] . retweetedTweet . text
string
Full tweet text when available.
data . tweets [] . retweetedTweet . createdAt
string
Creation time (ISO-8601).
data . tweets [] . retweetedTweet . createdAtUnix
integer
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
data . tweets [] . retweetedTweet . createdAtLabel
string nullable
Human-readable creation timestamp string when available.
data . tweets [] . retweetedTweet . language
string nullable
Language code for the tweet when available.
data . tweets [] . retweetedTweet . conversationId
string nullable
Conversation identifier when supplied.
data . tweets [] . retweetedTweet . inReplyToStatusId
string nullable
Parent post identifier when this post is a reply.
data . tweets [] . retweetedTweet . inReplyToUserId
string nullable optional
Parent post author user id when this post is a reply.
data . tweets [] . retweetedTweet . inReplyToScreenName
string nullable optional
Parent post author handle when this post is a reply.
data . tweets [] . retweetedTweet . quotedStatusId
string nullable
Quoted post identifier when this post quotes another.
data . tweets [] . retweetedTweet . retweetTweetId
string nullable
Original post identifier when this post is an engagement repost.
data . tweets [] . retweetedTweet . author object nullable
Author metadata for the tweet when available.
data . tweets [] . retweetedTweet . author . handle
string
Author handle without the leading @.
data . tweets [] . retweetedTweet . author . displayName
string nullable
Display name shown for the author.
data . tweets [] . retweetedTweet . author . avatarUrl
string nullable
Profile image URL for the author when available.
data . tweets [] . retweetedTweet . author . profileUrl
string nullable
Canonical public profile URL for the author when available.
data . tweets [] . retweetedTweet . author . verified
boolean
Whether the author has legacy verification on X.
data . tweets [] . retweetedTweet . author . blueVerified
boolean
Whether the author has paid blue verification on X.
data . tweets [] . retweetedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . tweets [] . retweetedTweet . author . bio
string nullable optional
Author profile bio when available.
data . tweets [] . retweetedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . tweets [] . retweetedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . tweets [] . retweetedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . tweets [] . retweetedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . tweets [] . retweetedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . tweets [] . retweetedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . tweets [] . retweetedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . tweets [] . retweetedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . tweets [] . retweetedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . tweets [] . retweetedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . tweets [] . retweetedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . tweets [] . retweetedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . tweets [] . retweetedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . tweets [] . retweetedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . tweets [] . retweetedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . tweets [] . retweetedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . tweets [] . retweetedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . tweets [] . retweetedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . tweets [] . retweetedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . tweets [] . retweetedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . tweets [] . retweetedTweet . author . metrics . availableFields array optional
Metrics actually reported; an unavailable legacy numeric value must not be treated as an observation.
any of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount (comma-separated)
data . tweets [] . retweetedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . tweets [] . retweetedTweet . author . metrics . followers
integer
Follower count from X.
data . tweets [] . retweetedTweet . author . metrics . following
integer
Following (friends) count from X.
data . tweets [] . retweetedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . tweets [] . retweetedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . tweets [] . retweetedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . tweets [] . retweetedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . tweets [] . retweetedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . tweets [] . retweetedTweet . metrics object
Engagement metrics for a tweet.
data . tweets [] . retweetedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: likes, retweets, replies, quotes, views, bookmarkCount (comma-separated)
data . tweets [] . retweetedTweet . metrics . availableFields []
string optional
one of: likes, retweets, replies, quotes, views, bookmarkCount
data . tweets [] . retweetedTweet . metrics . likes
integer
Like count.
data . tweets [] . retweetedTweet . metrics . retweets
integer
Retweet count.
data . tweets [] . retweetedTweet . metrics . replies
integer
Reply count.
data . tweets [] . retweetedTweet . metrics . quotes
integer
Quote count.
data . tweets [] . retweetedTweet . metrics . views
integer nullable
View count when available.
data . tweets [] . retweetedTweet . metrics . bookmarkCount
integer nullable
Bookmark count when available.
data . tweets [] . retweetedTweet . media array
Media attachments returned for the tweet.
data . tweets [] . retweetedTweet . media [] . url
string
Direct media URL when available.
data . tweets [] . retweetedTweet . media [] . type
string
Media type when Social Fetch can classify it confidently.
one of: photo, video, animated_gif
data . tweets [] . retweetedTweet . media [] . thumbnailUrl
string optional
Poster or thumbnail URL for video media when distinguishable.
data . tweets [] . retweetedTweet . media [] . contentType
string optional
MIME type reported for streamed media.
data . tweets [] . retweetedTweet . media [] . bitrate
integer optional
Bitrate in bits per second when supplied for streamed media.
data . tweets [] . retweetedTweet . media [] . width
integer optional
Width in pixels when available.
data . tweets [] . retweetedTweet . media [] . height
integer optional
Height in pixels when available.
data . tweets [] . retweetedTweet . media [] . id
string optional
X media id. Video variants of the same attachment share one id.
data . tweets [] . retweetedTweet . media [] . altText
string nullable optional
Alternative text for the media when provided.
data . tweets [] . retweetedTweet . media [] . durationMs
integer optional
Video or GIF duration in milliseconds when known.
data . tweets [] . retweetedTweet . expandedUrl
string nullable
Expanded URL attached to the tweet when available.
data . tweets [] . retweetedTweet . isRetweet
boolean
Whether the tweet is marked as a retweet.
data . tweets [] . retweetedTweet . isReply
boolean optional
Whether the tweet is a reply to another post.
data . tweets [] . retweetedTweet . isQuote
boolean optional
Whether the tweet quotes another post.
data . tweets [] . retweetedTweet . source
string nullable
Source label such as `Twitter Web App` when available.
data . tweets [] . retweetedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . tweets [] . retweetedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweets [] . retweetedTweet . isPaidPromotion
boolean nullable optional
Whether the author labeled the tweet as a paid partnership (X's disclosure label). Not X ads or Promote status, which X does not expose on tweets.
data . tweets [] . retweetedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweets [] . retweetedTweet . hasBirdwatchNotes
boolean nullable optional
X's Community Notes flag for this tweet. It can be false while a note is shown; use `communityNote` for the note X displays.
data . tweets [] . retweetedTweet . possiblySensitive
boolean nullable optional
Whether X marks the content sensitive.
data . tweets [] . retweetedTweet . entities object optional
Hashtags, mentions, links, and cashtags in the tweet text.
data . tweets [] . retweetedTweet . entities . hashtags array
Hashtag entities.
data . tweets [] . retweetedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . tweets [] . retweetedTweet . entities . userMentions array
User mention entities.
data . tweets [] . retweetedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweets [] . retweetedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweets [] . retweetedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweets [] . retweetedTweet . entities . urls array
URL entities.
data . tweets [] . retweetedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . tweets [] . retweetedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweets [] . retweetedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweets [] . retweetedTweet . entities . symbols array
Symbol entities.
data . tweets [] . retweetedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . tweets [] . retweetedTweet . editInfo object optional
Edit metadata when the tweet is editable or edited.
data . tweets [] . retweetedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweets [] . retweetedTweet . editInfo . editTweetIds []
string optional
data . tweets [] . retweetedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweets [] . retweetedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweets [] . retweetedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . tweets [] . retweetedTweet . card object nullable optional
Link preview card when the tweet has one.
data . tweets [] . retweetedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweets [] . retweetedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweets [] . retweetedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweets [] . retweetedTweet . card . title
string nullable
Preview title of the linked page.
data . tweets [] . retweetedTweet . card . description
string nullable
Preview description of the linked page.
data . tweets [] . retweetedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweets [] . retweetedTweet . card . imageUrl
string nullable
Preview image URL.
data . tweets [] . retweetedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweets [] . retweetedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . tweets [] . retweetedTweet . poll object nullable optional
Poll when the tweet contains one.
data . tweets [] . retweetedTweet . poll . id
string nullable
Poll id.
data . tweets [] . retweetedTweet . poll . options array nullable
Poll choices.
data . tweets [] . retweetedTweet . poll . options [] . id
string nullable
Poll choice id.
data . tweets [] . retweetedTweet . poll . options [] . label
string nullable
Poll choice label.
data . tweets [] . retweetedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweets [] . retweetedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweets [] . retweetedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweets [] . retweetedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweets [] . retweetedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweets [] . retweetedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweets [] . retweetedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . tweets [] . retweetedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . tweets [] . retweetedTweet . article . title
string nullable
Article title.
data . tweets [] . retweetedTweet . article . previewText
string nullable
Short preview of the article body.
data . tweets [] . retweetedTweet . article . id
string nullable optional
X article id.
data . tweets [] . retweetedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . tweets [] . retweetedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . tweets [] . retweetedTweet . place object nullable optional
Tagged location when the author added one.
data . tweets [] . retweetedTweet . place . id
string nullable
X place id.
data . tweets [] . retweetedTweet . place . name
string nullable
Short place name.
data . tweets [] . retweetedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweets [] . retweetedTweet . place . country
string nullable
Country name.
data . tweets [] . retweetedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweets [] . retweetedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . tweets [] . retweetedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . tweets [] . retweetedTweet . communityNote . id
string nullable
Community Note id.
data . tweets [] . retweetedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . tweets [] . retweetedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . tweets [] . retweetedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweets [] . retweetedTweet . communityNote . sourceUrls []
string optional
data . tweets [] . retweetedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
data . tweets [] . retweetedTweet . quotedTweet object nullable optional
Tweet quoted by the reposted tweet, when the repost is of a quote tweet.
data . tweets [] . retweetedTweet . quotedTweet . id
string
Tweet id.
data . tweets [] . retweetedTweet . quotedTweet . url
string nullable
Canonical public URL for the tweet when available.
data . tweets [] . retweetedTweet . quotedTweet . text
string
Full tweet text when available.
data . tweets [] . retweetedTweet . quotedTweet . createdAt
string
Creation time (ISO-8601).
data . tweets [] . retweetedTweet . quotedTweet . createdAtUnix
integer
Legacy Unix epoch seconds for tweet creation. Prefer createdAt.
data . tweets [] . retweetedTweet . quotedTweet . createdAtLabel
string nullable
Human-readable creation timestamp string when available.
data . tweets [] . retweetedTweet . quotedTweet . language
string nullable
Language code for the tweet when available.
data . tweets [] . retweetedTweet . quotedTweet . conversationId
string nullable
Conversation identifier when supplied.
data . tweets [] . retweetedTweet . quotedTweet . inReplyToStatusId
string nullable
Parent post identifier when this post is a reply.
data . tweets [] . retweetedTweet . quotedTweet . inReplyToUserId
string nullable optional
Parent post author user id when this post is a reply.
data . tweets [] . retweetedTweet . quotedTweet . inReplyToScreenName
string nullable optional
Parent post author handle when this post is a reply.
data . tweets [] . retweetedTweet . quotedTweet . quotedStatusId
string nullable
Quoted post identifier when this post quotes another.
data . tweets [] . retweetedTweet . quotedTweet . retweetTweetId
string nullable
Original post identifier when this post is an engagement repost.
data . tweets [] . retweetedTweet . quotedTweet . author object nullable
Author metadata for the tweet when available.
data . tweets [] . retweetedTweet . quotedTweet . author . handle
string
Author handle without the leading @.
data . tweets [] . retweetedTweet . quotedTweet . author . displayName
string nullable
Display name shown for the author.
data . tweets [] . retweetedTweet . quotedTweet . author . avatarUrl
string nullable
Profile image URL for the author when available.
data . tweets [] . retweetedTweet . quotedTweet . author . profileUrl
string nullable
Canonical public profile URL for the author when available.
data . tweets [] . retweetedTweet . quotedTweet . author . verified
boolean
Whether the author has legacy verification on X.
data . tweets [] . retweetedTweet . quotedTweet . author . blueVerified
boolean
Whether the author has paid blue verification on X.
data . tweets [] . retweetedTweet . quotedTweet . author . platformUserId
string optional
Numeric X user id for the author as a string.
data . tweets [] . retweetedTweet . quotedTweet . author . bio
string nullable optional
Author profile bio when available.
data . tweets [] . retweetedTweet . quotedTweet . author . location
string nullable optional
Location string from the author profile when provided.
data . tweets [] . retweetedTweet . quotedTweet . author . website
string nullable optional
Primary outbound link (expanded URL) from the author profile.
data . tweets [] . retweetedTweet . quotedTweet . author . bannerUrl
string nullable optional
Author profile banner image URL when available.
data . tweets [] . retweetedTweet . quotedTweet . author . accountCreatedAt
string nullable optional
Author account creation time (ISO-8601) when available.
data . tweets [] . retweetedTweet . quotedTweet . author . privateAccount
boolean nullable optional
Whether the author account is protected (private).
data . tweets [] . retweetedTweet . quotedTweet . author . verifiedType
string nullable optional
X verification type when provided, such as `Business` or `Government`.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the author name, when X provides one.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel . url
string optional
Destination URL for the label link.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . tweets [] . retweetedTweet . quotedTweet . author . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . tweets [] . retweetedTweet . quotedTweet . author . professional object nullable optional
X professional-account metadata when the author is marked professional.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . type
string nullable
Professional account type from X, when present.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . category array nullable
Professional categories X shows on the profile.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . category [] . id
integer nullable
X's numeric id for the category.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . tweets [] . retweetedTweet . quotedTweet . author . professional . restId
string nullable
Professional account rest id from X, when present.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics object nullable optional
Author follower, following, and post counts. Same shape as `metrics` on X profile responses.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . availableFields array optional
Metrics actually reported; an unavailable legacy numeric value must not be treated as an observation.
any of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount (comma-separated)
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . followers
integer
Follower count from X.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . following
integer
Following (friends) count from X.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . tweets
integer
Total post (status) count from X.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . favourites
integer
Total favourites (likes) count from X.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . listedCount
integer optional
Listed count when X provides it.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . mediaCount
integer optional
Media item count when X provides it.
data . tweets [] . retweetedTweet . quotedTweet . author . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . tweets [] . retweetedTweet . quotedTweet . metrics object
Engagement metrics for a tweet.
data . tweets [] . retweetedTweet . quotedTweet . metrics . availableFields array optional
Engagement metrics actually reported for this observation.
any of: likes, retweets, replies, quotes, views, bookmarkCount (comma-separated)
data . tweets [] . retweetedTweet . quotedTweet . metrics . availableFields []
string optional
one of: likes, retweets, replies, quotes, views, bookmarkCount
data . tweets [] . retweetedTweet . quotedTweet . metrics . likes
integer
Like count.
data . tweets [] . retweetedTweet . quotedTweet . metrics . retweets
integer
Retweet count.
data . tweets [] . retweetedTweet . quotedTweet . metrics . replies
integer
Reply count.
data . tweets [] . retweetedTweet . quotedTweet . metrics . quotes
integer
Quote count.
data . tweets [] . retweetedTweet . quotedTweet . metrics . views
integer nullable
View count when available.
data . tweets [] . retweetedTweet . quotedTweet . metrics . bookmarkCount
integer nullable
Bookmark count when available.
data . tweets [] . retweetedTweet . quotedTweet . media array
Media attachments returned for the tweet.
data . tweets [] . retweetedTweet . quotedTweet . media [] . url
string
Direct media URL when available.
data . tweets [] . retweetedTweet . quotedTweet . media [] . type
string
Media type when Social Fetch can classify it confidently.
one of: photo, video, animated_gif
data . tweets [] . retweetedTweet . quotedTweet . media [] . thumbnailUrl
string optional
Poster or thumbnail URL for video media when distinguishable.
data . tweets [] . retweetedTweet . quotedTweet . media [] . contentType
string optional
MIME type reported for streamed media.
data . tweets [] . retweetedTweet . quotedTweet . media [] . bitrate
integer optional
Bitrate in bits per second when supplied for streamed media.
data . tweets [] . retweetedTweet . quotedTweet . media [] . width
integer optional
Width in pixels when available.
data . tweets [] . retweetedTweet . quotedTweet . media [] . height
integer optional
Height in pixels when available.
data . tweets [] . retweetedTweet . quotedTweet . media [] . id
string optional
X media id. Video variants of the same attachment share one id.
data . tweets [] . retweetedTweet . quotedTweet . media [] . altText
string nullable optional
Alternative text for the media when provided.
data . tweets [] . retweetedTweet . quotedTweet . media [] . durationMs
integer optional
Video or GIF duration in milliseconds when known.
data . tweets [] . retweetedTweet . quotedTweet . expandedUrl
string nullable
Expanded URL attached to the tweet when available.
data . tweets [] . retweetedTweet . quotedTweet . isRetweet
boolean
Whether the tweet is marked as a retweet.
data . tweets [] . retweetedTweet . quotedTweet . isReply
boolean optional
Whether the tweet is a reply to another post.
data . tweets [] . retweetedTweet . quotedTweet . isQuote
boolean optional
Whether the tweet quotes another post.
data . tweets [] . retweetedTweet . quotedTweet . source
string nullable
Source label such as `Twitter Web App` when available.
data . tweets [] . retweetedTweet . quotedTweet . communityId
string nullable optional
Community id when the tweet was posted to a community.
data . tweets [] . retweetedTweet . quotedTweet . hasAIGeneratedMedia
boolean nullable optional
Whether X marks the tweet as containing AI-generated media.
data . tweets [] . retweetedTweet . quotedTweet . isPaidPromotion
boolean nullable optional
Whether the author labeled the tweet as a paid partnership (X's disclosure label). Not X ads or Promote status, which X does not expose on tweets.
data . tweets [] . retweetedTweet . quotedTweet . isTranslatable
boolean nullable optional
Whether X considers the tweet text translatable.
data . tweets [] . retweetedTweet . quotedTweet . hasBirdwatchNotes
boolean nullable optional
X's Community Notes flag for this tweet. It can be false while a note is shown; use `communityNote` for the note X displays.
data . tweets [] . retweetedTweet . quotedTweet . possiblySensitive
boolean nullable optional
Whether X marks the content sensitive.
data . tweets [] . retweetedTweet . quotedTweet . entities object optional
Hashtags, mentions, links, and cashtags in the tweet text.
data . tweets [] . retweetedTweet . quotedTweet . entities . hashtags array
Hashtag entities.
data . tweets [] . retweetedTweet . quotedTweet . entities . hashtags [] . text
string
Hashtag text without #.
data . tweets [] . retweetedTweet . quotedTweet . entities . userMentions array
User mention entities.
data . tweets [] . retweetedTweet . quotedTweet . entities . userMentions [] . handle
string
Mentioned screen name.
data . tweets [] . retweetedTweet . quotedTweet . entities . userMentions [] . displayName
string optional
Display name when available.
data . tweets [] . retweetedTweet . quotedTweet . entities . userMentions [] . platformUserId
string optional
Numeric user id for the mention when available.
data . tweets [] . retweetedTweet . quotedTweet . entities . urls array
URL entities.
data . tweets [] . retweetedTweet . quotedTweet . entities . urls [] . url
string
Short URL as it appears in text.
data . tweets [] . retweetedTweet . quotedTweet . entities . urls [] . displayUrl
string
Human-readable display host/path.
data . tweets [] . retweetedTweet . quotedTweet . entities . urls [] . expandedUrl
string
Fully expanded destination URL.
data . tweets [] . retweetedTweet . quotedTweet . entities . symbols array
Symbol entities.
data . tweets [] . retweetedTweet . quotedTweet . entities . symbols [] . text
string
Cashtag or symbol text.
data . tweets [] . retweetedTweet . quotedTweet . editInfo object optional
Edit metadata when the tweet is editable or edited.
data . tweets [] . retweetedTweet . quotedTweet . editInfo . editTweetIds array
Tweet ids in this edit chain.
data . tweets [] . retweetedTweet . quotedTweet . editInfo . editTweetIds []
string optional
data . tweets [] . retweetedTweet . quotedTweet . editInfo . editableUntilMsec
string
Epoch milliseconds until edits are locked.
data . tweets [] . retweetedTweet . quotedTweet . editInfo . isEditEligible
boolean
Whether the tweet can still be edited.
data . tweets [] . retweetedTweet . quotedTweet . editInfo . editsRemaining
string
Remaining edits in the window, as reported by X.
data . tweets [] . retweetedTweet . quotedTweet . card object nullable optional
Link preview card when the tweet has one.
data . tweets [] . retweetedTweet . quotedTweet . card . type
string nullable
Card kind reported by X, such as `summary`, `player`, `broadcast`, or `audio`.
data . tweets [] . retweetedTweet . quotedTweet . card . name
string nullable
X card template name, such as `summary_large_image`, `player`, or `unified_card`.
data . tweets [] . retweetedTweet . quotedTweet . card . url
string nullable
Link the card points to, usually a t.co short link.
data . tweets [] . retweetedTweet . quotedTweet . card . title
string nullable
Preview title of the linked page.
data . tweets [] . retweetedTweet . quotedTweet . card . description
string nullable
Preview description of the linked page.
data . tweets [] . retweetedTweet . quotedTweet . card . domain
string nullable
Domain of the linked page, such as `www.nasa.gov`.
data . tweets [] . retweetedTweet . quotedTweet . card . imageUrl
string nullable
Preview image URL.
data . tweets [] . retweetedTweet . quotedTweet . card . playerUrl
string nullable
Embeddable player URL for video or audio cards.
data . tweets [] . retweetedTweet . quotedTweet . card . appName
string nullable
App name for app and player cards, such as `YouTube`.
data . tweets [] . retweetedTweet . quotedTweet . poll object nullable optional
Poll when the tweet contains one.
data . tweets [] . retweetedTweet . quotedTweet . poll . id
string nullable
Poll id.
data . tweets [] . retweetedTweet . quotedTweet . poll . options array nullable
Poll choices.
data . tweets [] . retweetedTweet . quotedTweet . poll . options [] . id
string nullable
Poll choice id.
data . tweets [] . retweetedTweet . quotedTweet . poll . options [] . label
string nullable
Poll choice label.
data . tweets [] . retweetedTweet . quotedTweet . poll . options [] . voteCount
integer nullable
Votes for this choice.
data . tweets [] . retweetedTweet . quotedTweet . poll . options [] . percentage
integer nullable
Share of votes for this choice, as a whole percent.
data . tweets [] . retweetedTweet . quotedTweet . poll . endDatetime
string nullable
When voting ends, as reported by X.
data . tweets [] . retweetedTweet . quotedTweet . poll . durationMinutes
integer nullable
Configured poll duration in minutes.
data . tweets [] . retweetedTweet . quotedTweet . poll . votingStatus
string nullable
Poll voting status (for example `closed`).
data . tweets [] . retweetedTweet . quotedTweet . poll . totalVotes
integer nullable
Total votes across all choices.
data . tweets [] . retweetedTweet . quotedTweet . poll . isFinalized
boolean nullable optional
Whether X has finalized the poll results.
data . tweets [] . retweetedTweet . quotedTweet . article object nullable optional
X article when the tweet is a long-form article.
data . tweets [] . retweetedTweet . quotedTweet . article . title
string nullable
Article title.
data . tweets [] . retweetedTweet . quotedTweet . article . previewText
string nullable
Short preview of the article body.
data . tweets [] . retweetedTweet . quotedTweet . article . id
string nullable optional
X article id.
data . tweets [] . retweetedTweet . quotedTweet . article . text
string nullable optional
Full article body text when X returns it.
data . tweets [] . retweetedTweet . quotedTweet . article . coverImageUrl
string nullable optional
Article cover image URL when available.
data . tweets [] . retweetedTweet . quotedTweet . place object nullable optional
Tagged location when the author added one.
data . tweets [] . retweetedTweet . quotedTweet . place . id
string nullable
X place id.
data . tweets [] . retweetedTweet . quotedTweet . place . name
string nullable
Short place name.
data . tweets [] . retweetedTweet . quotedTweet . place . fullName
string nullable
Full place name, such as `Stockholm, Sweden`.
data . tweets [] . retweetedTweet . quotedTweet . place . country
string nullable
Country name.
data . tweets [] . retweetedTweet . quotedTweet . place . countryCode
string nullable
ISO 3166-1 alpha-2 country code.
data . tweets [] . retweetedTweet . quotedTweet . place . placeType
string nullable
Place granularity, such as `city`, `admin`, or `country`.
data . tweets [] . retweetedTweet . quotedTweet . communityNote object nullable optional
Community Note text and link when one is shown on the tweet.
data . tweets [] . retweetedTweet . quotedTweet . communityNote . id
string nullable
Community Note id.
data . tweets [] . retweetedTweet . quotedTweet . communityNote . text
string nullable
Note text shown under the tweet.
data . tweets [] . retweetedTweet . quotedTweet . communityNote . url
string nullable
Public URL of the note on X.
data . tweets [] . retweetedTweet . quotedTweet . communityNote . sourceUrls array
Links cited in the note, expanded when X provides it.
data . tweets [] . retweetedTweet . quotedTweet . communityNote . sourceUrls []
string optional
data . tweets [] . retweetedTweet . quotedTweet . isEdited
boolean nullable optional
Whether the tweet has been edited.
Pagination information for the current response.
data . page . nextCursor
string nullable
Cursor to pass as `cursor` in the next request when another page exists.
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.