--- title: "Get full conversation thread for a tweet" method: GET path: "/api/v1/x/tweets/{id}/thread" tags: ["Tweets"] --- # Get full conversation thread for a tweet `GET /api/v1/x/tweets/{id}/thread` Get full conversation thread for a tweet. ## Path parameters - `id` string, required ## Query parameters - `cursor` string - `pageSize` integer - `fromUser` string - `toUser` string - `mentioning` string - `language` string - `sinceDate` string, date - `untilDate` string, date - `mediaType` 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none' - `minFaves` integer - `minRetweets` integer - `minReplies` integer - `minQuotes` integer - `minViews` integer - `minBookmarks` integer - `maxFaves` integer - `maxRetweets` integer - `maxReplies` integer - `maxQuotes` integer - `blueVerifiedOnly` 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` Thread tweets - PaginatedTweets — Automatic search, user Tweet, and reply coverage preserves shape, filters, aliases, and billing. Follow next_cursor while has_next_page is true. An empty filtered page can still have has_next_page true. Unprefixed cursors are legacy. - `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 - `inReplyToId` string - `inReplyToUserId` string - `inReplyToUsername` string - `conversationId` 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 — Article metadata attached to a tweet. - `id` string - `title` string - `previewText` string - `coverMediaUrl` string - `card` TweetCard — Public card metadata attached to a tweet. - `id` string - `name` string - `url` string - `bindingValues` object - `communityId` string — Community ID. - `communityNote` TweetCommunityNote — Community Note presentation metadata returned by X. - `id` string - `title` string - `shortTitle` string - `subtitle` string - `footer` string - `destinationUrl` string - `visualStyle` string - `edit` TweetEdit — Tweet edits. - `editTweetIds` string[] - `editableUntilMsecs` string - `initialTweetId` string - `isTranslatable` boolean - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - `id` string - `text` string, required - `isExpandable` boolean - `entities` TweetEntities — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - `info` object - … - `timestamps` 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 - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Public place metadata attached to a tweet. - `boundingBox` object - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer - `likeCount` integer - `quoteCount` integer - `replyCount` integer - `retweetCount` integer - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - `info` object - `info` object - … - `timestamps` 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 - `quoted_tweet` EmbeddedTweet — Public fields shared by tweet response shapes. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `inReplyToId` string - `inReplyToUserId` string - `inReplyToUsername` string - `conversationId` 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 — Article metadata attached to a tweet. - `id` string - `title` string - `previewText` string - `coverMediaUrl` string - `card` TweetCard — Public card metadata attached to a tweet. - `id` string - `name` string - `url` string - `bindingValues` object - `communityId` string — Community ID. - `communityNote` TweetCommunityNote — Community Note presentation metadata returned by X. - `id` string - `title` string - `shortTitle` string - `subtitle` string - `footer` string - `destinationUrl` string - `visualStyle` string - `edit` TweetEdit — Tweet edits. - `editTweetIds` string[] - `editableUntilMsecs` string - `initialTweetId` string - `isTranslatable` boolean - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - `id` string - `text` string, required - `isExpandable` boolean - `entities` TweetEntities — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - … - `timestamps` 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 - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Public place metadata attached to a tweet. - `boundingBox` object - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer - `likeCount` integer - `quoteCount` integer - `replyCount` integer - `retweetCount` integer - `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 - … - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - `info` object - … - `timestamps` 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 - `quoted_tweet` EmbeddedTweet — recursive - `retweeted_tweet` EmbeddedTweet — recursive - `media` TweetMedia[] — Attached media items, 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. - `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 - `height` integer — Original height. - `id` string — Media entity ID. - `indices` integer[] — Tweet text offsets. - `mediaKey` string — Stable X media key. - `monetizable` boolean — Monetization status. - `sizes` object — Named media renditions and resize modes. - `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 - `width` integer — Original width. - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — X user profile with bio, follower counts, and verification status. - `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 - `createdAt` string - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `possiblySensitive` boolean - `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 - `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 - `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` object — Structured profile bio with entity annotations - `retweeted_tweet` EmbeddedTweet — Public fields shared by tweet response shapes. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `inReplyToId` string - `inReplyToUserId` string - `inReplyToUsername` string - `conversationId` 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 — Article metadata attached to a tweet. - `id` string - `title` string - `previewText` string - `coverMediaUrl` string - `card` TweetCard — Public card metadata attached to a tweet. - `id` string - `name` string - `url` string - `bindingValues` object - `communityId` string — Community ID. - `communityNote` TweetCommunityNote — Community Note presentation metadata returned by X. - `id` string - `title` string - `shortTitle` string - `subtitle` string - `footer` string - `destinationUrl` string - `visualStyle` string - `edit` TweetEdit — Tweet edits. - `editTweetIds` string[] - `editableUntilMsecs` string - `initialTweetId` string - `isTranslatable` boolean - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - `id` string - `text` string, required - `isExpandable` boolean - `entities` TweetEntities — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - … - `timestamps` 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 - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Public place metadata attached to a tweet. - `boundingBox` object - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer - `likeCount` integer - `quoteCount` integer - `replyCount` integer - `retweetCount` integer - `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 - … - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - `info` object - … - `timestamps` 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 - `quoted_tweet` EmbeddedTweet — recursive - `retweeted_tweet` EmbeddedTweet — recursive - `media` TweetMedia[] — Attached media items, 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. - `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 - `height` integer — Original height. - `id` string — Media entity ID. - `indices` integer[] — Tweet text offsets. - `mediaKey` string — Stable X media key. - `monetizable` boolean — Monetization status. - `sizes` object — Named media renditions and resize modes. - `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 - `width` integer — Original width. - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — X user profile with bio, follower counts, and verification status. - `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 - `createdAt` string - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `possiblySensitive` boolean - `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 - `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 - `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` object — Structured profile bio with entity annotations - `media` TweetMedia[] — Attached media items, 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. - `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 - `height` integer — Original height. - `id` string — Media entity ID. - `indices` integer[] — Tweet text offsets. - `mediaKey` string — Stable X media key. - `monetizable` boolean — Monetization status. - `sizes` object — Named media renditions and resize modes. - `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 - `width` integer — Original width. - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — X user profile with bio, follower counts, and verification status. - `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 - `createdAt` string - `statusesCount` integer - `mediaCount` integer - `protected` boolean — Whether the profile protects its posts - `url` string - `favouritesCount` integer - `hasCustomTimelines` boolean - `isTranslator` boolean - `withheldInCountries` string[] - `possiblySensitive` boolean - `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 - `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 - `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` object — Structured profile bio with entity annotations - `has_next_page` boolean, required - `next_cursor` string, required ## Other responses - `400` — Invalid input - `401` — Non-MPP paid reads require Bearer authentication. Missing credentials advertise guest checkout without creating it. Invalid credentials return a plain error. Confirm before calling an advertised action. - `402` — Payment required. MPP reads include `WWW-Authenticate`. Authenticated reads include balances and checkout. Guest keys expose guest top-up only. A failed request never creates checkout. Confirm first. - `424` — Dependency unavailable, unauthorized, or rate limited. Default v1 returns 502. The best-practice response contract returns 424 for transparent dependency failures. - `429` — Xquik tier rate limit exceeded. The response includes a `Retry-After` header with the number of seconds to wait before retrying. - `502` — Dependency unavailable, unauthorized, or rate limited. Default v1 returns 502. The best-practice response contract returns 424 for transparent dependency failures. - `default` — Unexpected error. --- [API](https://skmtc.net/xquik-dev/apis/xquik-api-2.md) · [All operations](https://skmtc.net/xquik-dev/apis/xquik-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xquik-dev/xquik-api-2/revisions/d850227d3298/schema)