--- title: "GET /api/v1/x/users/batch/tweets" method: GET path: "/api/v1/x/users/batch/tweets" tags: ["Users"] --- # GET /api/v1/x/users/batch/tweets `GET /api/v1/x/users/batch/tweets` ## Request - Base URL: `https://xquik.com` - URL: `https://xquik.com/api/v1/x/users/batch/tweets` - Auth: one of: - API key in header `x-api-key` - HTTP bearer - none Returns the newest posts of up to 20 users, named by user ID, username or profile link, in the order named. Send ids or usernames, not both. Each post costs 1 credit. A user in unavailable_ids or unprocessed_ids costs nothing. ## Query parameters - `ids` string - `usernames` string - `pageSize` integer - `fields` string - `omit` string ## Response `200` Each user's newest posts, plus the users not read. - BatchUserTweets: Each user's newest posts, in the order the users were named, with the pinned post first. The ID lists name the requested IDs or usernames. They name a profile link by its username. - `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. - `types` string[], required - … 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. - `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`: 18 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 `424` - …14 more [Operation history](https://skmtc.dev/xquik-dev/apis/xquik-api/changes/api/v1/x/users/batch/tweets/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)