Search Twitter by hashtag Search X posts by hashtag (not free-text keyword — use twitter.search.list for that).
x-api-key* string header
API key (`sfk_...`)
hashtag* string required query
Hashtag to search, with or without a leading #.
min 1 chars · max 256 chars
section string optional query
Hashtag feed section: `top` (default), `latest`, `people`, `photos`, or `videos`.
one of: top, latest, people, photos, videos
limit integer optional query
Optional page size (1–20). Requests cannot ask for more than 20 posts; the actual page size may be smaller. Use the response cursor for subsequent pages.
≥ 1 · ≤ 20
cursor string optional query
Opaque pagination cursor returned by a previous response.
min 1 chars
Response fields 629 Expand all Collapse all Collapse all Endpoint-specific response payload.
Posts returned for the requested hashtag.
data . tweets [] . url
string nullable
Canonical public URL for the tweet when available.
Full tweet text when available.
data . tweets [] . createdAt
string nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
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 nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
data . tweets [] . quotedTweet . createdAtUnix
integer nullable
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 nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
data . tweets [] . retweetedTweet . createdAtUnix
integer nullable
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 nullable
Creation time (ISO-8601). Null when the source gives no usable timestamp (seen on some quoted tweets).
data . tweets [] . retweetedTweet . quotedTweet . createdAtUnix
integer nullable
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.
Profiles returned for the requested hashtag.
data . people [] . platformUserId
string
Numeric X user id as a string.
data . people [] . handle
string nullable
X screen name (handle) without the leading @.
data . people [] . displayName
string nullable
Display name shown on the profile.
data . people [] . bio
string nullable
Profile biography text.
data . people [] . avatarUrl
string nullable
Best available square avatar image URL.
data . people [] . bannerUrl
string nullable optional
Profile banner image URL when available.
data . people [] . verified
boolean
Whether X marks the profile with legacy verification (not necessarily paid blue).
data . people [] . blueVerified
boolean
Whether the account has X blue (paid) verification.
data . people [] . privateAccount
boolean
Whether the account is protected (private).
data . people [] . profileUrl
string
Canonical public profile URL on x.com.
data . people [] . website
string nullable optional
Primary outbound link from the profile when provided.
data . people [] . location
string nullable optional
Location string from the profile when provided.
data . people [] . accountCreatedAt
string optional
Account creation time (ISO-8601) when derivable.
Aggregate profile metrics from X.
data . people [] . 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 . people [] . metrics . availableFields []
string optional
one of: followers, following, tweets, favourites, listedCount, mediaCount, fastFollowersCount
data . people [] . metrics . followers
integer
Follower count from X.
data . people [] . metrics . following
integer
Following (friends) count from X.
data . people [] . metrics . tweets
integer
Total post (status) count from X.
data . people [] . metrics . favourites
integer
Total favourites (likes) count from X.
data . people [] . metrics . listedCount
integer optional
Listed count when X provides it.
data . people [] . metrics . mediaCount
integer optional
Media item count when X provides it.
data . people [] . metrics . fastFollowersCount
integer optional
Fast-followers count when X provides it.
data . people [] . profileImageShape
string nullable optional
Avatar crop shape reported by X, such as Circle or Square.
data . people [] . verifiedType
string nullable optional
X verification type label when provided (for example a government or organization note).
data . people [] . pinnedTweetIds array nullable optional
Pinned tweet ids from X, in display order.
data . people [] . pinnedTweetIds []
string optional
data . people [] . professional object nullable optional
X professional-account metadata when the account is marked professional.
data . people [] . professional . type
string nullable
Professional account type from X, when present.
data . people [] . professional . category array nullable
Professional categories X shows on the profile.
data . people [] . professional . category [] . id
integer nullable
X's numeric id for the category.
data . people [] . professional . category [] . name
string nullable
Category name shown on the profile, such as `Science & Technology`.
data . people [] . professional . category [] . icon_name
string nullable
X's icon name for the category, such as `IconBriefcaseStroke`.
data . people [] . professional . restId
string nullable
Professional account rest id from X, when present.
data . people [] . affiliateLabel object nullable optional
Affiliation or automated-account label shown next to the name, when X provides one.
data . people [] . affiliateLabel . description
string
Affiliate or business label text shown on the profile.
data . people [] . affiliateLabel . badgeUrl
string optional
Badge image URL when X provides one.
data . people [] . affiliateLabel . url
string optional
Destination URL for the label link.
data . people [] . affiliateLabel . type
string optional
X label type, such as `BusinessLabel` for an affiliation or `AutomatedLabel` for a bot account.
data . people [] . affiliateLabel . longDescription
string optional
Longer label text when X provides one, such as `Automated by @owner`.
data . people [] . withheldInCountries array nullable optional
Country codes where the profile is withheld.
data . people [] . withheldInCountries []
string optional
data . people [] . favoritesCount
integer nullable optional
Total likes (favorites) on the profile when available.
data . people [] . mediaCount
integer nullable optional
Media item count when X provides it.
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.