---
title: "GET /api/v1/events"
method: GET
path: "/api/v1/events"
tags: ["Events"]
---

# GET /api/v1/events

`GET /api/v1/events`

## Request

- Base URL: `https://xquik.com`
- URL: `https://xquik.com/api/v1/events`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns monitor events with cursor pagination and filters.

## Query parameters

- `limit` integer
- `cursor` string
- `monitorId` string
- `keywordMonitorId` string
- `eventType` 'tweet.new' | 'tweet.reply' | 'tweet.retweet' | 'tweet.quote' | 'tweet.media' | 'tweet.link' | 'tweet.poll' | 'tweet.mention' | 'tweet.hashtag' | 'tweet.longform' | 'profile.avatar.changed' | 'profile.banner.changed' | 'profile.name.changed' | 'profile.username.changed' | 'profile.bio.changed' | 'profile.location.changed' | 'profile.url.changed' | 'profile.verified.changed' | 'profile.protected.changed' | 'profile.pinned_tweet.changed' | 'profile.unavailable.changed' | 'tweet.deleted' | 'broadcast.started' | 'space.started' | 'following.added' | 'following.removed' | 'follower.added' | 'follower.removed' | 'profile.followers.changed' | 'profile.following.changed': Type of monitor event fired when account activity occurs. tweet.deleted fires once X confirms the account deleted a post the monitor saw. Its data is the post as last seen. broadcast.started & space.started fire when the account posts its running live video or Space. Their data is that post. Xquik misses a live video the account does not post. following.added & following.removed fire when the account follows or unfollows someone, with that account's profile. follower.added & follower.removed fire when someone follows the account or leaves its followers, with that account's profile. Xquik names lost followers for accounts with up to 100,000 followers. profile.followers.changed & profile.following.changed fire when the account's follower or following count moves, at most once a minute each. X shows counts that differ by a few between reads, so a monitor holds the lowest. A fall counts once 2 reads show it, & a rise once no read for a minute showed less. Keyword monitors take the 10 post types only.

## Response `200`

Event list

