--- title: "GET /api/v1/x/tweets/{id}/thread" method: GET path: "/api/v1/x/tweets/{id}/thread" tags: ["Tweets"] --- # GET /api/v1/x/tweets/{id}/thread `GET /api/v1/x/tweets/{id}/thread` ## Request - Base URL: `https://xquik.com` - URL: `https://xquik.com/api/v1/x/tweets/{id}/thread` - Auth: one of: - API key in header `x-api-key` - HTTP bearer - none Returns visible posts from the selected conversation thread. Results exclude X ads. ## 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' - `minLikes` integer: Whole number from 0. - `minRetweets` integer: Whole number from 0. - `minReplies` integer: Whole number from 0. - `minQuotes` integer: Whole number from 0. - `minViews` integer: Whole number from 0. - `minBookmarks` integer: Whole number from 0. - `maxFaves` integer: Whole number from 0. - `maxRetweets` integer: Whole number from 0. - `maxReplies` integer: Whole number from 0. - `maxQuotes` integer: Whole number from 0. - `blueVerifiedOnly` boolean - `sinceId` string - `maxId` string - `withinTime` string - `nativeRetweets` 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 - `fields` string - `omit` string ## Response `200` Thread tweets - PaginatedTweets: Follow next_cursor while the response reports more pages. A page can hold fewer rows than its limit & still report more. That report decides, not the row count. A page can be empty & still report more, filtered or not. Automatic search, user Tweet & reply coverage keeps shape, filters, aliases & billing. Unprefixed cursors are legacy. - `filtered_count` integer: Whole number from 0. - `tweets` SearchTweet[], required - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isPinned` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `quotedTweetPermalink` object: The quoted post's link, kept when X withholds that post. - `displayUrl` string - `expandedUrl` string - `url` string - `quotedTweetUnavailable` object: Why X shows no quoted post. Omitted when X names no reason. - `reason` string, required: X's reason, such as `Suspended` for a suspended author or `Protected` for an author who protects their posts. - `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. - `allowedCountryCodes` string[]: Regions whose accounts may reply, as country codes. Sent with the `country_of_origin` mode. - `inviteViaMention` boolean - `mode` string: Reply policy from X's newer field, such as `my_network`, `premium` or `country_of_origin`. Omitted when X sends none. - `ownerId` string: The conversation owner's account ID. - `ownerUsername` string - `policy` string - `limitedActions` object[]: Public restrictions & prompts. - `action` string - `prompt` object - `ctaType` string - `headline` string - `metadata` PublicMetadata: Public metadata whose fields X defines. - `subtext` string - `source` string: The app the post was sent from, as X labels it. X sends it for some posts only. - `displayTextRange` WholeNumber[] - `textHighlights` object[]: Where `text` matches the search, on each row a search read. Offsets count code points of `text`, as `displayTextRange` does. Empty when X marks nothing in the post. X marks matches only in a post's first 280 characters. - `startIndex` integer, required: The first code point of the match. - `endIndex` integer, required: The first code point after the match. - `contentDisclosure` ContentDisclosure: Content disclosure metadata X shows on a labeled tweet. X labels paid partnership content and AI-generated media. - `advertising` object - `isPaidPromotion` boolean: True when X labels the tweet as paid promotion content. - `aiGenerated` object - `detectionSource` string: How X detected AI media. X omits it for self-declared posts. - `hasAiGeneratedMedia` boolean: True when X labels the tweet as containing AI-generated media. - `article` TweetArticleMetadata: An X Article preview and its lifecycle metadata. - `coverMedia` PublicMetadata: Public metadata whose fields X defines. - `id` string - `lifecycleState` PublicMetadata: Public metadata whose fields X defines. - `metadata` PublicMetadata: Public metadata whose fields X defines. - `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. - `unavailableAuthorId` string: The author's ID when X withholds the author's profile. - `card` TweetCard: A public card and the profiles it references. - `id` string - `name` string - `url` string - `bindingValues` PublicMetadata: Public metadata whose fields X defines. - `platform` PublicMetadata: Public metadata whose fields X defines. - `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: Omitted when X sends no count, as for the account that first posted reused media. - `following` integer - `verified` boolean - `isBlueVerified` boolean: Whether X shows a blue verification badge - `isVerified` boolean: Whether X marks the profile as verified - `profilePicture` string: Profile picture at 48 px, as X sends it. - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image. - `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 - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later. - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate. - `connectedVia` string: How the account first connected to X. - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate. - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page. - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none. - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none. - `emails` object[]: Emails in the bio, name or location, lowercased. - `value` string, required: The email address. - `domain` string, required: The part after the @ sign. - `source` 'bio' | 'name' | 'location', required: Profile field that holds the email. - `writtenAs` string: The account's own spelling, sent when it spelled the email out. - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts. - `value` string, required: The digits, with a leading + when the account wrote a country code. - `source` 'bio' | 'name' | 'location' | 'url', required: Profile field that holds the number. - `writtenAs` string: The account's own spelling of the number. - `links` object[]: The profile's website & the links in its bio. - `url` string, required: The link, as X expands it. - `network` string, required: Site the link belongs to, such as `linkedin`, `github` or `telegram`. Any other site is `website`. - `source` 'url' | 'bio', required: `url` for the website field, `bio` for a bio link. - `usernameChanges` object: How often the account changed its username. - `count` integer, required: Whole number from 0. - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none. - `birthdate` object: The parts of the birthday the account made public. - `day` integer - `month` integer - `year` integer - `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 X defines. - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines. - `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 X defines. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer: Whole number from 0. - `creatorSubscriptionsCount` integer: Whole number from 0. - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page. - `description` string - `isIdentityVerified` boolean: Whether the owner verified their ID with X. - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec. - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text. - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself. - `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 - `listedCount` integer: Public lists that include the profile. - `fastFollowersCount` integer: Followers X counts as fast followers. - `normalFollowersCount` integer: Followers minus fast followers. - `defaultProfile` boolean: Whether the profile keeps X's default theme. - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar. - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false. - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false. - `geoEnabled` boolean: Whether the profile may add a location to posts. - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them. - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads. - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`. - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none. - `verificationReason` object: X's text on why the profile is verified, with its links. - `text` string - `entities` object[]: Links inside the text, by character range. - `fromIndex` integer: Whole number from 0. - `toIndex` integer: Whole number from 0. - `url` string - `urlType` string - `communityRole` string: Community role when returned by community member reads - `profile_bio` PublicMetadata: Public metadata whose fields X defines. - `cashtagAttachments` object[]: Price charts the author attached under the post, 1 per cashtag. Absent when the post has none. X may send a cashtag without a chart window. - `cashtag` string, required: The cashtag with its `$`. - `candleSize` string: Span of each candle. - `timeframe` string: Span the chart covers. - `startTime` string, date-time: Time of the chart's first candle. - `endTime` string, date-time: Time of the chart's last price. - `sizeVariant` integer: X's size for the chart. - `communityId` string: Community ID. - `communityName` string: Community name. Present when X sends it with the post. - `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 X defines. - `hasCommunityNotes` boolean: Whether X holds Community Notes on the post, shown or not. - `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 X defines. - `grokTranslatedPost` PublicMetadata: Public metadata whose fields X defines. - `jetfuelAttachment` PublicMetadata: Public metadata whose fields X defines. - `noteTweet` TweetNote: Complete Note Tweet content and rich-text metadata. - `id` string: X's global ID of the Note, base64 of `NoteTweet:`. - `noteId` string: The Note's own ID, apart from the post's. - `text` string, required - `isExpandable` boolean - `entities` TweetEntities: Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - `indices` WholeNumber[] - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - … - `text` string, required - `smarttags` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - … - `symbols` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - … - `timestamps` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` WholeNumber[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` WholeNumber[] - `name` string - `screen_name` string, required - `inlineMedia` object[]: Inline media positions in the Note Tweet text. - `index` integer, required: Whole number from 0. - `mediaId` string, required - `richtextTags` object[] - `fromIndex` integer, required: Whole number from 0. - `toIndex` integer, required: Whole number from 0. - `types` string[], required - `place` TweetPlace: Public place metadata on a geotagged tweet. - `boundingBox` PublicMetadata: Public metadata whose fields X defines. - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `coordinates` TweetPoint: Author-published geographic point with 2 numeric coordinates. - `coordinates` number[], required - `type` 'Point', required - `geo` TweetPoint: Author-published geographic point with 2 numeric coordinates. - `coordinates` number[], required - `type` 'Point', required - `postCta` PublicMetadata: Public metadata whose fields X defines. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts: Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer: Whole number from 0. - `likeCount` integer: Whole number from 0. - `quoteCount` integer: Whole number from 0. - `replyCount` integer: Whole number from 0. - `retweetCount` integer: Whole number from 0. - `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: Omitted when X sends no count, as for the account that first posted reused media. - `following` integer - `verified` boolean - `isBlueVerified` boolean: Whether X shows a blue verification badge - `isVerified` boolean: Whether X marks the profile as verified - `profilePicture` string: Profile picture at 48 px, as X sends it. - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image. - `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 - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later. - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate. - `connectedVia` string: How the account first connected to X. - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate. - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page. - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none. - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none. - `emails` object[]: Emails in the bio, name or location, lowercased. - `value` string, required: The email address. - `domain` string, required: The part after the @ sign. - `source` 'bio' | 'name' | 'location', required: Profile field that holds the email. - `writtenAs` string: The account's own spelling, sent when it spelled the email out. - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts. - `value` string, required: The digits, with a leading + when the account wrote a country code. - `source` 'bio' | 'name' | 'location' | 'url', required: Profile field that holds the number. - `writtenAs` string: The account's own spelling of the number. - `links` object[]: The profile's website & the links in its bio. - `url` string, required: The link, as X expands it. - `network` string, required: Site the link belongs to, such as `linkedin`, `github` or `telegram`. Any other site is `website`. - `source` 'url' | 'bio', required: `url` for the website field, `bio` for a bio link. - `usernameChanges` object: How often the account changed its username. - `count` integer, required: Whole number from 0. - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none. - `birthdate` object: The parts of the birthday the account made public. - `day` integer - `month` integer - `year` integer - `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 X defines. - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines. - `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 X defines. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer: Whole number from 0. - `creatorSubscriptionsCount` integer: Whole number from 0. - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page. - `description` string - `isIdentityVerified` boolean: Whether the owner verified their ID with X. - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec. - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text. - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself. - `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 - `listedCount` integer: Public lists that include the profile. - `fastFollowersCount` integer: Followers X counts as fast followers. - `normalFollowersCount` integer: Followers minus fast followers. - `defaultProfile` boolean: Whether the profile keeps X's default theme. - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar. - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false. - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false. - `geoEnabled` boolean: Whether the profile may add a location to posts. - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them. - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads. - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`. - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none. - `verificationReason` object: X's text on why the profile is verified, with its links. - `text` string - `entities` object[]: Links inside the text, by character range. - `fromIndex` integer: Whole number from 0. - `toIndex` integer: Whole number from 0. - `url` string - `urlType` string - `communityRole` string: Community role when returned by community member reads - `profile_bio` PublicMetadata: Public metadata whose fields X defines. - `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. - `subscriberBadge` TweetSubscriberBadge: The Subscriber badge X shows on a reply. The reply's author subscribes to the creator who started the conversation. Omitted on a post without the badge. - `creatorId` string, required: Account ID of the creator the author subscribes to. - `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: Whole number from 0. - `toIndex` integer: Whole number from 0. - `ref` object - `type` string - `url` string - `urlType` string - `text` string - `screenName` string - `interstitial` TweetInterstitial: The notice x.com covers the post with until the reader views it, such as X's public interest notice on a post that broke its rules but stays up. - `displayType` string: How x.com shows the notice. `NonCompliant` marks a post that broke X's rules. - `text` object - `text` string: The notice's text. - `rtl` boolean: Whether X writes it right to left. - `entities` object[]: Links inside the notice, by character range. - `fromIndex` integer: Whole number from 0. - `toIndex` integer: Whole number from 0. - `ref` object - `type` string - `url` string - `urlType` string - `text` string - `screenName` 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` WholeNumber[] - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - `info` object - … - `text` string, required - `smarttags` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - `info` object - … - `symbols` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - `info` object - … - `timestamps` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - `info` object - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` WholeNumber[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` WholeNumber[] - `name` string - `screen_name` string, required - `scopes` PublicMetadata: Public metadata whose fields X defines. - `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` WholeNumber[]: Video width and height ratio. - `availabilityReason` string: Why X made the media unavailable, such as `Dmcaed` after a copyright report. Omitted on available media. - `availabilityStatus` string: Availability state, such as `Available` or `Unavailable`. - `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: Whole number from 0. - `y` integer, required: Whole number from 0. - `w` integer, required: Whole number from 0. - `h` integer, required: Whole number from 0. - `grokImageAnnotation` object: Prompt a Grok image came from. Absent on other media & when X sends no prompt. - `prompt` string: Prompt the image came from. - `upsampledPrompt` string: Grok's longer rewrite of the prompt. - `grokPostId` string: Grok post ID associated with the media. - `graphicViolence` boolean: Graphic-violence warning. - `height` integer: Original height. - `id` string: Media entity ID. - `indices` WholeNumber[]: 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. - `sourceUser` UserProfile: Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media. - `following` integer - `verified` boolean - `isBlueVerified` boolean: Whether X shows a blue verification badge - `isVerified` boolean: Whether X marks the profile as verified - `profilePicture` string: Profile picture at 48 px, as X sends it. - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image. - `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 - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later. - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate. - `connectedVia` string: How the account first connected to X. - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate. - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page. - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none. - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none. - `emails` object[]: Emails in the bio, name or location, lowercased. - `value` string, required: The email address. - `domain` string, required: The part after the @ sign. - `source` 'bio' | 'name' | 'location', required: Profile field that holds the email. - `writtenAs` string: The account's own spelling, sent when it spelled the email out. - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts. - `value` string, required: The digits, with a leading + when the account wrote a country code. - `source` 'bio' | 'name' | 'location' | 'url', required: Profile field that holds the number. - `writtenAs` string: The account's own spelling of the number. - `links` object[]: The profile's website & the links in its bio. - `url` string, required: The link, as X expands it. - `network` string, required: Site the link belongs to, such as `linkedin`, `github` or `telegram`. Any other site is `website`. - `source` 'url' | 'bio', required: `url` for the website field, `bio` for a bio link. - `usernameChanges` object: How often the account changed its username. - `count` integer, required: Whole number from 0. - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none. - `birthdate` object: The parts of the birthday the account made public. - `day` integer - `month` integer - `year` integer - `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 X defines. - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines. - `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 X defines. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer: Whole number from 0. - `creatorSubscriptionsCount` integer: Whole number from 0. - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page. - `description` string - `isIdentityVerified` boolean: Whether the owner verified their ID with X. - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec. - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text. - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself. - `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 - `listedCount` integer: Public lists that include the profile. - `fastFollowersCount` integer: Followers X counts as fast followers. - `normalFollowersCount` integer: Followers minus fast followers. - `defaultProfile` boolean: Whether the profile keeps X's default theme. - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar. - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false. - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false. - `geoEnabled` boolean: Whether the profile may add a location to posts. - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them. - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads. - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`. - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none. - `verificationReason` object: X's text on why the profile is verified, with its links. - `text` string - `entities` object[]: Links inside the text, by character range. - `fromIndex` integer: Whole number from 0. - `toIndex` integer: Whole number from 0. - `url` string - `urlType` string - `communityRole` string: Community role when returned by community member reads - `profile_bio` PublicMetadata: Public metadata whose fields X defines. - `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: Whole number from 0. - `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 - `unknownCounts` string[]: The counts X did not send for this post. Each one reads 0, so treat it as unknown rather than none. Names follow the response's key style, so `xquik-api-contract: 2026-04-29` lists bookmark_count. Posts from before X counted views, & new posts X has not counted views for yet, list viewCount. Left out when X sent every count. - `parentTweet` EmbeddedTweet: Public tweet fields, excluding nested tweets. `text` reads as x.com shows it, with `&`, `<` & `>` decoded. `displayTextRange` & entity `indices` count that text. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isPinned` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `quotedTweetPermalink` object: The quoted post's link, kept when X withholds that post. - `displayUrl` string - `expandedUrl` string - `url` string - `quotedTweetUnavailable` object: Why X shows no quoted post. Omitted when X names no reason. - `reason` string, required: X's reason, such as `Suspended` for a suspended author or `Protected` for an author who protects their posts. - `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. - `allowedCountryCodes` string[]: Regions whose accounts may reply, as country codes. Sent with the `country_of_origin` mode. - `inviteViaMention` boolean - `mode` string: Reply policy from X's newer field, such as `my_network`, `premium` or `country_of_origin`. Omitted when X sends none. - `ownerId` string: The conversation owner's account ID. - `ownerUsername` string - `policy` string - `limitedActions` object[]: Public restrictions & prompts. - `action` string - `prompt` object - `ctaType` string - `headline` string - `metadata` PublicMetadata: Public metadata whose fields X defines. - `subtext` string - `source` string: The app the post was sent from, as X labels it. X sends it for some posts only. - `displayTextRange` WholeNumber[] - `textHighlights` object[]: Where `text` matches the search, on each row a search read. Offsets count code points of `text`, as `displayTextRange` does. Empty when X marks nothing in the post. X marks matches only in a post's first 280 characters. - `startIndex` integer, required: The first code point of the match. - `endIndex` integer, required: The first code point after the match. - `contentDisclosure` ContentDisclosure: Content disclosure metadata X shows on a labeled tweet. X labels paid partnership content and AI-generated media. - `advertising` object - `isPaidPromotion` boolean: True when X labels the tweet as paid promotion content. - `aiGenerated` object - `detectionSource` string: How X detected AI media. X omits it for self-declared posts. - `hasAiGeneratedMedia` boolean: True when X labels the tweet as containing AI-generated media. - `article` TweetArticleMetadata: An X Article preview and its lifecycle metadata. - `coverMedia` PublicMetadata: Public metadata whose fields X defines. - `id` string - `lifecycleState` PublicMetadata: Public metadata whose fields X defines. - `metadata` PublicMetadata: Public metadata whose fields X defines. - `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. - `unavailableAuthorId` string: The author's ID when X withholds the author's profile. - `card` TweetCard: A public card and the profiles it references. - `id` string - `name` string - `url` string - `bindingValues` PublicMetadata: Public metadata whose fields X defines. - `platform` PublicMetadata: Public metadata whose fields X defines. - `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: Omitted when X sends no count, as for the account that first posted reused media. - `following` integer - `verified` boolean - `isBlueVerified` boolean: Whether X shows a blue verification badge - `isVerified` boolean: Whether X marks the profile as verified - `profilePicture` string: Profile picture at 48 px, as X sends it. - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image. - `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 - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later. - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate. - `connectedVia` string: How the account first connected to X. - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate. - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page. - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none. - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none. - `emails` object[]: Emails in the bio, name or location, lowercased. - … - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts. - … - `links` object[]: The profile's website & the links in its bio. - … - `usernameChanges` object: How often the account changed its username. - `count` integer, required: Whole number from 0. - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none. - `birthdate` object: The parts of the birthday the account made public. - `day` integer - `month` integer - `year` integer - `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 X defines. - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines. - `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 X defines. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer: Whole number from 0. - `creatorSubscriptionsCount` integer: Whole number from 0. - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page. - `description` string - `isIdentityVerified` boolean: Whether the owner verified their ID with X. - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec. - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text. - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself. - `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 - `listedCount` integer: Public lists that include the profile. - `fastFollowersCount` integer: Followers X counts as fast followers. - `normalFollowersCount` integer: Followers minus fast followers. - `defaultProfile` boolean: Whether the profile keeps X's default theme. - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar. - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false. - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false. - `geoEnabled` boolean: Whether the profile may add a location to posts. - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them. - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads. - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`. - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none. - `verificationReason` object: X's text on why the profile is verified, with its links. - `text` string - `entities` object[]: Links inside the text, by character range. - … - `communityRole` string: Community role when returned by community member reads - `profile_bio` PublicMetadata: Public metadata whose fields X defines. - `cashtagAttachments` object[]: Price charts the author attached under the post, 1 per cashtag. Absent when the post has none. X may send a cashtag without a chart window. - `cashtag` string, required: The cashtag with its `$`. - `candleSize` string: Span of each candle. - `timeframe` string: Span the chart covers. - `startTime` string, date-time: Time of the chart's first candle. - `endTime` string, date-time: Time of the chart's last price. - `sizeVariant` integer: X's size for the chart. - `communityId` string: Community ID. - `communityName` string: Community name. Present when X sends it with the post. - `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 X defines. - `hasCommunityNotes` boolean: Whether X holds Community Notes on the post, shown or not. - `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 X defines. - `grokTranslatedPost` PublicMetadata: Public metadata whose fields X defines. - `jetfuelAttachment` PublicMetadata: Public metadata whose fields X defines. - `noteTweet` TweetNote: Complete Note Tweet content and rich-text metadata. - `id` string: X's global ID of the Note, base64 of `NoteTweet:`. - `noteId` string: The Note's own ID, apart from the post's. - `text` string, required - `isExpandable` boolean - `entities` TweetEntities: Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - `indices` WholeNumber[] - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - … - `text` string, required - `smarttags` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - … - `symbols` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - … - `timestamps` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` WholeNumber[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` WholeNumber[] - `name` string - `screen_name` string, required - `inlineMedia` object[]: Inline media positions in the Note Tweet text. - `index` integer, required: Whole number from 0. - `mediaId` string, required - `richtextTags` object[] - `fromIndex` integer, required: Whole number from 0. - `toIndex` integer, required: Whole number from 0. - `types` string[], required - `place` TweetPlace: Public place metadata on a geotagged tweet. - `boundingBox` PublicMetadata: Public metadata whose fields X defines. - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `coordinates` TweetPoint: Author-published geographic point with 2 numeric coordinates. - `coordinates` number[], required - `type` 'Point', required - `geo` TweetPoint: Author-published geographic point with 2 numeric coordinates. - `coordinates` number[], required - `type` 'Point', required - `postCta` PublicMetadata: Public metadata whose fields X defines. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts: Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer: Whole number from 0. - `likeCount` integer: Whole number from 0. - `quoteCount` integer: Whole number from 0. - `replyCount` integer: Whole number from 0. - `retweetCount` integer: Whole number from 0. - `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: Omitted when X sends no count, as for the account that first posted reused media. - `following` integer - `verified` boolean - `isBlueVerified` boolean: Whether X shows a blue verification badge - `isVerified` boolean: Whether X marks the profile as verified - `profilePicture` string: Profile picture at 48 px, as X sends it. - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image. - `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 - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later. - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate. - `connectedVia` string: How the account first connected to X. - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate. - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page. - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none. - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none. - `emails` object[]: Emails in the bio, name or location, lowercased. - … - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts. - … - `links` object[]: The profile's website & the links in its bio. - … - `usernameChanges` object: How often the account changed its username. - `count` integer, required: Whole number from 0. - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none. - `birthdate` object: The parts of the birthday the account made public. - `day` integer - `month` integer - `year` integer - `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 X defines. - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines. - `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 X defines. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer: Whole number from 0. - `creatorSubscriptionsCount` integer: Whole number from 0. - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page. - `description` string - `isIdentityVerified` boolean: Whether the owner verified their ID with X. - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec. - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text. - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself. - `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 - `listedCount` integer: Public lists that include the profile. - `fastFollowersCount` integer: Followers X counts as fast followers. - `normalFollowersCount` integer: Followers minus fast followers. - `defaultProfile` boolean: Whether the profile keeps X's default theme. - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar. - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false. - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false. - `geoEnabled` boolean: Whether the profile may add a location to posts. - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them. - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads. - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`. - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none. - `verificationReason` object: X's text on why the profile is verified, with its links. - `text` string - `entities` object[]: Links inside the text, by character range. - … - `communityRole` string: Community role when returned by community member reads - `profile_bio` PublicMetadata: Public metadata whose fields X defines. - `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. - `subscriberBadge` TweetSubscriberBadge: The Subscriber badge X shows on a reply. The reply's author subscribes to the creator who started the conversation. Omitted on a post without the badge. - `creatorId` string, required: Account ID of the creator the author subscribes to. - `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: Whole number from 0. - `toIndex` integer: Whole number from 0. - `ref` object - … - `interstitial` TweetInterstitial: The notice x.com covers the post with until the reader views it, such as X's public interest notice on a post that broke its rules but stays up. - `displayType` string: How x.com shows the notice. `NonCompliant` marks a post that broke X's rules. - `text` object - `text` string: The notice's text. - `rtl` boolean: Whether X writes it right to left. - `entities` object[]: Links inside the notice, by character range. - `fromIndex` integer: Whole number from 0. - `toIndex` integer: Whole number from 0. - `ref` object - … - `unmentionedUserIds` string[]: User IDs that left this conversation. - `viewState` string - `entities` TweetEntities: Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - `indices` WholeNumber[] - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - … - `text` string, required - `smarttags` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - … - `symbols` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - … - `timestamps` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - `id` string: X's ID for the SmartTag. - `info` object - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` WholeNumber[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` WholeNumber[] - `name` string - `screen_name` string, required - `scopes` PublicMetadata: Public metadata whose fields X defines. - `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` WholeNumber[]: Video width and height ratio. - `availabilityReason` string: Why X made the media unavailable, such as `Dmcaed` after a copyright report. Omitted on available media. - `availabilityStatus` string: Availability state, such as `Available` or `Unavailable`. - `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: Whole number from 0. - `y` integer, required: Whole number from 0. - `w` integer, required: Whole number from 0. - `h` integer, required: Whole number from 0. - `grokImageAnnotation` object: Prompt a Grok image came from. Absent on other media & when X sends no prompt. - `prompt` string: Prompt the image came from. - `upsampledPrompt` string: Grok's longer rewrite of the prompt. - `grokPostId` string: Grok post ID associated with the media. - `graphicViolence` boolean: Graphic-violence warning. - `height` integer: Original height. - `id` string: Media entity ID. - `indices` WholeNumber[]: 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. - `sourceUser` UserProfile: Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media. - `following` integer - `verified` boolean - `isBlueVerified` boolean: Whether X shows a blue verification badge - `isVerified` boolean: Whether X marks the profile as verified - `profilePicture` string: Profile picture at 48 px, as X sends it. - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image. - `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 - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later. - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate. - `connectedVia` string: How the account first connected to X. - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate. - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page. - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none. - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none. - `emails` object[]: Emails in the bio, name or location, lowercased. - … - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts. - … - `links` object[]: The profile's website & the links in its bio. - … - `usernameChanges` object: How often the account changed its username. - `count` integer, required: Whole number from 0. - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none. - `birthdate` object: The parts of the birthday the account made public. - `day` integer - `month` integer - `year` integer - `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 X defines. - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines. - `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 X defines. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer: Whole number from 0. - `creatorSubscriptionsCount` integer: Whole number from 0. - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page. - `description` string - `isIdentityVerified` boolean: Whether the owner verified their ID with X. - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec. - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text. - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself. - `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 - `listedCount` integer: Public lists that include the profile. - `fastFollowersCount` integer: Followers X counts as fast followers. - `normalFollowersCount` integer: Followers minus fast followers. - `defaultProfile` boolean: Whether the profile keeps X's default theme. - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar. - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false. - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false. - `geoEnabled` boolean: Whether the profile may add a location to posts. - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them. - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads. - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`. - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none. - `verificationReason` object: X's text on why the profile is verified, with its links. - `text` string - `entities` object[]: Links inside the text, by character range. - … - `communityRole` string: Community role when returned by community member reads - `profile_bio` PublicMetadata: Public metadata whose fields X defines. - `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: Whole number from 0. - `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 - `unknownCounts` string[]: The counts X did not send for this post. Each one reads 0, so treat it as unknown rather than none. Names follow the response's key style, so `xquik-api-contract: 2026-04-29` lists bookmark_count. Posts from before X counted views, & new posts X has not counted views for yet, list viewCount. Left out when X sent every count. - `author` UserProfile: Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media. - `following` integer - `verified` boolean - `isBlueVerified` boolean: Whether X shows a blue verification badge - `isVerified` boolean: Whether X marks the profile as verified - `profilePicture` string: Profile picture at 48 px, as X sends it. - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image. - `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 - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later. - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate. - `connectedVia` string: How the account first connected to X. - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate. - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page. - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none. - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none. - `emails` object[]: Emails in the bio, name or location, lowercased. - `value` string, required: The email address. - `domain` string, required: The part after the @ sign. - `source` 'bio' | 'name' | 'location', required: Profile field that holds the email. - `writtenAs` string: The account's own spelling, sent when it spelled the email out. - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts. - `value` string, required: The digits, with a leading + when the account wrote a country code. - `source` 'bio' | 'name' | 'location' | 'url', required: Profile field that holds the number. - `writtenAs` string: The account's own spelling of the number. - `links` object[]: The profile's website & the links in its bio. - `url` string, required: The link, as X expands it. - `network` string, required: Site the link belongs to, such as `linkedin`, `github` or `telegram`. Any other site is `website`. - `source` 'url' | 'bio', required: `url` for the website field, `bio` for a bio link. - `usernameChanges` object: How often the account changed its username. - `count` integer, required: Whole number from 0. - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none. - `birthdate` object: The parts of the birthday the account made public. - `day` integer - `month` integer - `year` integer - `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 X defines. - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines. - `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 X defines. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer: Whole number from 0. - `creatorSubscriptionsCount` integer: Whole number from 0. - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page. - `description` string - `isIdentityVerified` boolean: Whether the owner verified their ID with X. - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec. - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text. - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself. - `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 - `listedCount` integer: Public lists that include the profile. - `fastFollowersCount` integer: Followers X counts as fast followers. - `normalFollowersCount` integer: Followers minus fast followers. - `defaultProfile` boolean: Whether the profile keeps X's default theme. - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar. - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false. - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false. - `geoEnabled` boolean: Whether the profile may add a location to posts. - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them. - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads. - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`. - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none. - `verificationReason` object: X's text on why the profile is verified, with its links. - `text` string - `entities` object[]: Links inside the text, by character range. - `fromIndex` integer: Whole number from 0. - `toIndex` integer: Whole number from 0. - `url` string - `urlType` string - `communityRole` string: Community role when returned by community member reads - `profile_bio` PublicMetadata: Public metadata whose fields X defines. - `parentTweet` object: The post this one replies to, with the same fields. - `quoted_tweet` object: The post this one quotes, with the same fields. - `retweeted_tweet` object: The post this one reposts, with the same fields. - `quoted_tweet` EmbeddedTweet: Public tweet fields, excluding nested tweets. `text` reads as x.com shows it, with `&`, `<` & `>` decoded. `displayTextRange` & entity `indices` count that text. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isPinned` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `quotedTweetPermalink` object: The quoted post's link, kept when X withholds that post. - `displayUrl` string - `expandedUrl` string - `url` string - `quotedTweetUnavailable` object: Why X shows no quoted post. Omitted when X names no reason. - `reason` string, required: X's reason, such as `Suspended` for a suspended author or `Protected` for an author who protects their posts. - `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. - `allowedCountryCodes` string[]: Regions whose accounts may reply, as country codes. Sent with the `country_of_origin` mode. - `inviteViaMention` boolean - `mode` string: Reply policy from X's newer field, such as `my_network`, `premium` or `country_of_origin`. Omitted when X sends none. - `ownerId` string: The conversation owner's account ID. - `ownerUsername` string - `policy` string - `limitedActions` object[]: Public restrictions & prompts. - `action` string - `prompt` object - `ctaType` string - `headline` string - `metadata` PublicMetadata: Public metadata whose fields X defines. - `subtext` string - `source` string: The app the post was sent from, as X labels it. X sends it for some posts only. - `displayTextRange` WholeNumber[] - `textHighlights` object[]: Where `text` matches the search, on each row a search read. Offsets count code points of `text`, as `displayTextRange` does. Empty when X marks nothing in the post. X marks matches only in a post's first 280 characters. - `startIndex` integer, required: The first code point of the match. - `endIndex` integer, required: The first code point after the match. - `contentDisclosure` ContentDisclosure: Content disclosure metadata X shows on a labeled tweet. X labels paid partnership content and AI-generated media. - `advertising` object - `isPaidPromotion` boolean: True when X labels the tweet as paid promotion content. - `aiGenerated` object - `detectionSource` string: How X detected AI media. X omits it for self-declared posts. - `hasAiGeneratedMedia` boolean: True when X labels the tweet as containing AI-generated media. - `article` TweetArticleMetadata: An X Article preview and its lifecycle metadata. - `coverMedia` PublicMetadata: Public metadata whose fields X defines. - `id` string - `lifecycleState` PublicMetadata: Public metadata whose fields X defines. - `metadata` PublicMetadata: Public metadata whose fields X defines. - `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. - `unavailableAuthorId` string: The author's ID when X withholds the author's profile. - `card` TweetCard: A public card and the profiles it references. - `id` string - `name` string - `url` string - `bindingValues` PublicMetadata: Public metadata whose fields X defines. - `platform` PublicMetadata: Public metadata whose fields X defines. - `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: Omitted when X sends no count, as for the account that first posted reused media. - `following` integer - `verified` boolean - `isBlueVerified` boolean: Whether X shows a blue verification badge - `isVerified` boolean: Whether X marks the profile as verified - `profilePicture` string: Profile picture at 48 px, as X sends it. - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image. - `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 - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later. - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate. - `connectedVia` string: How the account first connected to X. - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate. - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page. - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none. - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none. - `emails` object[]: Emails in the bio, name or location, lowercased. - … - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts. - … - `links` object[]: The profile's website & the links in its bio. - … - `usernameChanges` object: How often the account changed its username. - `count` integer, required: Whole number from 0. - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none. - `birthdate` object: The parts of the birthday the account made public. - `day` integer - `month` integer - `year` integer - `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 X defines. - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines. - `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 X defines. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer: Whole number from 0. - `creatorSubscriptionsCount` integer: Whole number from 0. - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page. - `description` string - `isIdentityVerified` boolean: Whether the owner verified their ID with X. - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec. - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text. - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself. - `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 - `listedCount` integer: Public lists that include the profile. - `fastFollowersCount` integer: Followers X counts as fast followers. - `normalFollowersCount` integer: Followers minus fast followers. - `defaultProfile` boolean: Whether the profile keeps X's default theme. - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar. - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false. - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false. - `geoEnabled` boolean: Whether the profile may add a location to posts. - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them. - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads. - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`. - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none. - `verificationReason` object: X's text on why the profile is verified, with its links. - `text` string - `entities` object[]: Links inside the text, by character range. - … - `communityRole` string: Community role when returned by community member reads - `profile_bio` PublicMetadata: Public metadata whose fields X defines. - `cashtagAttachments` object[]: Price charts the author attached under the post, 1 per cashtag. Absent when the post has none. X may send a cashtag without a chart window. - `cashtag` string, required: The cashtag with its `$`. - `candleSize` string: Span of each candle. - `timeframe` string: Span the chart covers. - `startTime` string, date-time: Time of the chart's first candle. - `endTime` string, date-time: Time of the chart's last price. - `sizeVariant` integer: X's size for the chart. - `communityId` string: Community ID. - `communityName` string: Community name. Present when X sends it with the post. - `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 X defines. - `hasCommunityNotes` boolean: Whether X holds Community Notes on the post, shown or not. - `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 X defines. - `grokTranslatedPost` PublicMetadata: Public metadata whose fields X defines. - `jetfuelAttachment` PublicMetadata: Public metadata whose fields X defines. - `noteTweet` TweetNote: Complete Note Tweet content and rich-text metadata. - `id` string: X's global ID of the Note, base64 of `NoteTweet:`. - `noteId` string: The Note's own ID, apart from the post's. - `text` string, required - `isExpandable` boolean - `entities` TweetEntities: Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - `indices` WholeNumber[] - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - … - `text` string, required - `smarttags` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - … - `symbols` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - … - `timestamps` TweetSymbol[] - `indices` WholeNumber[] - `seconds` number - `text` string - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader. - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` WholeNumber[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` WholeNumber[] - `name` string - `screen_name` string, required - `inlineMedia` object[]: Inline media positions in the Note Tweet text. - `index` integer, required: Whole number from 0. - `mediaId` string, required - `richtextTags` object[] - `fromIndex` integer, required: Whole number from 0. - `toIndex` integer, required: Whole number from 0. - … truncated; see the full OpenAPI document linked below ## Other responses - `400`: Invalid input. A value past its maxLength gets this answer, & the message names the field & its limit. - `401`: Non-MPP paid reads require Bearer authentication. Without credentials, the answer offers a guest checkout but does not create 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, plus checkout when the key can open it. A key that reads only gets the account page instead. A failed request never creates checkout. A caller on a plan gets top-up only, plus `credits_renew_at` when the plan renews. Guest keys offer top-up. - `404`: X shows no post with this ID. `reason` says why when X's answer named it. It is `deleted` with the message "The author deleted this post.", `author_suspended` with "X suspended this post's author.", or `protected` with "This post's author limits who can see it." Without `reason`, X named no cause, and the message is "Tweet not found. Check the tweet ID." - `424`: 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, or when its filters matched none of the last 3,000 posts read. The message says how far back the search read. - `429`: Too many requests right now. Each user gets 500 reads a second. Each minute allows 120 writes & 60 deletes. `x_api_rate_limited` means X limits this read for now. Neither answer costs anything. Wait for the seconds in `Retry-After`, then retry. - `500`: Unexpected error. - `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, or when its filters matched none of the last 3,000 posts read. The message says how far back the search read. - `503`: Retry x_api_unavailable after Retry-After. With X-Xquik-Busy, retry until your deadline. - `default`: Unexpected error. ## Changes - **2026-10-20** `45942c75fdc2`: 20 warning - added the new `topup_in_progress` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `429` - added the new `topup_in_progress` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #2: StructuredError]/code` response property for the response status `429` - added the new `topup_in_progress` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `400` - added the new `topup_in_progress` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `404` - …16 more [Operation history](https://skmtc.dev/xquik-dev/apis/xquik-api/changes/api/v1/x/tweets/:id/thread/get.md) --- [API](https://skmtc.dev/xquik-dev/apis/xquik-api.md) · [All operations](https://skmtc.dev/xquik-dev/apis/xquik-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xquik-dev/apis/xquik-api/revisions/45942c75fdc2?raw)