--- title: "List replies to a tweet" method: GET path: "/api/v1/x/tweets/{id}/replies" tags: ["Tweets"] --- # List replies to a tweet `GET /api/v1/x/tweets/{id}/replies` Returns direct replies with automatic maximum coverage and pagination. A retweet ID returns replies to the original post. Complete mode adds nested replies, diagnostics, and a 424 below 80% coverage. A fully read time window returns 200. ## Path parameters - `id` string, required ## Query parameters - `cursor` string - `mode` 'standard' | 'complete' - `limit` integer - `pageSize` integer - `scope` 'all' | 'direct' | 'nested' - `maxDepth` integer - `sort` 'relevance' | 'latest' | 'oldest' | 'likes' - `excludeOriginalAuthor` boolean - `includeOriginalPost` boolean - `hasMediaOnly` boolean - `sinceTime` string - `untilTime` string - `fromUser` string - `toUser` string - `mentioning` string - `language` string - `sinceDate` string, date - `untilDate` string, date - `mediaType` 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none' - `minLikes` integer - `minRetweets` integer - `minReplies` integer - `minQuotes` integer - `minViews` integer - `minBookmarks` integer - `maxFaves` integer - `maxRetweets` integer - `maxReplies` integer - `maxQuotes` integer - `blueVerifiedOnly` boolean - `cardName` string - `source` string - `excludeSource` string - `geocode` string - `sinceId` string - `maxId` string - `near` string - `within` string - `withinTime` string - `nativeRetweets` boolean - `safe` boolean - `news` boolean - `verifiedOnly` boolean - `replies` 'include' | 'exclude' | 'only' - `retweets` 'include' | 'exclude' | 'only' - `quotes` 'include' | 'exclude' | 'only' - `exactPhrase` string - `excludeWords` string - `anyWords` string - `hashtags` string - `cashtags` string - `url` string - `conversationId` string - `inReplyToTweetId` string - `quotesOfTweetId` string - `retweetsOfTweetId` string ## Response `200` List of replies - TweetReplies — Automatic search, user Tweet, and reply coverage preserves shape, filters, aliases, and billing. Follow next_cursor while the response reports more pages. An empty filtered page can still require continuation. Unprefixed cursors are legacy. - `filtered_count` integer - `tweets` SearchTweet[], required - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `retweetedAt` string, date-time, nullable — Repost event time in UTC. Null when unavailable; omitted for other posts. - `inReplyToId` string - `inReplyToUserId` string - `inReplyToUsername` string - `conversationId` string - `conversationControl` object — Reply policy & conversation owner. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public restrictions & prompts. - `action` string - `prompt` object - `ctaType` string - `headline` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `subtext` string - `source` string - `displayTextRange` integer[] - `contentDisclosure` ContentDisclosure — Content disclosure metadata shown by X when a tweet is labeled as paid partnership content or AI-generated media. - `advertising` object - `isPaidPromotion` boolean — True when X labels the tweet as paid promotion content. - `aiGenerated` object - `detectionSource` string — Source of the AI-generated media disclosure. - `hasAiGeneratedMedia` boolean — True when X labels the tweet as containing AI-generated media. - `article` TweetArticleMetadata — Describes an X Article preview and its lifecycle metadata. - `coverMedia` PublicMetadata — Public metadata whose fields are defined by X. - `id` string - `lifecycleState` PublicMetadata — Public metadata whose fields are defined by X. - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `title` string - `previewText` string - `coverMediaUrl` string - `authorUnavailable` TweetAuthorUnavailable — Why the tweet has no author. X serves a suspended or deleted account as an unavailable user with a reason such as Suspended or NotFound. Omitted when the author is available. - `reason` string, required — X's reason code. - `message` string — X's notice text for the reason. - `card` TweetCard — Describes a public card and its referenced profiles. - `id` string - `name` string - `url` string - `bindingValues` PublicMetadata — Public metadata whose fields are defined by X. - `platform` PublicMetadata — Public metadata whose fields are defined by X. - `userReferenceErrors` object[] — Unresolved card user references. - `message` string - `reason` string - `userReferences` UserProfile[] - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — Account owner's public profile location text - `accountBasedIn` AccountBasedIn — X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location. - `value` string, required - `level` 'country' | 'region', required - `observedAt` string, date-time, required - `retweetedAt` string, date-time, nullable — UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed; otherwise omitted. - `createdAt` string — Account creation time. - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `withheldScope` string — Whether X withholds a post or user - `possiblySensitive` boolean - `professional` PublicMetadata — Public metadata whose fields are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - `badgeUrl` string - `description` string - `longDescription` PublicMetadata — Public metadata whose fields are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - `bandcampHandle` string - `bitcoinHandle` string - `cashAppHandle` string - `ethereumHandle` string - `gofundmeHandle` string - `isEnabled` boolean - `patreonHandle` string - `payPalHandle` string - `venmoHandle` string - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `communityId` string — Community ID. - `communityNote` TweetCommunityNote — Community Note presentation metadata returned by X. - `id` string - `title` string - `shortTitle` string - `subtitle` string - `footer` string - `footerIconType` string - `destinationUrl` string - `iconType` string - `visualStyle` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `edit` TweetEdit — Lists edit-chain identifiers and the remaining edit window. - `editTweetIds` string[] - `editableUntilMsecs` string - `initialTweetId` string - `exclusiveContent` TweetExclusiveContent — Marks a subscriber-only post with the creator whose subscription unlocks it. Non-subscribers get the preview text & the subscribe link. Omitted on public posts. - `creatorUserName` string, required — Username of the creator whose subscription unlocks the post. - `subscribeUrl` string — Subscribe link X shows non-subscribers. Omitted when X serves the full post. - `isTranslatable` boolean - `grokShareAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `jetfuelAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - `id` string - `text` string, required - `isExpandable` boolean - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - … - `symbols` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - … - `timestamps` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` integer[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` integer[] - `name` string - `screen_name` string, required - `inlineMedia` object[] — Inline media positions in the Note Tweet text. - `index` integer, required - `mediaId` string, required - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Describes public place metadata on a geotagged tweet. - `boundingBox` PublicMetadata — Public metadata whose fields are defined by X. - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `postCta` PublicMetadata — Public metadata whose fields are defined by X. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer - `likeCount` integer - `quoteCount` integer - `replyCount` integer - `retweetCount` integer - `reactionContext` object — Public post & user this reaction references. - `reactedToPostId` string — Referenced post ID. - `reactedToUser` UserProfile — Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — Account owner's public profile location text - `accountBasedIn` AccountBasedIn — X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location. - `value` string, required - `level` 'country' | 'region', required - `observedAt` string, date-time, required - `retweetedAt` string, date-time, nullable — UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed; otherwise omitted. - `createdAt` string — Account creation time. - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `withheldScope` string — Whether X withholds a post or user - `possiblySensitive` boolean - `professional` PublicMetadata — Public metadata whose fields are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - `badgeUrl` string - `description` string - `longDescription` PublicMetadata — Public metadata whose fields are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - `bandcampHandle` string - `bitcoinHandle` string - `cashAppHandle` string - `ethereumHandle` string - `gofundmeHandle` string - `isEnabled` boolean - `patreonHandle` string - `payPalHandle` string - `venmoHandle` string - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `sportsContext` object — Game metadata attached to this post. - `gameId` string — Game ID. - `league` string — League ID. - `title` string — Game title. - `url` string — Game link. - `state` string — Reported game state. - `statusText` string — Game progress text. - `scheduledAtMs` union — Scheduled Unix milliseconds, retaining the source type. - number - string - `competitors` object[] — Teams & reported scores. - `teamId` string — Team ID. - `color` string — Team display color. - `isActive` boolean — Active competitor. - `isWinner` boolean — Winning competitor. - `abbreviation` string — Team abbreviation. - `name` string — Team name. - `score` string — Score display text. - `logoUrl` string — Logo for light backgrounds. - `darkLogoUrl` string — Logo for dark backgrounds. - `tombstone` TweetTombstone — Public visibility notice attached to an available tweet. - `type` string — Visibility notice type. - `text` object - `text` string — Human-readable notice text. - `rtl` boolean — Right-to-left text direction. - `entities` object[] - `fromIndex` integer - `toIndex` integer - `ref` object - `type` string - `url` string - `urlType` string - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - `info` object - … - `symbols` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - `info` object - … - `timestamps` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - `info` object - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` integer[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` integer[] - `name` string - `screen_name` string, required - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `media` TweetMedia[] — Media, omitted when unavailable. - `mediaUrl` string, required — Preview URL. - `type` 'photo' | 'video' | 'animated_gif', required - `url` string, required — Tweet media link. - `adultContent` boolean — Adult-content warning. - `allowDownload` boolean — Direct download permission. - `altText` string — Accessibility text. - `aspectRatio` integer[] — Video width and height ratio. - `availabilityReason` string — Availability reason. - `availabilityStatus` string — Availability state. - `description` string — Media description. - `displayUrl` string — Display URL. - `durationMillis` integer — Video duration in milliseconds. - `expandedUrl` string — Expanded media URL. - `embeddable` boolean — Embeddable status. - `faceRects` object — Face crop rectangles by size. - `focusRects` object[] — Suggested image crops. - `x` integer, required - `y` integer, required - `w` integer, required - `h` integer, required - `grokPostId` string — Grok post ID associated with the media. - `graphicViolence` boolean — Graphic-violence warning. - `height` integer — Original height. - `id` string — Media entity ID. - `indices` integer[] — Tweet text offsets. - `mediaKey` string — Stable X media key. - `monetizable` boolean — Monetization status. - `otherSensitiveContent` boolean - `sizes` object — Named media renditions and resize modes. - `sourceStatusId` string — Source tweet ID for copied media. - `sourceUserId` string — Source profile ID for copied media. - `tags` object[] — Public profiles tagged in the media. - `name` string - `screen_name` string - `type` string - `user_id` string - `title` string — Media title. - `videoVariants` object[] — Video encodings in source order. - `bitrate` integer - `contentType` string, required - `url` string, required - `watchNowUrl` string — Public media action URL. - `visitSiteUrl` string — Public destination URL. - `width` integer — Original width. - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `quoted_tweet` EmbeddedTweet — A quoted or retweeted tweet. It has the TweetPublicData fields and an author. Nesting stops after 4 levels. - `id` string, required - `text` string, required - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — Account owner's public profile location text - `accountBasedIn` AccountBasedIn — X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location. - `value` string, required - `level` 'country' | 'region', required - `observedAt` string, date-time, required - `retweetedAt` string, date-time, nullable — UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed; otherwise omitted. - `createdAt` string — Account creation time. - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `withheldScope` string — Whether X withholds a post or user - `possiblySensitive` boolean - `professional` PublicMetadata — Public metadata whose fields are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - `badgeUrl` string - `description` string - `longDescription` PublicMetadata — Public metadata whose fields are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - `bandcampHandle` string - `bitcoinHandle` string - `cashAppHandle` string - `ethereumHandle` string - `gofundmeHandle` string - `isEnabled` boolean - `patreonHandle` string - `payPalHandle` string - `venmoHandle` string - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `retweeted_tweet` EmbeddedTweet — A quoted or retweeted tweet. It has the TweetPublicData fields and an author. Nesting stops after 4 levels. - `id` string, required - `text` string, required - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — Account owner's public profile location text - `accountBasedIn` AccountBasedIn — X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location. - `value` string, required - `level` 'country' | 'region', required - `observedAt` string, date-time, required - `retweetedAt` string, date-time, nullable — UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed; otherwise omitted. - `createdAt` string — Account creation time. - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `withheldScope` string — Whether X withholds a post or user - `possiblySensitive` boolean - `professional` PublicMetadata — Public metadata whose fields are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - `badgeUrl` string - `description` string - `longDescription` PublicMetadata — Public metadata whose fields are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - `bandcampHandle` string - `bitcoinHandle` string - `cashAppHandle` string - `ethereumHandle` string - `gofundmeHandle` string - `isEnabled` boolean - `patreonHandle` string - `payPalHandle` string - `venmoHandle` string - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `author` UserProfile — Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — Account owner's public profile location text - `accountBasedIn` AccountBasedIn — X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location. - `value` string, required - `level` 'country' | 'region', required - `observedAt` string, date-time, required - `retweetedAt` string, date-time, nullable — UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed; otherwise omitted. - `createdAt` string — Account creation time. - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `withheldScope` string — Whether X withholds a post or user - `possiblySensitive` boolean - `professional` PublicMetadata — Public metadata whose fields are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - `badgeUrl` string - `description` string - `longDescription` PublicMetadata — Public metadata whose fields are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - `bandcampHandle` string - `bitcoinHandle` string - `cashAppHandle` string - `ethereumHandle` string - `gofundmeHandle` string - `isEnabled` boolean - `patreonHandle` string - `payPalHandle` string - `venmoHandle` string - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `has_next_page` boolean, required - `next_cursor` string, required - `nested_replies` SearchTweet[] — Nested replies. Excluded from direct coverage. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `retweetedAt` string, date-time, nullable — Repost event time in UTC. Null when unavailable; omitted for other posts. - `inReplyToId` string - `inReplyToUserId` string - `inReplyToUsername` string - `conversationId` string - `conversationControl` object — Reply policy & conversation owner. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public restrictions & prompts. - `action` string - `prompt` object - `ctaType` string - `headline` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `subtext` string - `source` string - `displayTextRange` integer[] - `contentDisclosure` ContentDisclosure — Content disclosure metadata shown by X when a tweet is labeled as paid partnership content or AI-generated media. - `advertising` object - `isPaidPromotion` boolean — True when X labels the tweet as paid promotion content. - `aiGenerated` object - `detectionSource` string — Source of the AI-generated media disclosure. - `hasAiGeneratedMedia` boolean — True when X labels the tweet as containing AI-generated media. - `article` TweetArticleMetadata — Describes an X Article preview and its lifecycle metadata. - `coverMedia` PublicMetadata — Public metadata whose fields are defined by X. - `id` string - `lifecycleState` PublicMetadata — Public metadata whose fields are defined by X. - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `title` string - `previewText` string - `coverMediaUrl` string - `authorUnavailable` TweetAuthorUnavailable — Why the tweet has no author. X serves a suspended or deleted account as an unavailable user with a reason such as Suspended or NotFound. Omitted when the author is available. - `reason` string, required — X's reason code. - `message` string — X's notice text for the reason. - `card` TweetCard — Describes a public card and its referenced profiles. - `id` string - `name` string - `url` string - `bindingValues` PublicMetadata — Public metadata whose fields are defined by X. - `platform` PublicMetadata — Public metadata whose fields are defined by X. - `userReferenceErrors` object[] — Unresolved card user references. - `message` string - `reason` string - `userReferences` UserProfile[] - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — Account owner's public profile location text - `accountBasedIn` AccountBasedIn — X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location. - `value` string, required - `level` 'country' | 'region', required - `observedAt` string, date-time, required - `retweetedAt` string, date-time, nullable — UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed; otherwise omitted. - `createdAt` string — Account creation time. - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `withheldScope` string — Whether X withholds a post or user - `possiblySensitive` boolean - `professional` PublicMetadata — Public metadata whose fields are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - `badgeUrl` string - `description` string - `longDescription` PublicMetadata — Public metadata whose fields are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - `bandcampHandle` string - `bitcoinHandle` string - `cashAppHandle` string - `ethereumHandle` string - `gofundmeHandle` string - `isEnabled` boolean - `patreonHandle` string - `payPalHandle` string - `venmoHandle` string - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `communityId` string — Community ID. - `communityNote` TweetCommunityNote — Community Note presentation metadata returned by X. - `id` string - `title` string - `shortTitle` string - `subtitle` string - `footer` string - `footerIconType` string - `destinationUrl` string - `iconType` string - `visualStyle` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `edit` TweetEdit — Lists edit-chain identifiers and the remaining edit window. - `editTweetIds` string[] - `editableUntilMsecs` string - `initialTweetId` string - `exclusiveContent` TweetExclusiveContent — Marks a subscriber-only post with the creator whose subscription unlocks it. Non-subscribers get the preview text & the subscribe link. Omitted on public posts. - `creatorUserName` string, required — Username of the creator whose subscription unlocks the post. - `subscribeUrl` string — Subscribe link X shows non-subscribers. Omitted when X serves the full post. - `isTranslatable` boolean - `grokShareAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `jetfuelAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - `id` string - `text` string, required - `isExpandable` boolean - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - … - `symbols` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - … - `timestamps` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` integer[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` integer[] - `name` string - `screen_name` string, required - `inlineMedia` object[] — Inline media positions in the Note Tweet text. - `index` integer, required - `mediaId` string, required - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Describes public place metadata on a geotagged tweet. - `boundingBox` PublicMetadata — Public metadata whose fields are defined by X. - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `postCta` PublicMetadata — Public metadata whose fields are defined by X. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer - `likeCount` integer - `quoteCount` integer - `replyCount` integer - `retweetCount` integer - `reactionContext` object — Public post & user this reaction references. - `reactedToPostId` string — Referenced post ID. - `reactedToUser` UserProfile — Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — Account owner's public profile location text - `accountBasedIn` AccountBasedIn — X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location. - `value` string, required - `level` 'country' | 'region', required - `observedAt` string, date-time, required - `retweetedAt` string, date-time, nullable — UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed; otherwise omitted. - `createdAt` string — Account creation time. - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `withheldScope` string — Whether X withholds a post or user - `possiblySensitive` boolean - `professional` PublicMetadata — Public metadata whose fields are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - `badgeUrl` string - `description` string - `longDescription` PublicMetadata — Public metadata whose fields are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - `bandcampHandle` string - `bitcoinHandle` string - `cashAppHandle` string - `ethereumHandle` string - `gofundmeHandle` string - `isEnabled` boolean - `patreonHandle` string - `payPalHandle` string - `venmoHandle` string - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `sportsContext` object — Game metadata attached to this post. - `gameId` string — Game ID. - `league` string — League ID. - `title` string — Game title. - `url` string — Game link. - `state` string — Reported game state. - `statusText` string — Game progress text. - `scheduledAtMs` union — Scheduled Unix milliseconds, retaining the source type. - number - string - `competitors` object[] — Teams & reported scores. - `teamId` string — Team ID. - `color` string — Team display color. - `isActive` boolean — Active competitor. - `isWinner` boolean — Winning competitor. - `abbreviation` string — Team abbreviation. - `name` string — Team name. - `score` string — Score display text. - `logoUrl` string — Logo for light backgrounds. - `darkLogoUrl` string — Logo for dark backgrounds. - `tombstone` TweetTombstone — Public visibility notice attached to an available tweet. - `type` string — Visibility notice type. - `text` object - `text` string — Human-readable notice text. - `rtl` boolean — Right-to-left text direction. - `entities` object[] - `fromIndex` integer - `toIndex` integer - `ref` object - `type` string - `url` string - `urlType` string - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - `info` object - … - `symbols` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - `info` object - … - `timestamps` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - `info` object - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` integer[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` integer[] - `name` string - `screen_name` string, required - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `media` TweetMedia[] — Media, omitted when unavailable. - `mediaUrl` string, required — Preview URL. - `type` 'photo' | 'video' | 'animated_gif', required - `url` string, required — Tweet media link. - `adultContent` boolean — Adult-content warning. - `allowDownload` boolean — Direct download permission. - `altText` string — Accessibility text. - `aspectRatio` integer[] — Video width and height ratio. - `availabilityReason` string — Availability reason. - `availabilityStatus` string — Availability state. - `description` string — Media description. - `displayUrl` string — Display URL. - `durationMillis` integer — Video duration in milliseconds. - `expandedUrl` string — Expanded media URL. - `embeddable` boolean — Embeddable status. - `faceRects` object — Face crop rectangles by size. - `focusRects` object[] — Suggested image crops. - `x` integer, required - `y` integer, required - `w` integer, required - `h` integer, required - `grokPostId` string — Grok post ID associated with the media. - `graphicViolence` boolean — Graphic-violence warning. - `height` integer — Original height. - `id` string — Media entity ID. - `indices` integer[] — Tweet text offsets. - `mediaKey` string — Stable X media key. - `monetizable` boolean — Monetization status. - `otherSensitiveContent` boolean - `sizes` object — Named media renditions and resize modes. - `sourceStatusId` string — Source tweet ID for copied media. - `sourceUserId` string — Source profile ID for copied media. - `tags` object[] — Public profiles tagged in the media. - `name` string - `screen_name` string - `type` string - `user_id` string - `title` string — Media title. - `videoVariants` object[] — Video encodings in source order. - `bitrate` integer - `contentType` string, required - `url` string, required - `watchNowUrl` string — Public media action URL. - `visitSiteUrl` string — Public destination URL. - `width` integer — Original width. - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `quoted_tweet` EmbeddedTweet — A quoted or retweeted tweet. It has the TweetPublicData fields and an author. Nesting stops after 4 levels. - `id` string, required - `text` string, required - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — Account owner's public profile location text - `accountBasedIn` AccountBasedIn — X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location. - `value` string, required - `level` 'country' | 'region', required - `observedAt` string, date-time, required - `retweetedAt` string, date-time, nullable — UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed; otherwise omitted. - `createdAt` string — Account creation time. - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `withheldScope` string — Whether X withholds a post or user - `possiblySensitive` boolean - `professional` PublicMetadata — Public metadata whose fields are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - `badgeUrl` string - `description` string - `longDescription` PublicMetadata — Public metadata whose fields are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - `bandcampHandle` string - `bitcoinHandle` string - `cashAppHandle` string - `ethereumHandle` string - `gofundmeHandle` string - `isEnabled` boolean - `patreonHandle` string - `payPalHandle` string - `venmoHandle` string - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `retweeted_tweet` EmbeddedTweet — A quoted or retweeted tweet. It has the TweetPublicData fields and an author. Nesting stops after 4 levels. - `id` string, required - `text` string, required - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — Account owner's public profile location text - `accountBasedIn` AccountBasedIn — X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location. - `value` string, required - `level` 'country' | 'region', required - `observedAt` string, date-time, required - `retweetedAt` string, date-time, nullable — UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed; otherwise omitted. - `createdAt` string — Account creation time. - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `withheldScope` string — Whether X withholds a post or user - `possiblySensitive` boolean - `professional` PublicMetadata — Public metadata whose fields are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - `badgeUrl` string - `description` string - `longDescription` PublicMetadata — Public metadata whose fields are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - `bandcampHandle` string - `bitcoinHandle` string - `cashAppHandle` string - `ethereumHandle` string - `gofundmeHandle` string - `isEnabled` boolean - `patreonHandle` string - `payPalHandle` string - `venmoHandle` string - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `author` UserProfile — Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — Account owner's public profile location text - `accountBasedIn` AccountBasedIn — X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location. - `value` string, required - `level` 'country' | 'region', required - `observedAt` string, date-time, required - `retweetedAt` string, date-time, nullable — UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed; otherwise omitted. - `createdAt` string — Account creation time. - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `withheldScope` string — Whether X withholds a post or user - `possiblySensitive` boolean - `professional` PublicMetadata — Public metadata whose fields are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - `badgeUrl` string - `description` string - `longDescription` PublicMetadata — Public metadata whose fields are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - `bandcampHandle` string - `bitcoinHandle` string - `cashAppHandle` string - `ethereumHandle` string - `gofundmeHandle` string - `isEnabled` boolean - `patreonHandle` string - `payPalHandle` string - `venmoHandle` string - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `diagnostic` ReplyCoverageDiagnostic — Direct-reply coverage & collection evidence. - `complete` boolean, required — Coverage met its target, or read the whole time window, without truncation. - `replyTreeComplete` boolean — All child counts are known & match collected replies. - `replyScopeComplete` boolean — Replies are accounted for through the requested scope & depth. Source errors remain separate. - `reportedReplyCount` integer, required — Source post reply count. - `targetDirectReplies` integer, required — Direct replies required to meet the target. - `uniqueDirectReplies` integer, required — Unique direct replies to the source post. - `coveragePercentage` number, required — Unique direct replies / reported count, as a percentage. - `nestedReplyCount` integer, required — Unique nested replies, excluded from direct coverage. - `pagesAttempted` integer, required — Pages attempted across strategies. - `strategiesAttempted` ReplyCoverageStrategy[], required — Pagination & contribution evidence per strategy. - `name` string, required - `pagesAttempted` integer, required - `newDirectReplies` integer, required - `newNestedReplies` integer, required - `stopReason` 'deadline' | 'empty_pages' | 'error' | 'missing_cursor' | 'no_next_page' | 'page_cap' | 'partial_view' | 'repeated_cursor', required - `duplicateCount` integer, required — Duplicate IDs removed across pages & strategies. - `cursorFailures` integer, required — Cursor requests that failed. - `repeatedCursorCount` integer, required — Looping cursors rejected. - `emptyFalseProgressPages` integer, required — Empty pages rejected for no progress. - `malformedCount` integer, required — Malformed response items rejected. - `unrelatedCount` integer, required — Tweets rejected from other conversations. - `missingResponseModulesOrFields` string[], required — Expected X modules or fields missing. - `recommendedFallback` string, required — Recommended next action when coverage is incomplete. - `richness` ReplyCoverageRichness, required — Field counts across collected direct replies. - `totalReplies` integer, required — Unique direct replies evaluated. - `text` integer, required — Replies with text. - `author` integer, required — Replies with author details. - `createdAt` integer, required — Replies with creation timestamps. - `language` integer, required — Replies with language. - `url` integer, required — Replies with canonical URLs. - `entities` integer, required — Replies with entities. - `media` integer, required — Replies with media. - `article` integer, required — Replies with articles. - `card` integer, required — Replies with cards. - `communityNote` integer, required — Replies with community notes. - `quotedOrRepostedTweet` integer, required — Replies with quotes or reposts. - `engagementCounts` integer, required — Replies with engagement counts. - `responseTruncated` boolean, required — Requested row limit truncated safe results. - `sourcesEnded` boolean, required — Every source ended. A retry returns the same rows. - `limit_reached` true — Present when your limit cut a complete-mode answer. The post has more replies; raise limit to get them all. - `message` string — Explains an answer cut by your limit. ## Other responses - `400` — Invalid input - `401` — Non-MPP paid reads require Bearer authentication. Missing credentials offer guest checkout without creating it. Invalid credentials return a plain error. Confirm before using any offered action. - `402` — Payment required. MPP reads include `WWW-Authenticate`. Authenticated reads include balances and checkout; a failed request never creates checkout. Guest keys offer top-up. - `404` — Not found - `409` — Cursor is in use. Retry `coverage_cursor_unavailable` later. - `410` — Restart without the `coverage_cursor_gone` cursor. - `424` — X did not expose every reply. Returned rows are billed as usual. An answer cut by your own limit returns 200 with limit_reached. - `429` — Xquik tier rate limit exceeded. Wait `Retry-After` seconds before retrying. - `502` — Dependency unavailable, unauthorized, or limited. Default v1 uses 502; best-practice responses use 424 for transparent dependency failures. Search answers 424 `search_unavailable` when X fails the query itself. - `503` — Retry x_api_unavailable after Retry-After & pagination_stalled once after 30 s. - `default` — Unexpected error. ## Changes - **2026-09-27** `c33250258fdf` — 8 breaking, 44 warning, 80 info - the `allOf[#/components/schemas/PaginatedTweets]/tweets/items/allOf[#/components/schemas/TweetPublicData]/allOf[subschema #2]/quoted_tweet` response's property type changed from no type to `object` for status `200` - the `allOf[#/components/schemas/PaginatedTweets]/tweets/items/allOf[#/components/schemas/TweetPublicData]/allOf[subschema #2]/retweeted_tweet` response's property type changed from no type to `object` for status `200` - the `allOf[subschema #2]/nested_replies/items/allOf[#/components/schemas/TweetPublicData]/allOf[subschema #2]/quoted_tweet` response's property type changed from no type to `object` for status `200` - the `allOf[subschema #2]/nested_replies/items/allOf[#/components/schemas/TweetPublicData]/allOf[subschema #2]/retweeted_tweet` response's property type changed from no type to `object` for status `200` - …128 more - …earlier changes not shown [Full history](https://skmtc.dev/xquik-dev/apis/xquik-api-2/changes/api/v1/x/tweets/:id/replies/get.md) --- [API](https://skmtc.dev/xquik-dev/apis/xquik-api-2.md) · [All operations](https://skmtc.dev/xquik-dev/apis/xquik-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/xquik-dev/apis/xquik-api-2/revisions/c33250258fdf?raw)