---
title: "GET /api/v1/x/community-notes/contributors/{alias}/deleted-notes"
method: GET
path: "/api/v1/x/community-notes/contributors/{alias}/deleted-notes"
tags: ["Community Notes"]
---

# GET /api/v1/x/community-notes/contributors/{alias}/deleted-notes

`GET /api/v1/x/community-notes/contributors/{alias}/deleted-notes`

## Request

- Base URL: `https://xquik.com`
- URL: `https://xquik.com/api/v1/x/community-notes/contributors/{alias}/deleted-notes`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - none

Returns the notes a contributor deleted, newest first. X keeps each note's ID, times, rating & tags. A notice replaces its text & post. Each note costs 1 credit. A contributor who deleted none returns an empty list, free.

## Path parameters

- `alias` string, required

## Query parameters

- `cursor` string
- `pageSize` integer
- `fields` string
- `omit` string

## Response `200`

Deleted notes

- PaginatedCommunityNotes: 1 page of Community Notes. Follow next_cursor while the response reports more pages.
  - `notes` CommunityNote[], required
    - `id` string, required: Note ID.
    - `createdAt` string, date-time: When the contributor wrote the note.
    - `language` string: Language code of the note.
    - `classification` string: What the writer says of the post, such as MisinformedOrPotentiallyMisleading or NotMisleading.
    - `text` string: What the note says.
    - `contributor` CommunityNotesContributor: A Community Notes contributor. X names contributors by an alias, never by their X account. A field X leaves out is left out. Beside a note, X sends its writer with only some of the counts.
      - `alias` string, required: The alias X gives the contributor.
      - `isTopWriter` boolean: Whether X marks the contributor as a top writer.
      - `isApiContributor` boolean: Whether the contributor writes notes through X's API.
      - `deletedNotesCount` integer: Whole number from 0.
      - `notesCount` CommunityNotesNoteCounts: How many notes a contributor wrote, by X's current rating.
        - `awaitingMoreRatings` integer: Whole number from 0.
        - `currentlyRatedHelpful` integer: Whole number from 0.
        - `currentlyRatedNotHelpful` integer: Whole number from 0.
        - `updatedAt` string, date-time: When X last counted the notes.
      - `ratingsCount` CommunityNotesRatingCounts: How a contributor's ratings of other notes went.
        - `awaitingMoreRatings` integer: Whole number from 0.
        - `ratedAfterDecision` integer: Whole number from 0.
        - `successful` CommunityNotesRatingOutcome: A group of a contributor's ratings, by what each one said.
          - `helpfulCount` integer: Whole number from 0.
          - `notHelpfulCount` integer: Whole number from 0.
          - `total` integer: Whole number from 0.
        - `unsuccessful` CommunityNotesRatingOutcome: A group of a contributor's ratings, by what each one said.
          - `helpfulCount` integer: Whole number from 0.
          - `notHelpfulCount` integer: Whole number from 0.
          - `total` integer: Whole number from 0.
        - `updatedAt` string, date-time: When X last counted the ratings.
    - `entities` CommunityNoteEntity[]: Links, tags & accounts inside the text, by character range.
      - `fromIndex` integer: Whole number from 0.
      - `toIndex` integer: Whole number from 0.
      - `ref` object: What it points at.
        - `type` string: X's kind, such as TimelineUrl.
        - `url` string: The link.
        - `urlType` string: How X opens the link, such as ExternalUrl.
        - `text` string: A hashtag's or cashtag's text.
        - `screenName` string: A mentioned account's username.
    - `ratingStatus` string: X's current rating, such as NeedsMoreRatings, CurrentlyRatedHelpful or CurrentlyRatedNotHelpful. x.com shows only helpful notes under posts.
    - `helpfulTags` string[]: Why raters called the note helpful.
    - `notHelpfulTags` string[]: Why raters called the note not helpful.
    - `decidedBy` string: The X scoring model that set the rating.
    - `fullyVisibleModel` boolean: Whether X marks that scoring model as fully visible.
    - `abovePcrhThreshold` boolean: Whether the note scores above X's bar for a possible helpful rating.
    - `appealStatus` string: Whether the rating is under appeal.
    - `deleted` boolean: Whether the writer deleted the note.
    - `tombstone` string: X's notice in place of a deleted note.
    - `isApiAuthor` boolean: Whether the note came through X's API.
    - `isMediaNote` boolean: Whether the note is about the post's media. X can show such a note on other posts.
    - `mediaNoteMatchCount` integer: Whole number from 0.
    - `isUrlNote` boolean: Whether the note is on a link.
    - `displayUrl` string: The link a link note is on, as X shows it.
    - `isTranslatable` boolean: Whether X offers a translation of the note.
    - `timeToHelpfulFromNoteMs` integer: Whole number from 0.
    - `timeToHelpfulFromPostMs` integer: Whole number from 0.
    - `impressionCount` integer: Whole number from 0.
    - `postId` string: ID of the post the note is on.
    - `post` SearchTweet: Public tweet fields, excluding nested tweets. `text` reads as x.com shows it, with `&`, `<` & `>` decoded. `displayTextRange` & entity `indices` count that text.
      - `id` string, required
      - `text` string, required
      - `type` string
      - `createdAt` string
      - `url` string
      - `lang` string
      - `isReply` boolean
      - `isLimitedReply` boolean
      - `isNoteTweet` boolean
      - `isPinned` boolean
      - `isQuoteStatus` boolean
      - `isRetweet` boolean
      - `quotedTweetId` string
      - `quotedTweetPermalink` object: The quoted post's link, kept when X withholds that post.
        - `displayUrl` string
        - `expandedUrl` string
        - `url` string
      - `quotedTweetUnavailable` object: Why X shows no quoted post. Omitted when X names no reason.
        - `reason` string, required: X's reason, such as `Suspended` for a suspended author or `Protected` for an author who protects their posts.
      - `retweetedAt` string, date-time, nullable: Repost event time in UTC. Null when unavailable. Omitted for other posts.
      - `inReplyToId` string
      - `inReplyToUserId` string
      - `inReplyToUsername` string
      - `conversationId` string
      - `conversationControl` object: Reply policy & conversation owner.
        - `allowedCountryCodes` string[]: Regions whose accounts may reply, as country codes. Sent with the `country_of_origin` mode.
        - `inviteViaMention` boolean
        - `mode` string: Reply policy from X's newer field, such as `my_network`, `premium` or `country_of_origin`. Omitted when X sends none.
        - `ownerId` string: The conversation owner's account ID.
        - `ownerUsername` string
        - `policy` string
      - `limitedActions` object[]: Public restrictions & prompts.
        - `action` string
        - `prompt` object
          - `ctaType` string
          - `headline` string
          - `metadata` PublicMetadata: Public metadata whose fields X defines.
          - `subtext` string
      - `source` string: The app the post was sent from, as X labels it. X sends it for some posts only.
      - `displayTextRange` WholeNumber[]
      - `textHighlights` object[]: Where `text` matches the search, on each row a search read. Offsets count code points of `text`, as `displayTextRange` does. Empty when X marks nothing in the post. X marks matches only in a post's first 280 characters.
        - `startIndex` integer, required: The first code point of the match.
        - `endIndex` integer, required: The first code point after the match.
      - `contentDisclosure` ContentDisclosure: Content disclosure metadata X shows on a labeled tweet. X labels paid partnership content and AI-generated media.
        - `advertising` object
          - `isPaidPromotion` boolean: True when X labels the tweet as paid promotion content.
        - `aiGenerated` object
          - `detectionSource` string: How X detected AI media. X omits it for self-declared posts.
          - `hasAiGeneratedMedia` boolean: True when X labels the tweet as containing AI-generated media.
      - `article` TweetArticleMetadata: An X Article preview and its lifecycle metadata.
        - `coverMedia` PublicMetadata: Public metadata whose fields X defines.
        - `id` string
        - `lifecycleState` PublicMetadata: Public metadata whose fields X defines.
        - `metadata` PublicMetadata: Public metadata whose fields X defines.
        - `title` string
        - `previewText` string
        - `coverMediaUrl` string
      - `authorUnavailable` TweetAuthorUnavailable: Why the tweet has no author. X serves a suspended or deleted account as an unavailable user with a reason such as Suspended or NotFound. Omitted when the author is available.
        - `reason` string, required: X's reason code.
        - `message` string: X's notice text for the reason.
      - `unavailableAuthorId` string: The author's ID when X withholds the author's profile.
      - `card` TweetCard: A public card and the profiles it references.
        - `id` string
        - `name` string
        - `url` string
        - `bindingValues` PublicMetadata: Public metadata whose fields X defines.
        - `platform` PublicMetadata: Public metadata whose fields X defines.
        - `userReferenceErrors` object[]: Unresolved card user references.
          - `message` string
          - `reason` string
        - `userReferences` UserProfile[]
          - `id` string, required
          - `username` string, required
          - `name` string, required
          - `description` string
          - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media.
          - `following` integer
          - `verified` boolean
          - `isBlueVerified` boolean: Whether X shows a blue verification badge
          - `isVerified` boolean: Whether X marks the profile as verified
          - `profilePicture` string: Profile picture at 48 px, as X sends it.
          - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image.
          - `coverPicture` string
          - `profileBannerUrl` string: Original X profile banner field when available
          - `location` string: Account owner's public profile location text
          - `accountBasedIn` AccountBasedIn: X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location.
            - `value` string, required
            - `level` 'country' | 'region', required
            - `observedAt` string, date-time, required
          - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later.
          - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate.
          - `connectedVia` string: How the account first connected to X.
          - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate.
          - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page.
          - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none.
          - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none.
            - `emails` object[]: Emails in the bio, name or location, lowercased.
              - …
            - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts.
              - …
            - `links` object[]: The profile's website & the links in its bio.
              - …
          - `usernameChanges` object: How often the account changed its username.
            - `count` integer, required: Whole number from 0.
            - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none.
          - `birthdate` object: The parts of the birthday the account made public.
            - `day` integer
            - `month` integer
            - `year` integer
          - `retweetedAt` string, date-time, nullable: UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed. Otherwise omitted.
          - `createdAt` string: Account creation time.
          - `statusesCount` integer
          - `mediaCount` integer
          - `protected` boolean: Whether the profile protects its posts
          - `url` string
          - `favouritesCount` integer
          - `hasCustomTimelines` boolean
          - `isTranslator` boolean
          - `withheldInCountries` string[]
          - `withheldScope` string: Whether X withholds a post or user
          - `possiblySensitive` boolean
          - `professional` PublicMetadata: Public metadata whose fields X defines.
          - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines.
          - `pinnedTweetIds` string[]
          - `isAutomated` boolean
          - `automatedBy` string
          - `unavailable` boolean
          - `unavailableReason` string
          - `verifiedType` string
          - `affiliatesHighlightedLabel` UserAffiliateLabel: Organization affiliation label shown on an X profile.
            - `badgeUrl` string
            - `description` string
            - `longDescription` PublicMetadata: Public metadata whose fields X defines.
            - `url` string
            - `urlType` string
            - `userLabelDisplayType` string
            - `userLabelType` string
          - `businessAccountAffiliatesCount` integer: Whole number from 0.
          - `creatorSubscriptionsCount` integer: Whole number from 0.
          - `hasGraduatedAccess` boolean
          - `hasHiddenSubscriptionsOnProfile` boolean
          - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
            - `canHighlightTweets` boolean
            - `highlightedTweets` string
          - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
            - `description` string
            - `isIdentityVerified` boolean: Whether the owner verified their ID with X.
            - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec.
            - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text.
          - `isProfileTranslatable` boolean
          - `parodyCommentaryFanLabel` string
          - `profileDescriptionLanguage` string
          - `profileImageShape` string
          - `profileInterstitialType` string
          - `profileSortEnabled` boolean
          - `profileTranslatorType` string
          - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself.
          - `superFollowEligible` boolean
          - `superFollowsUserProfileActive` boolean: Whether X marks the subscription profile as active.
          - `tipJar` UserTipJar: Public payment and creator-support handles shown on X.
            - `bandcampHandle` string
            - `bitcoinHandle` string
            - `cashAppHandle` string
            - `ethereumHandle` string
            - `gofundmeHandle` string
            - `isEnabled` boolean
            - `patreonHandle` string
            - `payPalHandle` string
            - `venmoHandle` string
          - `listedCount` integer: Public lists that include the profile.
          - `fastFollowersCount` integer: Followers X counts as fast followers.
          - `normalFollowersCount` integer: Followers minus fast followers.
          - `defaultProfile` boolean: Whether the profile keeps X's default theme.
          - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar.
          - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false.
          - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false.
          - `geoEnabled` boolean: Whether the profile may add a location to posts.
          - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them.
          - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads.
          - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`.
          - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none.
          - `verificationReason` object: X's text on why the profile is verified, with its links.
            - `text` string
            - `entities` object[]: Links inside the text, by character range.
              - …
          - `communityRole` string: Community role when returned by community member reads
          - `profile_bio` PublicMetadata: Public metadata whose fields X defines.
      - `cashtagAttachments` object[]: Price charts the author attached under the post, 1 per cashtag. Absent when the post has none. X may send a cashtag without a chart window.
        - `cashtag` string, required: The cashtag with its `$`.
        - `candleSize` string: Span of each candle.
        - `timeframe` string: Span the chart covers.
        - `startTime` string, date-time: Time of the chart's first candle.
        - `endTime` string, date-time: Time of the chart's last price.
        - `sizeVariant` integer: X's size for the chart.
      - `communityId` string: Community ID.
      - `communityName` string: Community name. Present when X sends it with the post.
      - `communityNote` TweetCommunityNote: Community Note presentation metadata returned by X.
        - `id` string
        - `title` string
        - `shortTitle` string
        - `subtitle` string
        - `footer` string
        - `footerIconType` string
        - `destinationUrl` string
        - `iconType` string
        - `visualStyle` string
        - `metadata` PublicMetadata: Public metadata whose fields X defines.
      - `hasCommunityNotes` boolean: Whether X holds Community Notes on the post, shown or not.
      - `edit` TweetEdit: Lists edit-chain identifiers and the remaining edit window.
        - `editTweetIds` string[]
        - `editableUntilMsecs` string
        - `initialTweetId` string
      - `exclusiveContent` TweetExclusiveContent: Marks a subscriber-only post with the creator whose subscription unlocks it. Non-subscribers get the preview text & the subscribe link. Omitted on public posts.
        - `creatorUserName` string, required: Username of the creator whose subscription unlocks the post.
        - `subscribeUrl` string: Subscribe link X shows non-subscribers. Omitted when X serves the full post.
      - `isTranslatable` boolean
      - `grokShareAttachment` PublicMetadata: Public metadata whose fields X defines.
      - `grokTranslatedPost` PublicMetadata: Public metadata whose fields X defines.
      - `jetfuelAttachment` PublicMetadata: Public metadata whose fields X defines.
      - `noteTweet` TweetNote: Complete Note Tweet content and rich-text metadata.
        - `id` string: X's global ID of the Note, base64 of `NoteTweet:<noteId>`.
        - `noteId` string: The Note's own ID, apart from the post's.
        - `text` string, required
        - `isExpandable` boolean
        - `entities` TweetEntities: Lists hashtags, symbols, links, and mentions from tweet text.
          - `hashtags` TweetHashtag[]
            - `indices` WholeNumber[]
            - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader.
              - …
            - `text` string, required
          - `smarttags` TweetSymbol[]
            - `indices` WholeNumber[]
            - `seconds` number
            - `text` string
            - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader.
              - …
          - `symbols` TweetSymbol[]
            - `indices` WholeNumber[]
            - `seconds` number
            - `text` string
            - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader.
              - …
          - `timestamps` TweetSymbol[]
            - `indices` WholeNumber[]
            - `seconds` number
            - `text` string
            - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader.
              - …
          - `urls` TweetUrlEntity[]
            - `display_url` string
            - `expanded_url` string
            - `indices` WholeNumber[]
            - `url` string
          - `user_mentions` TweetUserMention[]
            - `id_str` string
            - `indices` WholeNumber[]
            - `name` string
            - `screen_name` string, required
        - `inlineMedia` object[]: Inline media positions in the Note Tweet text.
          - `index` integer, required: Whole number from 0.
          - `mediaId` string, required
        - `richtextTags` object[]
          - `fromIndex` integer, required: Whole number from 0.
          - `toIndex` integer, required: Whole number from 0.
          - `types` string[], required
      - `place` TweetPlace: Public place metadata on a geotagged tweet.
        - `boundingBox` PublicMetadata: Public metadata whose fields X defines.
        - `country` string
        - `countryCode` string
        - `fullName` string
        - `id` string
        - `name` string
        - `placeType` string
        - `url` string
      - `coordinates` TweetPoint: Author-published geographic point with 2 numeric coordinates.
        - `coordinates` number[], required
        - `type` 'Point', required
      - `geo` TweetPoint: Author-published geographic point with 2 numeric coordinates.
        - `coordinates` number[], required
        - `type` 'Point', required
      - `postCta` PublicMetadata: Public metadata whose fields X defines.
      - `possiblySensitive` boolean
      - `previousCounts` TweetPreviousCounts: Engagement counts retained from a prior tweet edit.
        - `bookmarkCount` integer: Whole number from 0.
        - `likeCount` integer: Whole number from 0.
        - `quoteCount` integer: Whole number from 0.
        - `replyCount` integer: Whole number from 0.
        - `retweetCount` integer: Whole number from 0.
      - `reactionContext` object: Public post & user this reaction references.
        - `reactedToPostId` string: Referenced post ID.
        - `reactedToUser` UserProfile: Public X profile.
          - `id` string, required
          - `username` string, required
          - `name` string, required
          - `description` string
          - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media.
          - `following` integer
          - `verified` boolean
          - `isBlueVerified` boolean: Whether X shows a blue verification badge
          - `isVerified` boolean: Whether X marks the profile as verified
          - `profilePicture` string: Profile picture at 48 px, as X sends it.
          - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image.
          - `coverPicture` string
          - `profileBannerUrl` string: Original X profile banner field when available
          - `location` string: Account owner's public profile location text
          - `accountBasedIn` AccountBasedIn: X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location.
            - `value` string, required
            - `level` 'country' | 'region', required
            - `observedAt` string, date-time, required
          - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later.
          - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate.
          - `connectedVia` string: How the account first connected to X.
          - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate.
          - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page.
          - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none.
          - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none.
            - `emails` object[]: Emails in the bio, name or location, lowercased.
              - …
            - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts.
              - …
            - `links` object[]: The profile's website & the links in its bio.
              - …
          - `usernameChanges` object: How often the account changed its username.
            - `count` integer, required: Whole number from 0.
            - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none.
          - `birthdate` object: The parts of the birthday the account made public.
            - `day` integer
            - `month` integer
            - `year` integer
          - `retweetedAt` string, date-time, nullable: UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed. Otherwise omitted.
          - `createdAt` string: Account creation time.
          - `statusesCount` integer
          - `mediaCount` integer
          - `protected` boolean: Whether the profile protects its posts
          - `url` string
          - `favouritesCount` integer
          - `hasCustomTimelines` boolean
          - `isTranslator` boolean
          - `withheldInCountries` string[]
          - `withheldScope` string: Whether X withholds a post or user
          - `possiblySensitive` boolean
          - `professional` PublicMetadata: Public metadata whose fields X defines.
          - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines.
          - `pinnedTweetIds` string[]
          - `isAutomated` boolean
          - `automatedBy` string
          - `unavailable` boolean
          - `unavailableReason` string
          - `verifiedType` string
          - `affiliatesHighlightedLabel` UserAffiliateLabel: Organization affiliation label shown on an X profile.
            - `badgeUrl` string
            - `description` string
            - `longDescription` PublicMetadata: Public metadata whose fields X defines.
            - `url` string
            - `urlType` string
            - `userLabelDisplayType` string
            - `userLabelType` string
          - `businessAccountAffiliatesCount` integer: Whole number from 0.
          - `creatorSubscriptionsCount` integer: Whole number from 0.
          - `hasGraduatedAccess` boolean
          - `hasHiddenSubscriptionsOnProfile` boolean
          - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
            - `canHighlightTweets` boolean
            - `highlightedTweets` string
          - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
            - `description` string
            - `isIdentityVerified` boolean: Whether the owner verified their ID with X.
            - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec.
            - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text.
          - `isProfileTranslatable` boolean
          - `parodyCommentaryFanLabel` string
          - `profileDescriptionLanguage` string
          - `profileImageShape` string
          - `profileInterstitialType` string
          - `profileSortEnabled` boolean
          - `profileTranslatorType` string
          - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself.
          - `superFollowEligible` boolean
          - `superFollowsUserProfileActive` boolean: Whether X marks the subscription profile as active.
          - `tipJar` UserTipJar: Public payment and creator-support handles shown on X.
            - `bandcampHandle` string
            - `bitcoinHandle` string
            - `cashAppHandle` string
            - `ethereumHandle` string
            - `gofundmeHandle` string
            - `isEnabled` boolean
            - `patreonHandle` string
            - `payPalHandle` string
            - `venmoHandle` string
          - `listedCount` integer: Public lists that include the profile.
          - `fastFollowersCount` integer: Followers X counts as fast followers.
          - `normalFollowersCount` integer: Followers minus fast followers.
          - `defaultProfile` boolean: Whether the profile keeps X's default theme.
          - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar.
          - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false.
          - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false.
          - `geoEnabled` boolean: Whether the profile may add a location to posts.
          - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them.
          - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads.
          - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`.
          - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none.
          - `verificationReason` object: X's text on why the profile is verified, with its links.
            - `text` string
            - `entities` object[]: Links inside the text, by character range.
              - …
          - `communityRole` string: Community role when returned by community member reads
          - `profile_bio` PublicMetadata: Public metadata whose fields X defines.
      - `sportsContext` object: Game metadata attached to this post.
        - `gameId` string: Game ID.
        - `league` string: League ID.
        - `title` string: Game title.
        - `url` string: Game link.
        - `state` string: Reported game state.
        - `statusText` string: Game progress text.
        - `scheduledAtMs` union: Scheduled Unix milliseconds, retaining the source type.
          - number
          - string
        - `competitors` object[]: Teams & reported scores.
          - `teamId` string: Team ID.
          - `color` string: Team display color.
          - `isActive` boolean: Active competitor.
          - `isWinner` boolean: Winning competitor.
          - `abbreviation` string: Team abbreviation.
          - `name` string: Team name.
          - `score` string: Score display text.
          - `logoUrl` string: Logo for light backgrounds.
          - `darkLogoUrl` string: Logo for dark backgrounds.
      - `subscriberBadge` TweetSubscriberBadge: The Subscriber badge X shows on a reply. The reply's author subscribes to the creator who started the conversation. Omitted on a post without the badge.
        - `creatorId` string, required: Account ID of the creator the author subscribes to.
      - `tombstone` TweetTombstone: Public visibility notice attached to an available tweet.
        - `type` string: Visibility notice type.
        - `text` object
          - `text` string: Human-readable notice text.
          - `rtl` boolean: Right-to-left text direction.
          - `entities` object[]
            - `fromIndex` integer: Whole number from 0.
            - `toIndex` integer: Whole number from 0.
            - `ref` object
              - …
      - `interstitial` TweetInterstitial: The notice x.com covers the post with until the reader views it, such as X's public interest notice on a post that broke its rules but stays up.
        - `displayType` string: How x.com shows the notice. `NonCompliant` marks a post that broke X's rules.
        - `text` object
          - `text` string: The notice's text.
          - `rtl` boolean: Whether X writes it right to left.
          - `entities` object[]: Links inside the notice, by character range.
            - `fromIndex` integer: Whole number from 0.
            - `toIndex` integer: Whole number from 0.
            - `ref` object
              - …
      - `unmentionedUserIds` string[]: User IDs that left this conversation.
      - `viewState` string
      - `entities` TweetEntities: Lists hashtags, symbols, links, and mentions from tweet text.
        - `hashtags` TweetHashtag[]
          - `indices` WholeNumber[]
          - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader.
            - `id` string: X's ID for the SmartTag.
            - `info` object
              - …
          - `text` string, required
        - `smarttags` TweetSymbol[]
          - `indices` WholeNumber[]
          - `seconds` number
          - `text` string
          - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader.
            - `id` string: X's ID for the SmartTag.
            - `info` object
              - …
        - `symbols` TweetSymbol[]
          - `indices` WholeNumber[]
          - `seconds` number
          - `text` string
          - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader.
            - `id` string: X's ID for the SmartTag.
            - `info` object
              - …
        - `timestamps` TweetSymbol[]
          - `indices` WholeNumber[]
          - `seconds` number
          - `text` string
          - `tag` TweetSmartTag: X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading platforms, which differ by reader.
            - `id` string: X's ID for the SmartTag.
            - `info` object
              - …
        - `urls` TweetUrlEntity[]
          - `display_url` string
          - `expanded_url` string
          - `indices` WholeNumber[]
          - `url` string
        - `user_mentions` TweetUserMention[]
          - `id_str` string
          - `indices` WholeNumber[]
          - `name` string
          - `screen_name` string, required
      - `scopes` PublicMetadata: Public metadata whose fields X defines.
      - `media` TweetMedia[]: Media, omitted when unavailable.
        - `mediaUrl` string, required: Preview URL.
        - `type` 'photo' | 'video' | 'animated_gif', required
        - `url` string, required: Tweet media link.
        - `adultContent` boolean: Adult-content warning.
        - `allowDownload` boolean: Direct download permission.
        - `altText` string: Accessibility text.
        - `aspectRatio` WholeNumber[]: Video width and height ratio.
        - `availabilityReason` string: Why X made the media unavailable, such as `Dmcaed` after a copyright report. Omitted on available media.
        - `availabilityStatus` string: Availability state, such as `Available` or `Unavailable`.
        - `description` string: Media description.
        - `displayUrl` string: Display URL.
        - `durationMillis` integer: Video duration in milliseconds.
        - `expandedUrl` string: Expanded media URL.
        - `embeddable` boolean: Embeddable status.
        - `faceRects` object: Face crop rectangles by size.
        - `focusRects` object[]: Suggested image crops.
          - `x` integer, required: Whole number from 0.
          - `y` integer, required: Whole number from 0.
          - `w` integer, required: Whole number from 0.
          - `h` integer, required: Whole number from 0.
        - `grokImageAnnotation` object: Prompt a Grok image came from. Absent on other media & when X sends no prompt.
          - `prompt` string: Prompt the image came from.
          - `upsampledPrompt` string: Grok's longer rewrite of the prompt.
        - `grokPostId` string: Grok post ID associated with the media.
        - `graphicViolence` boolean: Graphic-violence warning.
        - `height` integer: Original height.
        - `id` string: Media entity ID.
        - `indices` WholeNumber[]: Tweet text offsets.
        - `mediaKey` string: Stable X media key.
        - `monetizable` boolean: Monetization status.
        - `otherSensitiveContent` boolean
        - `sizes` object: Named media renditions and resize modes.
        - `sourceStatusId` string: Source tweet ID for copied media.
        - `sourceUser` UserProfile: Public X profile.
          - `id` string, required
          - `username` string, required
          - `name` string, required
          - `description` string
          - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media.
          - `following` integer
          - `verified` boolean
          - `isBlueVerified` boolean: Whether X shows a blue verification badge
          - `isVerified` boolean: Whether X marks the profile as verified
          - `profilePicture` string: Profile picture at 48 px, as X sends it.
          - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image.
          - `coverPicture` string
          - `profileBannerUrl` string: Original X profile banner field when available
          - `location` string: Account owner's public profile location text
          - `accountBasedIn` AccountBasedIn: X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location.
            - `value` string, required
            - `level` 'country' | 'region', required
            - `observedAt` string, date-time, required
          - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later.
          - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate.
          - `connectedVia` string: How the account first connected to X.
          - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate.
          - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page.
          - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none.
          - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none.
            - `emails` object[]: Emails in the bio, name or location, lowercased.
              - …
            - `phones` object[]: Phone numbers on the profile. Only a spelling that can be nothing else counts.
              - …
            - `links` object[]: The profile's website & the links in its bio.
              - …
          - `usernameChanges` object: How often the account changed its username.
            - `count` integer, required: Whole number from 0.
            - `lastChangedAt` string, date-time: Time of the latest change, omitted when there is none.
          - `birthdate` object: The parts of the birthday the account made public.
            - `day` integer
            - `month` integer
            - `year` integer
          - `retweetedAt` string, date-time, nullable: UTC repost time with includeRetweetTimestamp. Null if the newest profile page has no match or lookup failed. Otherwise omitted.
          - `createdAt` string: Account creation time.
          - `statusesCount` integer
          - `mediaCount` integer
          - `protected` boolean: Whether the profile protects its posts
          - `url` string
          - `favouritesCount` integer
          - `hasCustomTimelines` boolean
          - `isTranslator` boolean
          - `withheldInCountries` string[]
          - `withheldScope` string: Whether X withholds a post or user
          - `possiblySensitive` boolean
          - `professional` PublicMetadata: Public metadata whose fields X defines.
          - `grokTranslatedBio` PublicMetadata: Public metadata whose fields X defines.
          - `pinnedTweetIds` string[]
          - `isAutomated` boolean
          - `automatedBy` string
          - `unavailable` boolean
          - `unavailableReason` string
          - `verifiedType` string
          - `affiliatesHighlightedLabel` UserAffiliateLabel: Organization affiliation label shown on an X profile.
            - `badgeUrl` string
            - `description` string
            - `longDescription` PublicMetadata: Public metadata whose fields X defines.
            - `url` string
            - `urlType` string
            - `userLabelDisplayType` string
            - `userLabelType` string
          - `businessAccountAffiliatesCount` integer: Whole number from 0.
          - `creatorSubscriptionsCount` integer: Whole number from 0.
          - `hasGraduatedAccess` boolean
          - `hasHiddenSubscriptionsOnProfile` boolean
          - `highlightsInfo` UserHighlightsInfo: Profile highlight availability and count metadata.
            - `canHighlightTweets` boolean
            - `highlightedTweets` string
          - `identityVerification` UserIdentityVerification: Identity verification X shows on the profile & its About page.
            - `description` string
            - `isIdentityVerified` boolean: Whether the owner verified their ID with X.
            - `overrideVerifiedYear` integer: The year X shows as the start of verification, in place of verifiedSinceMsec.
            - `verifiedSinceMsec` string: When X verified the account, in milliseconds since 1970, as text.
          - `isProfileTranslatable` boolean
          - `parodyCommentaryFanLabel` string
          - `profileDescriptionLanguage` string
          - `profileImageShape` string
          - `profileInterstitialType` string
          - `profileSortEnabled` boolean
          - `profileTranslatorType` string
          - `redirectsToUsername` string: Handle x.com sends this profile's visitors to, such as the new handle of a renamed account whose old handle now holds a placeholder. Missing when x.com shows the profile itself.
          - `superFollowEligible` boolean
          - `superFollowsUserProfileActive` boolean: Whether X marks the subscription profile as active.
          - `tipJar` UserTipJar: Public payment and creator-support handles shown on X.
            - `bandcampHandle` string
            - `bitcoinHandle` string
            - `cashAppHandle` string
            - `ethereumHandle` string
            - `gofundmeHandle` string
            - `isEnabled` boolean
            - `patreonHandle` string
            - `payPalHandle` string
            - `venmoHandle` string
          - `listedCount` integer: Public lists that include the profile.
          - `fastFollowersCount` integer: Followers X counts as fast followers.
          - `normalFollowersCount` integer: Followers minus fast followers.
          - `defaultProfile` boolean: Whether the profile keeps X's default theme.
          - `defaultProfileImage` boolean: Whether the profile keeps X's default avatar.
          - `hasExtendedProfile` boolean: Whether the profile filled X's extended fields, such as a birth date. True or false.
          - `isTranslationEnabled` boolean: Whether the account turned on X's translation of its posts. True or false.
          - `geoEnabled` boolean: Whether the profile may add a location to posts.
          - `advertiserAccountType` string: The account's X Ads type. `none` for an account without ads, or `promotable_user` for one that may run them.
          - `advertiserAccountServiceLevels` string[]: X Ads services the account uses, such as `analytics`, `media_studio` or `smb`. Empty for an account without ads.
          - `businessProfileState` string: Whether X treats the profile as a business profile. `none` or `enabled`.
          - `subscribersCount` integer: Accounts subscribed to the profile's paid Subscriptions. 0 when it has none.
          - `verificationReason` object: X's text on why the profile is verified, with its links.
            - `text` string
            - `entities` object[]: Links inside the text, by character range.
              - …
          - `communityRole` string: Community role when returned by community member reads
          - `profile_bio` PublicMetadata: Public metadata whose fields X defines.
        - `sourceUserId` string: Source profile ID for copied media.
        - `tags` object[]: Public profiles tagged in the media.
          - `name` string
          - `screen_name` string
          - `type` string
          - `user_id` string
        - `title` string: Media title.
        - `videoVariants` object[]: Video encodings in source order.
          - `bitrate` integer: Whole number from 0.
          - `contentType` string, required
          - `url` string, required
        - `watchNowUrl` string: Public media action URL.
        - `visitSiteUrl` string: Public destination URL.
        - `width` integer: Original width.
      - `retweetCount` integer, required
      - `replyCount` integer, required
      - `likeCount` integer, required
      - `quoteCount` integer, required
      - `viewCount` integer, required
      - `bookmarkCount` integer, required
      - `unknownCounts` string[]: The counts X did not send for this post. Each one reads 0, so treat it as unknown rather than none. Names follow the response's key style, so `xquik-api-contract: 2026-04-29` lists bookmark_count. Posts from before X counted views, & new posts X has not counted views for yet, list viewCount. Left out when X sent every count.
      - `parentTweet` EmbeddedTweet: Public tweet fields, excluding nested tweets. `text` reads as x.com shows it, with `&`, `<` & `>` decoded. `displayTextRange` & entity `indices` count that text.
        - `id` string, required
        - `text` string, required
        - `type` string
        - `createdAt` string
        - `url` string
        - `lang` string
        - `isReply` boolean
        - `isLimitedReply` boolean
        - `isNoteTweet` boolean
        - `isPinned` boolean
        - `isQuoteStatus` boolean
        - `isRetweet` boolean
        - `quotedTweetId` string
        - `quotedTweetPermalink` object: The quoted post's link, kept when X withholds that post.
          - `displayUrl` string
          - `expandedUrl` string
          - `url` string
        - `quotedTweetUnavailable` object: Why X shows no quoted post. Omitted when X names no reason.
          - `reason` string, required: X's reason, such as `Suspended` for a suspended author or `Protected` for an author who protects their posts.
        - `retweetedAt` string, date-time, nullable: Repost event time in UTC. Null when unavailable. Omitted for other posts.
        - `inReplyToId` string
        - `inReplyToUserId` string
        - `inReplyToUsername` string
        - `conversationId` string
        - `conversationControl` object: Reply policy & conversation owner.
          - `allowedCountryCodes` string[]: Regions whose accounts may reply, as country codes. Sent with the `country_of_origin` mode.
          - `inviteViaMention` boolean
          - `mode` string: Reply policy from X's newer field, such as `my_network`, `premium` or `country_of_origin`. Omitted when X sends none.
          - `ownerId` string: The conversation owner's account ID.
          - `ownerUsername` string
          - `policy` string
        - `limitedActions` object[]: Public restrictions & prompts.
          - `action` string
          - `prompt` object
            - `ctaType` string
            - `headline` string
            - `metadata` PublicMetadata: Public metadata whose fields X defines.
            - `subtext` string
        - `source` string: The app the post was sent from, as X labels it. X sends it for some posts only.
        - `displayTextRange` WholeNumber[]
        - `textHighlights` object[]: Where `text` matches the search, on each row a search read. Offsets count code points of `text`, as `displayTextRange` does. Empty when X marks nothing in the post. X marks matches only in a post's first 280 characters.
          - `startIndex` integer, required: The first code point of the match.
          - `endIndex` integer, required: The first code point after the match.
        - `contentDisclosure` ContentDisclosure: Content disclosure metadata X shows on a labeled tweet. X labels paid partnership content and AI-generated media.
          - `advertising` object
            - `isPaidPromotion` boolean: True when X labels the tweet as paid promotion content.
          - `aiGenerated` object
            - `detectionSource` string: How X detected AI media. X omits it for self-declared posts.
            - `hasAiGeneratedMedia` boolean: True when X labels the tweet as containing AI-generated media.
        - `article` TweetArticleMetadata: An X Article preview and its lifecycle metadata.
          - `coverMedia` PublicMetadata: Public metadata whose fields X defines.
          - `id` string
          - `lifecycleState` PublicMetadata: Public metadata whose fields X defines.
          - `metadata` PublicMetadata: Public metadata whose fields X defines.
          - `title` string
          - `previewText` string
          - `coverMediaUrl` string
        - `authorUnavailable` TweetAuthorUnavailable: Why the tweet has no author. X serves a suspended or deleted account as an unavailable user with a reason such as Suspended or NotFound. Omitted when the author is available.
          - `reason` string, required: X's reason code.
          - `message` string: X's notice text for the reason.
        - `unavailableAuthorId` string: The author's ID when X withholds the author's profile.
        - `card` TweetCard: A public card and the profiles it references.
          - `id` string
          - `name` string
          - `url` string
          - `bindingValues` PublicMetadata: Public metadata whose fields X defines.
          - `platform` PublicMetadata: Public metadata whose fields X defines.
          - `userReferenceErrors` object[]: Unresolved card user references.
            - `message` string
            - `reason` string
          - `userReferences` UserProfile[]
            - `id` string, required
            - `username` string, required
            - `name` string, required
            - `description` string
            - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media.
            - `following` integer
            - `verified` boolean
            - `isBlueVerified` boolean: Whether X shows a blue verification badge
            - `isVerified` boolean: Whether X marks the profile as verified
            - `profilePicture` string: Profile picture at 48 px, as X sends it.
            - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image.
            - `coverPicture` string
            - `profileBannerUrl` string: Original X profile banner field when available
            - `location` string: Account owner's public profile location text
            - `accountBasedIn` AccountBasedIn: X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location.
              - …
            - `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.
        - `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` 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.
        - `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.
        - `author` UserProfile: Public X profile.
          - `id` string, required
          - `username` string, required
          - `name` string, required
          - `description` string
          - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media.
          - `following` integer
          - `verified` boolean
          - `isBlueVerified` boolean: Whether X shows a blue verification badge
          - `isVerified` boolean: Whether X marks the profile as verified
          - `profilePicture` string: Profile picture at 48 px, as X sends it.
          - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image.
          - `coverPicture` string
          - `profileBannerUrl` string: Original X profile banner field when available
          - `location` string: Account owner's public profile location text
          - `accountBasedIn` AccountBasedIn: X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location.
            - `value` string, required
            - `level` 'country' | 'region', required
            - `observedAt` string, date-time, required
          - `accountBasedInUnavailable` boolean: True when X withheld accountBasedIn from this read. Retry later.
          - `accountBasedInAccurate` boolean: False when X notes accountBasedIn may be inaccurate.
          - `connectedVia` string: How the account first connected to X.
          - `connectedViaAccurate` boolean: False when X notes that country may be inaccurate.
          - `affiliateUsername` string: Handle of the organization X shows the account is affiliated with, from its About page.
          - `email` string: First email the account publishes on its profile, lowercased. Omitted when it publishes none.
          - `contactInfo` ProfileContactInfo: Emails, phone numbers & links the account publishes on its own profile. Omitted when it publishes none.
            - `emails` object[]: Emails in the bio, name or location, lowercased.
              - …
            - `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.
        - `parentTweet` object: The post this one replies to, with the same fields.
        - `quoted_tweet` object: The post this one quotes, with the same fields.
        - `retweeted_tweet` object: The post this one reposts, with the same fields.
      - `quoted_tweet` EmbeddedTweet: Public tweet fields, excluding nested tweets. `text` reads as x.com shows it, with `&`, `<` & `>` decoded. `displayTextRange` & entity `indices` count that text.
        - `id` string, required
        - `text` string, required
        - `type` string
        - `createdAt` string
        - `url` string
        - `lang` string
        - `isReply` boolean
        - `isLimitedReply` boolean
        - `isNoteTweet` boolean
        - `isPinned` boolean
        - `isQuoteStatus` boolean
        - `isRetweet` boolean
        - `quotedTweetId` string
        - `quotedTweetPermalink` object: The quoted post's link, kept when X withholds that post.
          - `displayUrl` string
          - `expandedUrl` string
          - `url` string
        - `quotedTweetUnavailable` object: Why X shows no quoted post. Omitted when X names no reason.
          - `reason` string, required: X's reason, such as `Suspended` for a suspended author or `Protected` for an author who protects their posts.
        - `retweetedAt` string, date-time, nullable: Repost event time in UTC. Null when unavailable. Omitted for other posts.
        - `inReplyToId` string
        - `inReplyToUserId` string
        - `inReplyToUsername` string
        - `conversationId` string
        - `conversationControl` object: Reply policy & conversation owner.
          - `allowedCountryCodes` string[]: Regions whose accounts may reply, as country codes. Sent with the `country_of_origin` mode.
          - `inviteViaMention` boolean
          - `mode` string: Reply policy from X's newer field, such as `my_network`, `premium` or `country_of_origin`. Omitted when X sends none.
          - `ownerId` string: The conversation owner's account ID.
          - `ownerUsername` string
          - `policy` string
        - `limitedActions` object[]: Public restrictions & prompts.
          - `action` string
          - `prompt` object
            - `ctaType` string
            - `headline` string
            - `metadata` PublicMetadata: Public metadata whose fields X defines.
            - `subtext` string
        - `source` string: The app the post was sent from, as X labels it. X sends it for some posts only.
        - `displayTextRange` WholeNumber[]
        - `textHighlights` object[]: Where `text` matches the search, on each row a search read. Offsets count code points of `text`, as `displayTextRange` does. Empty when X marks nothing in the post. X marks matches only in a post's first 280 characters.
          - `startIndex` integer, required: The first code point of the match.
          - `endIndex` integer, required: The first code point after the match.
        - `contentDisclosure` ContentDisclosure: Content disclosure metadata X shows on a labeled tweet. X labels paid partnership content and AI-generated media.
          - `advertising` object
            - `isPaidPromotion` boolean: True when X labels the tweet as paid promotion content.
          - `aiGenerated` object
            - `detectionSource` string: How X detected AI media. X omits it for self-declared posts.
            - `hasAiGeneratedMedia` boolean: True when X labels the tweet as containing AI-generated media.
        - `article` TweetArticleMetadata: An X Article preview and its lifecycle metadata.
          - `coverMedia` PublicMetadata: Public metadata whose fields X defines.
          - `id` string
          - `lifecycleState` PublicMetadata: Public metadata whose fields X defines.
          - `metadata` PublicMetadata: Public metadata whose fields X defines.
          - `title` string
          - `previewText` string
          - `coverMediaUrl` string
        - `authorUnavailable` TweetAuthorUnavailable: Why the tweet has no author. X serves a suspended or deleted account as an unavailable user with a reason such as Suspended or NotFound. Omitted when the author is available.
          - `reason` string, required: X's reason code.
          - `message` string: X's notice text for the reason.
        - `unavailableAuthorId` string: The author's ID when X withholds the author's profile.
        - `card` TweetCard: A public card and the profiles it references.
          - `id` string
          - `name` string
          - `url` string
          - `bindingValues` PublicMetadata: Public metadata whose fields X defines.
          - `platform` PublicMetadata: Public metadata whose fields X defines.
          - `userReferenceErrors` object[]: Unresolved card user references.
            - `message` string
            - `reason` string
          - `userReferences` UserProfile[]
            - `id` string, required
            - `username` string, required
            - `name` string, required
            - `description` string
            - `followers` integer: Omitted when X sends no count, as for the account that first posted reused media.
            - `following` integer
            - `verified` boolean
            - `isBlueVerified` boolean: Whether X shows a blue verification badge
            - `isVerified` boolean: Whether X marks the profile as verified
            - `profilePicture` string: Profile picture at 48 px, as X sends it.
            - `profilePictureOriginal` string: The same profile picture at full size, as the account uploaded it. Download this one for the image.
            - `coverPicture` string
            - `profileBannerUrl` string: Original X profile banner field when available
            - `location` string: Account owner's public profile location text
            - `accountBasedIn` AccountBasedIn: X's best-effort public label inferred from aggregated account-access IP addresses. It does not state nationality, residence, identity, registration, post location, or exact location.
              - …
            - `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.
        - `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` 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.
        - `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.
- … truncated; see the full OpenAPI document linked below

## Other responses

- `400`: Text that is no alias returns invalid_contributor_alias. A cursor X never issued returns invalid_cursor. Start again without it. Both are free.
- `401`: Non-MPP paid reads require Bearer authentication. Without credentials, the answer offers a guest checkout but does not create it. Invalid credentials return a plain error. Confirm before using any offered action.
- `402`: Payment required. MPP reads include `WWW-Authenticate`. Authenticated reads include balances, plus checkout when the key can open it. A key that reads only gets the account page instead. A failed request never creates checkout. A caller on a plan gets top-up only, plus `credits_renew_at` when the plan renews. Guest keys offer top-up.
- `404`: No contributor holds the alias. Free.
- `424`: Dependency unavailable, unauthorized, or limited. Default v1 uses 502. Best-practice responses use 424 for transparent dependency failures. Search answers 424 `search_unavailable` when X fails the query itself, or when its filters matched none of the last 3,000 posts read. The message says how far back the search read.
- `429`: Too many requests right now. Each user gets 500 reads a second. Each minute allows 120 writes & 60 deletes. `x_api_rate_limited` means X limits this read for now. Neither answer costs anything. Wait for the seconds in `Retry-After`, then retry.
- `500`: Unexpected error.
- `502`: Dependency unavailable, unauthorized, or limited. Default v1 uses 502. Best-practice responses use 424 for transparent dependency failures. Search answers 424 `search_unavailable` when X fails the query itself, or when its filters matched none of the last 3,000 posts read. The message says how far back the search read.
- `503`: Retry x_api_unavailable after Retry-After. With X-Xquik-Busy, retry until your deadline.
- `default`: Unexpected error.

## Changes

- **2026-10-20** `45942c75fdc2`: 20 warning
  - added the new `topup_in_progress` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `429`
  - added the new `topup_in_progress` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #2: StructuredError]/code` response property for the response status `429`
  - added the new `topup_in_progress` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `400`
  - added the new `topup_in_progress` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `404`
  - …16 more

[Operation history](https://skmtc.dev/xquik-dev/apis/xquik-api/changes/api/v1/x/community-notes/contributors/:alias/deleted-notes/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)