- object
  - `events` Event[], required
    - `id` string, required
    - `type` 'tweet.new' | 'tweet.reply' | 'tweet.retweet' | 'tweet.quote' | 'tweet.media' | 'tweet.link' | 'tweet.poll' | 'tweet.mention' | 'tweet.hashtag' | 'tweet.longform' | 'profile.avatar.changed' | 'profile.banner.changed' | 'profile.name.changed' | 'profile.username.changed' | 'profile.bio.changed' | 'profile.location.changed' | 'profile.url.changed' | 'profile.verified.changed' | 'profile.protected.changed' | 'profile.pinned_tweet.changed' | 'profile.unavailable.changed' | 'tweet.deleted' | 'broadcast.started' | 'space.started' | 'following.added' | 'following.removed' | 'follower.added' | 'follower.removed' | 'profile.followers.changed' | 'profile.following.changed', required: Type of monitor event fired when account activity occurs. tweet.deleted fires once X confirms the account deleted a post the monitor saw. Its data is the post as last seen. broadcast.started & space.started fire when the account posts its running live video or Space. Their data is that post. Xquik misses a live video the account does not post. following.added & following.removed fire when the account follows or unfollows someone, with that account's profile. follower.added & follower.removed fire when someone follows the account or leaves its followers, with that account's profile. Xquik names lost followers for accounts with up to 100,000 followers. profile.followers.changed & profile.following.changed fire when the account's follower or following count moves, at most once a minute each. X shows counts that differ by a few between reads, so a monitor holds the lowest. A fall counts once 2 reads show it, & a rise once no read for a minute showed less. Keyword monitors take the 10 post types only.
    - `username` string: Current account username, present for account monitor events.
    - `xUserId` string: Permanent X user ID of the monitored account, present for account monitor events. It stays the same after a username change.
    - `query` string: Keyword query, present for keyword monitor events.
    - `monitorId` string, required: Account monitor ID for account events, or keyword monitor ID for keyword events.
    - `monitorName` string: Your monitor label when Xquik created the event, present when set. A rename leaves the event's label unchanged.
    - `monitorType` 'account' | 'keyword', required: Source monitor type.
    - `keywordMonitorId` string: Keyword monitor ID, present for keyword monitor events.
    - `occurredAt` string, date-time, required: X's time of the event when X gives one, as for a post, a live video & a Space. Otherwise, the time Xquik saw it, as for a deleted post, a profile change & a follow list change.
    - `data` union, required: Post fields match REST. Legacy fields remain available.
      - MonitorPost: 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` object: 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` object[]
            - `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.
              - …
            - `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.
              - …
            - `usernameChanges` object: How often the account changed its username.
              - …
            - `birthdate` object: The parts of the birthday the account made public.
              - …
            - `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.
              - …
            - `businessAccountAffiliatesCount` integer: Whole number from 0.
            - `creatorSubscriptionsCount` integer: Whole number from 0.
            - `hasGraduatedAccess` boolean
            - `hasHiddenSubscriptionsOnProfile` boolean
            - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
              - …
            - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
              - …
            - `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.
              - …
            - `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.
              - …
            - `communityRole` string: Community role when returned by community member reads
            - `profile_bio` PublicMetadata: Public metadata whose fields X defines.
            - `userName` string: Legacy username alias. Read username instead.
            - `rawVerified` boolean: Original X flag. Read verified for the displayed badge.
        - `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>`.
          - `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[]
              - …
            - `smarttags` TweetSymbol[]
              - …
            - `symbols` TweetSymbol[]
              - …
            - `timestamps` TweetSymbol[]
              - …
            - `urls` TweetUrlEntity[]
              - …
            - `user_mentions` TweetUserMention[]
              - …
          - `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` object: 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.
              - …
            - `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.
              - …
            - `usernameChanges` object: How often the account changed its username.
              - …
            - `birthdate` object: The parts of the birthday the account made public.
              - …
            - `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.
              - …
            - `businessAccountAffiliatesCount` integer: Whole number from 0.
            - `creatorSubscriptionsCount` integer: Whole number from 0.
            - `hasGraduatedAccess` boolean
            - `hasHiddenSubscriptionsOnProfile` boolean
            - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
              - …
            - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
              - …
            - `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.
              - …
            - `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.
              - …
            - `communityRole` string: Community role when returned by community member reads
            - `profile_bio` PublicMetadata: Public metadata whose fields X defines.
            - `userName` string: Legacy username alias. Read username instead.
            - `rawVerified` boolean: Original X flag. Read verified for the displayed badge.
        - `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[]
              - …
        - `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.
              - …
        - `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.
              - …
            - `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
        - `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.
              - …
            - `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.
              - …
            - `usernameChanges` object: How often the account changed its username.
              - …
            - `birthdate` object: The parts of the birthday the account made public.
              - …
            - `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.
              - …
            - `businessAccountAffiliatesCount` integer: Whole number from 0.
            - `creatorSubscriptionsCount` integer: Whole number from 0.
            - `hasGraduatedAccess` boolean
            - `hasHiddenSubscriptionsOnProfile` boolean
            - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
              - …
            - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
              - …
            - `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.
              - …
            - `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.
              - …
            - `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
              - …
          - `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
              - …
            - `aiGenerated` object
              - …
          - `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.
              - …
            - `userReferences` UserProfile[]
              - …
          - `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>`.
            - `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.
              - …
            - `inlineMedia` object[]: Inline media positions in the Note Tweet text.
              - …
            - `richtextTags` object[]
              - …
          - `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.
              - …
          - `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.
              - …
            - `competitors` object[]: Teams & reported scores.
              - …
          - `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
              - …
          - `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
              - …
          - `unmentionedUserIds` string[]: User IDs that left this conversation.
          - `viewState` string
          - `entities` TweetEntities: Lists hashtags, symbols, links, and mentions from tweet text.
            - `hashtags` TweetHashtag[]
              - …
            - `smarttags` TweetSymbol[]
              - …
            - `symbols` TweetSymbol[]
              - …
            - `timestamps` TweetSymbol[]
              - …
            - `urls` TweetUrlEntity[]
              - …
            - `user_mentions` TweetUserMention[]
              - …
          - `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.
              - …
            - `grokImageAnnotation` object: Prompt a Grok image came from. Absent on other media & when X sends no 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.
              - …
            - `sourceUserId` string: Source profile ID for copied media.
            - `tags` object[]: Public profiles tagged in the media.
              - …
            - `title` string: Media title.
            - `videoVariants` object[]: Video encodings in source order.
              - …
            - `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.
              - …
            - `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.
              - …
            - `usernameChanges` object: How often the account changed its username.
              - …
            - `birthdate` object: The parts of the birthday the account made public.
              - …
            - `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.
              - …
            - `businessAccountAffiliatesCount` integer: Whole number from 0.
            - `creatorSubscriptionsCount` integer: Whole number from 0.
            - `hasGraduatedAccess` boolean
            - `hasHiddenSubscriptionsOnProfile` boolean
            - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
              - …
            - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
              - …
            - `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.
              - …
            - `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.
              - …
            - `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` object: 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
              - …
          - `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
              - …
            - `aiGenerated` object
              - …
          - `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.
              - …
            - `userReferences` UserProfile[]
              - …
          - `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>`.
            - `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.
              - …
            - `inlineMedia` object[]: Inline media positions in the Note Tweet text.
              - …
            - `richtextTags` object[]
              - …
          - `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.
              - …
          - `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.
              - …
            - `competitors` object[]: Teams & reported scores.
              - …
          - `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
              - …
          - `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
              - …
          - `unmentionedUserIds` string[]: User IDs that left this conversation.
          - `viewState` string
          - `entities` TweetEntities: Lists hashtags, symbols, links, and mentions from tweet text.
            - `hashtags` TweetHashtag[]
              - …
            - `smarttags` TweetSymbol[]
              - …
            - `symbols` TweetSymbol[]
              - …
            - `timestamps` TweetSymbol[]
              - …
            - `urls` TweetUrlEntity[]
              - …
            - `user_mentions` TweetUserMention[]
              - …
          - `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.
              - …
            - `grokImageAnnotation` object: Prompt a Grok image came from. Absent on other media & when X sends no 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.
              - …
            - `sourceUserId` string: Source profile ID for copied media.
            - `tags` object[]: Public profiles tagged in the media.
              - …
            - `title` string: Media title.
            - `videoVariants` object[]: Video encodings in source order.
              - …
            - `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` object: 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.
              - …
            - `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.
              - …
            - `usernameChanges` object: How often the account changed its username.
              - …
            - `birthdate` object: The parts of the birthday the account made public.
              - …
            - `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.
              - …
            - `businessAccountAffiliatesCount` integer: Whole number from 0.
            - `creatorSubscriptionsCount` integer: Whole number from 0.
            - `hasGraduatedAccess` boolean
            - `hasHiddenSubscriptionsOnProfile` boolean
            - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
              - …
            - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
              - …
            - `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.
              - …
            - `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.
              - …
            - `communityRole` string: Community role when returned by community member reads
            - `profile_bio` PublicMetadata: Public metadata whose fields X defines.
            - `userName` string: Legacy username alias. Read username instead.
            - `rawVerified` boolean: Original X flag. Read verified for the displayed badge.
          - `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.
        - `retweeted_tweet` object: 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
              - …
          - `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
              - …
            - `aiGenerated` object
              - …
          - `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.
              - …
            - `userReferences` UserProfile[]
              - …
          - `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>`.
            - `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.
              - …
            - `inlineMedia` object[]: Inline media positions in the Note Tweet text.
              - …
            - `richtextTags` object[]
              - …
          - `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.
              - …
          - `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.
              - …
            - `competitors` object[]: Teams & reported scores.
              - …
          - `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
              - …
          - `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
              - …
          - `unmentionedUserIds` string[]: User IDs that left this conversation.
          - `viewState` string
          - `entities` TweetEntities: Lists hashtags, symbols, links, and mentions from tweet text.
            - `hashtags` TweetHashtag[]
              - …
            - `smarttags` TweetSymbol[]
              - …
            - `symbols` TweetSymbol[]
              - …
            - `timestamps` TweetSymbol[]
              - …
            - `urls` TweetUrlEntity[]
              - …
            - `user_mentions` TweetUserMention[]
              - …
          - `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.
              - …
            - `grokImageAnnotation` object: Prompt a Grok image came from. Absent on other media & when X sends no 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.
              - …
            - `sourceUserId` string: Source profile ID for copied media.
            - `tags` object[]: Public profiles tagged in the media.
              - …
            - `title` string: Media title.
            - `videoVariants` object[]: Video encodings in source order.
              - …
            - `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` object: 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.
              - …
            - `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.
              - …
            - `usernameChanges` object: How often the account changed its username.
              - …
            - `birthdate` object: The parts of the birthday the account made public.
              - …
            - `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.
              - …
            - `businessAccountAffiliatesCount` integer: Whole number from 0.
            - `creatorSubscriptionsCount` integer: Whole number from 0.
            - `hasGraduatedAccess` boolean
            - `hasHiddenSubscriptionsOnProfile` boolean
            - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
              - …
            - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
              - …
            - `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.
              - …
            - `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.
              - …
            - `communityRole` string: Community role when returned by community member reads
            - `profile_bio` PublicMetadata: Public metadata whose fields X defines.
            - `userName` string: Legacy username alias. Read username instead.
            - `rawVerified` boolean: Original X flag. Read verified for the displayed badge.
          - `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.
        - `author` MonitorProfile: 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.
          - `userName` string: Legacy username alias. Read username instead.
          - `rawVerified` boolean: Original X flag. Read verified for the displayed badge.
      - MonitorProfileChange: Changed profile field with its previous and current values. The field of a count event is followers or following, with both counts as integers.
        - `field` string, required
        - `change` integer: Current count minus previous count. Only on the 2 count events.
        - `userId` string, required: Permanent X user ID.
        - `username` string, required: Username observed for this change.
        - `previous` union: Profile text, flag, count, or pinned post IDs. Missing values are omitted.
          - string
          - boolean
          - integer
          - string[]
        - `current` union: Profile text, flag, count, or pinned post IDs. Missing values are omitted.
          - string
          - boolean
          - integer
          - string[]
      - MonitorFollow: The other account of a following or follower event, with the profile fields a user lookup returns. It holds the ID alone when X fails the profile lookup.
        - `id` string, required: The other account's X user ID.
        - `followedAt` string, date-time: X's time of the follow, on following.added & follower.added. It is missing when X gives none, as for an account that returns to a list.
        - `followedAtExact` boolean: Whether followedAt is X's exact time of this follow. When several accounts join between 2 checks, X times the first, the second & the last. Each other one holds the earliest time its follow can have, with false here.
        - `reason` 'unavailable' | 'unfollowed': Why the account left the list, on following.removed & follower.removed. unavailable means X no longer serves the account. unfollowed means X's follow check says the follow ended. It is missing when X fails the check. Xquik sends no removal while X still confirms the follow.
      - MonitorLegacyPost: Older stored posts remain readable. Fields can be missing or null.
        - `id` string
        - `text` string
        - `author` object, nullable
        - `quoted_tweet` object, nullable
        - `retweeted_tweet` object, nullable
  - `hasMore` boolean, required
  - `nextCursor` string

## Other responses

- `400`: Invalid input. A value past its maxLength gets this answer, & the message names the field & its limit.
- `401`: Unauthenticated
- `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.
- `default`: Unexpected error.

## Changes

- **2026-10-20** `45942c75fdc2`: 10 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 `401`
  - …6 more

[Operation history](https://skmtc.dev/xquik-dev/apis/xquik-api/changes/api/v1/events/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)