--- title: "Search tweets with minLikes, normalized likeCount, media & cursors" method: GET path: "/api/v1/x/tweets/search" tags: ["Tweets"] --- # Search tweets with minLikes, normalized likeCount, media & cursors `GET /api/v1/x/tweets/search` Tweets include authors, like counts, media, URLs & cursors. Omit mode for maximum coverage. Reuse next_cursor with unchanged filters. ## Query parameters - `q` string, required - `queryType` 'Latest' | 'Top' - `mode` 'standard' | 'coverage' - `cursor` string - `sinceTime` string - `untilTime` string - `limit` integer - `fromUser` string - `toUser` string - `mentioning` string - `language` string - `sinceDate` string, date - `untilDate` string, date - `mediaType` 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none' - `minLikes` integer - `minRetweets` integer - `minReplies` integer - `minQuotes` integer - `minViews` integer - `minBookmarks` integer - `maxFaves` integer - `maxRetweets` integer - `maxReplies` integer - `maxQuotes` integer - `blueVerifiedOnly` boolean - `cardName` string - `source` string - `excludeSource` string - `geocode` string - `sinceId` string - `maxId` string - `near` string - `within` string - `withinTime` string - `nativeRetweets` boolean - `safe` boolean - `news` boolean - `verifiedOnly` boolean - `replies` 'include' | 'exclude' | 'only' - `retweets` 'include' | 'exclude' | 'only' - `quotes` 'include' | 'exclude' | 'only' - `exactPhrase` string - `excludeWords` string - `anyWords` string - `hashtags` string - `cashtags` string - `url` string - `conversationId` string - `inReplyToTweetId` string - `quotesOfTweetId` string - `retweetsOfTweetId` string - `listId` string - `place` string - `placeCountry` string - `pointRadius` string - `boundingBox` string - `advancedQuery` string ## Response `200` Search results - union - PaginatedTweets — Automatic search, user Tweet, and reply coverage preserves shape, filters, aliases, and billing. Follow next_cursor while the response reports more pages. An empty filtered page can still require continuation. Unprefixed cursors are legacy. - `filtered_count` integer - `tweets` SearchTweet[], required - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `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. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public restrictions & prompts. - `action` string - `prompt` object - `ctaType` string - `headline` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `subtext` string - `source` string - `displayTextRange` integer[] - `contentDisclosure` ContentDisclosure — Content disclosure metadata shown by X when a tweet is labeled as paid partnership content or AI-generated media. - `advertising` object - `isPaidPromotion` boolean — True when X labels the tweet as paid promotion content. - `aiGenerated` object - `detectionSource` string — Source of the AI-generated media disclosure. - `hasAiGeneratedMedia` boolean — True when X labels the tweet as containing AI-generated media. - `article` TweetArticleMetadata — Describes an X Article preview and its lifecycle metadata. - `coverMedia` PublicMetadata — Public metadata whose fields are defined by X. - `id` string - `lifecycleState` PublicMetadata — Public metadata whose fields are defined by X. - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `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. - `card` TweetCard — Describes a public card and its referenced profiles. - `id` string - `name` string - `url` string - `bindingValues` PublicMetadata — Public metadata whose fields are defined by X. - `platform` PublicMetadata — Public metadata whose fields are defined by X. - `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 - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — 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 - `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 are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `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 are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `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 - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `communityId` string — Community ID. - `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 are defined by X. - `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 are defined by X. - `jetfuelAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - `id` string - `text` string, required - `isExpandable` boolean - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - … - `symbols` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - … - `timestamps` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` integer[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` integer[] - `name` string - `screen_name` string, required - `inlineMedia` object[] — Inline media positions in the Note Tweet text. - `index` integer, required - `mediaId` string, required - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Describes public place metadata on a geotagged tweet. - `boundingBox` PublicMetadata — Public metadata whose fields are defined by X. - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `postCta` PublicMetadata — Public metadata whose fields are defined by X. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer - `likeCount` integer - `quoteCount` integer - `replyCount` integer - `retweetCount` integer - `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 - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — 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 - `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 are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `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 are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `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 - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `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. - `tombstone` TweetTombstone — Public visibility notice attached to an available tweet. - `type` string — Visibility notice type. - `text` object - `text` string — Human-readable notice text. - `rtl` boolean — Right-to-left text direction. - `entities` object[] - `fromIndex` integer - `toIndex` integer - `ref` object - … - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - … - `symbols` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - … - `timestamps` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - `info` object - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` integer[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` integer[] - `name` string - `screen_name` string, required - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `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` integer[] — Video width and height ratio. - `availabilityReason` string — Availability reason. - `availabilityStatus` string — Availability state. - `description` string — Media description. - `displayUrl` string — Display URL. - `durationMillis` integer — Video duration in milliseconds. - `expandedUrl` string — Expanded media URL. - `embeddable` boolean — Embeddable status. - `faceRects` object — Face crop rectangles by size. - `focusRects` object[] — Suggested image crops. - `x` integer, required - `y` integer, required - `w` integer, required - `h` integer, required - `grokPostId` string — Grok post ID associated with the media. - `graphicViolence` boolean — Graphic-violence warning. - `height` integer — Original height. - `id` string — Media entity ID. - `indices` integer[] — 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. - `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 - `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 - `quoted_tweet` EmbeddedTweet — Public tweet fields, excluding nested tweets. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `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. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public restrictions & prompts. - `action` string - `prompt` object - `ctaType` string - `headline` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `subtext` string - `source` string - `displayTextRange` integer[] - `contentDisclosure` ContentDisclosure — Content disclosure metadata shown by X when a tweet is labeled as paid partnership content or AI-generated media. - `advertising` object - `isPaidPromotion` boolean — True when X labels the tweet as paid promotion content. - `aiGenerated` object - `detectionSource` string — Source of the AI-generated media disclosure. - `hasAiGeneratedMedia` boolean — True when X labels the tweet as containing AI-generated media. - `article` TweetArticleMetadata — Describes an X Article preview and its lifecycle metadata. - `coverMedia` PublicMetadata — Public metadata whose fields are defined by X. - `id` string - `lifecycleState` PublicMetadata — Public metadata whose fields are defined by X. - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `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. - `card` TweetCard — Describes a public card and its referenced profiles. - `id` string - `name` string - `url` string - `bindingValues` PublicMetadata — Public metadata whose fields are defined by X. - `platform` PublicMetadata — Public metadata whose fields are defined by X. - `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 - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — 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. - … - `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 are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - … - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - … - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - … - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - … - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `communityId` string — Community ID. - `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 are defined by X. - `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 are defined by X. - `jetfuelAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - `id` string - `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 - `mediaId` string, required - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Describes public place metadata on a geotagged tweet. - `boundingBox` PublicMetadata — Public metadata whose fields are defined by X. - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `postCta` PublicMetadata — Public metadata whose fields are defined by X. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer - `likeCount` integer - `quoteCount` integer - `replyCount` integer - `retweetCount` integer - `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 - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — 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. - … - `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 are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - … - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - … - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - … - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - … - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `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. - `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[] - … - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - … - `symbols` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - … - `timestamps` TweetSymbol[] - `indices` integer[] - `seconds` number - `text` string - `tag` object - … - `urls` TweetUrlEntity[] - `display_url` string - `expanded_url` string - `indices` integer[] - `url` string - `user_mentions` TweetUserMention[] - `id_str` string - `indices` integer[] - `name` string - `screen_name` string, required - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `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` integer[] — Video width and height ratio. - `availabilityReason` string — Availability reason. - `availabilityStatus` string — Availability state. - `description` string — Media description. - `displayUrl` string — Display URL. - `durationMillis` integer — Video duration in milliseconds. - `expandedUrl` string — Expanded media URL. - `embeddable` boolean — Embeddable status. - `faceRects` object — Face crop rectangles by size. - `focusRects` object[] — Suggested image crops. - `x` integer, required - `y` integer, required - `w` integer, required - `h` integer, required - `grokPostId` string — Grok post ID associated with the media. - `graphicViolence` boolean — Graphic-violence warning. - `height` integer — Original height. - `id` string — Media entity ID. - `indices` integer[] — 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. - `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 - `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 - `author` UserProfile — Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — 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 - `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 are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `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 are defined by X. - `url` string - `urlType` string - `userLabelDisplayType` string - `userLabelType` string - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - `canHighlightTweets` boolean - `highlightedTweets` string - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - `description` string - `isIdentityVerified` boolean - `verifiedSinceMsec` string - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `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 - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `quoted_tweet` EmbeddedTweetLevel2 — Public tweet fields, excluding nested tweets. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `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. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public restrictions & prompts. - `action` string - `prompt` object - … - `source` string - `displayTextRange` integer[] - `contentDisclosure` ContentDisclosure — Content disclosure metadata shown by X when a tweet is labeled as paid partnership content or AI-generated media. - `advertising` object - … - `aiGenerated` object - … - `article` TweetArticleMetadata — Describes an X Article preview and its lifecycle metadata. - `coverMedia` PublicMetadata — Public metadata whose fields are defined by X. - `id` string - `lifecycleState` PublicMetadata — Public metadata whose fields are defined by X. - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `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. - `card` TweetCard — Describes a public card and its referenced profiles. - `id` string - `name` string - `url` string - `bindingValues` PublicMetadata — Public metadata whose fields are defined by X. - `platform` PublicMetadata — Public metadata whose fields are defined by X. - `userReferenceErrors` object[] — Unresolved card user references. - … - `userReferences` UserProfile[] - … - `communityId` string — Community ID. - `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 are defined by X. - `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 are defined by X. - `jetfuelAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - `id` string - `text` string, required - `isExpandable` boolean - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - … - `inlineMedia` object[] — Inline media positions in the Note Tweet text. - … - `richtextTags` object[] - … - `place` TweetPlace — Describes public place metadata on a geotagged tweet. - `boundingBox` PublicMetadata — Public metadata whose fields are defined by X. - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `postCta` PublicMetadata — Public metadata whose fields are defined by X. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer - `likeCount` integer - `quoteCount` integer - `replyCount` integer - `retweetCount` integer - `reactionContext` object — Public post & user this reaction references. - `reactedToPostId` string — Referenced post ID. - `reactedToUser` UserProfile — Public X profile. - … - `sportsContext` object — Game metadata attached to this post. - `gameId` string — Game ID. - `league` string — League ID. - `title` string — Game title. - `url` string — Game link. - `state` string — Reported game state. - `statusText` string — Game progress text. - `scheduledAtMs` union — Scheduled Unix milliseconds, retaining the source type. - … - `competitors` object[] — Teams & reported scores. - … - `tombstone` TweetTombstone — Public visibility notice attached to an available tweet. - `type` string — Visibility notice type. - `text` object - … - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - … - `smarttags` TweetSymbol[] - … - `symbols` TweetSymbol[] - … - `timestamps` TweetSymbol[] - … - `urls` TweetUrlEntity[] - … - `user_mentions` TweetUserMention[] - … - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `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` integer[] — Video width and height ratio. - `availabilityReason` string — Availability reason. - `availabilityStatus` string — Availability state. - `description` string — Media description. - `displayUrl` string — Display URL. - `durationMillis` integer — Video duration in milliseconds. - `expandedUrl` string — Expanded media URL. - `embeddable` boolean — Embeddable status. - `faceRects` object — Face crop rectangles by size. - `focusRects` object[] — Suggested image crops. - … - `grokPostId` string — Grok post ID associated with the media. - `graphicViolence` boolean — Graphic-violence warning. - `height` integer — Original height. - `id` string — Media entity ID. - `indices` integer[] — 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. - `sourceUserId` string — Source profile ID for copied media. - `tags` object[] — Public profiles tagged in the media. - … - `title` string — Media title. - `videoVariants` object[] — Video encodings in source order. - … - `watchNowUrl` string — Public media action URL. - `visitSiteUrl` string — Public destination URL. - `width` integer — Original width. - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — 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. - … - `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 are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - … - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - … - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - … - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - … - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `quoted_tweet` EmbeddedTweetLevel3 — Public tweet fields, excluding nested tweets. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `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. - … - `limitedActions` object[] — Public restrictions & prompts. - … - `source` string - `displayTextRange` integer[] - `contentDisclosure` ContentDisclosure — Content disclosure metadata shown by X when a tweet is labeled as paid partnership content or AI-generated media. - … - `article` TweetArticleMetadata — Describes an X Article preview and its lifecycle metadata. - … - `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. - … - `card` TweetCard — Describes a public card and its referenced profiles. - … - `communityId` string — Community ID. - `communityNote` TweetCommunityNote — Community Note presentation metadata returned by X. - … - `edit` TweetEdit — Lists edit-chain identifiers and the remaining edit window. - … - `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. - … - `isTranslatable` boolean - `grokShareAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `jetfuelAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - … - `place` TweetPlace — Describes public place metadata on a geotagged tweet. - … - `postCta` PublicMetadata — Public metadata whose fields are defined by X. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - … - `reactionContext` object — Public post & user this reaction references. - … - `sportsContext` object — Game metadata attached to this post. - … - `tombstone` TweetTombstone — Public visibility notice attached to an available tweet. - … - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - … - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `media` TweetMedia[] — Media, omitted when unavailable. - … - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — Public X profile. - … - `quoted_tweet` EmbeddedTweetLevel4 — Public tweet fields, excluding nested tweets. - … - `retweeted_tweet` EmbeddedTweetLevel4 — Public tweet fields, excluding nested tweets. - … - `retweeted_tweet` EmbeddedTweetLevel3 — Public tweet fields, excluding nested tweets. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `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. - … - `limitedActions` object[] — Public restrictions & prompts. - … - `source` string - `displayTextRange` integer[] - `contentDisclosure` ContentDisclosure — Content disclosure metadata shown by X when a tweet is labeled as paid partnership content or AI-generated media. - … - `article` TweetArticleMetadata — Describes an X Article preview and its lifecycle metadata. - … - `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. - … - `card` TweetCard — Describes a public card and its referenced profiles. - … - `communityId` string — Community ID. - `communityNote` TweetCommunityNote — Community Note presentation metadata returned by X. - … - `edit` TweetEdit — Lists edit-chain identifiers and the remaining edit window. - … - `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. - … - `isTranslatable` boolean - `grokShareAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `jetfuelAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - … - `place` TweetPlace — Describes public place metadata on a geotagged tweet. - … - `postCta` PublicMetadata — Public metadata whose fields are defined by X. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - … - `reactionContext` object — Public post & user this reaction references. - … - `sportsContext` object — Game metadata attached to this post. - … - `tombstone` TweetTombstone — Public visibility notice attached to an available tweet. - … - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - … - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `media` TweetMedia[] — Media, omitted when unavailable. - … - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — Public X profile. - … - `quoted_tweet` EmbeddedTweetLevel4 — Public tweet fields, excluding nested tweets. - … - `retweeted_tweet` EmbeddedTweetLevel4 — Public tweet fields, excluding nested tweets. - … - `retweeted_tweet` EmbeddedTweetLevel2 — Public tweet fields, excluding nested tweets. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `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. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public restrictions & prompts. - `action` string - `prompt` object - … - `source` string - `displayTextRange` integer[] - `contentDisclosure` ContentDisclosure — Content disclosure metadata shown by X when a tweet is labeled as paid partnership content or AI-generated media. - `advertising` object - … - `aiGenerated` object - … - `article` TweetArticleMetadata — Describes an X Article preview and its lifecycle metadata. - `coverMedia` PublicMetadata — Public metadata whose fields are defined by X. - `id` string - `lifecycleState` PublicMetadata — Public metadata whose fields are defined by X. - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `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. - `card` TweetCard — Describes a public card and its referenced profiles. - `id` string - `name` string - `url` string - `bindingValues` PublicMetadata — Public metadata whose fields are defined by X. - `platform` PublicMetadata — Public metadata whose fields are defined by X. - `userReferenceErrors` object[] — Unresolved card user references. - … - `userReferences` UserProfile[] - … - `communityId` string — Community ID. - `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 are defined by X. - `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 are defined by X. - `jetfuelAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - `id` string - `text` string, required - `isExpandable` boolean - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - … - `inlineMedia` object[] — Inline media positions in the Note Tweet text. - … - `richtextTags` object[] - … - `place` TweetPlace — Describes public place metadata on a geotagged tweet. - `boundingBox` PublicMetadata — Public metadata whose fields are defined by X. - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `postCta` PublicMetadata — Public metadata whose fields are defined by X. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer - `likeCount` integer - `quoteCount` integer - `replyCount` integer - `retweetCount` integer - `reactionContext` object — Public post & user this reaction references. - `reactedToPostId` string — Referenced post ID. - `reactedToUser` UserProfile — Public X profile. - … - `sportsContext` object — Game metadata attached to this post. - `gameId` string — Game ID. - `league` string — League ID. - `title` string — Game title. - `url` string — Game link. - `state` string — Reported game state. - `statusText` string — Game progress text. - `scheduledAtMs` union — Scheduled Unix milliseconds, retaining the source type. - … - `competitors` object[] — Teams & reported scores. - … - `tombstone` TweetTombstone — Public visibility notice attached to an available tweet. - `type` string — Visibility notice type. - `text` object - … - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - `hashtags` TweetHashtag[] - … - `smarttags` TweetSymbol[] - … - `symbols` TweetSymbol[] - … - `timestamps` TweetSymbol[] - … - `urls` TweetUrlEntity[] - … - `user_mentions` TweetUserMention[] - … - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `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` integer[] — Video width and height ratio. - `availabilityReason` string — Availability reason. - `availabilityStatus` string — Availability state. - `description` string — Media description. - `displayUrl` string — Display URL. - `durationMillis` integer — Video duration in milliseconds. - `expandedUrl` string — Expanded media URL. - `embeddable` boolean — Embeddable status. - `faceRects` object — Face crop rectangles by size. - `focusRects` object[] — Suggested image crops. - … - `grokPostId` string — Grok post ID associated with the media. - `graphicViolence` boolean — Graphic-violence warning. - `height` integer — Original height. - `id` string — Media entity ID. - `indices` integer[] — 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. - `sourceUserId` string — Source profile ID for copied media. - `tags` object[] — Public profiles tagged in the media. - … - `title` string — Media title. - `videoVariants` object[] — Video encodings in source order. - … - `watchNowUrl` string — Public media action URL. - `visitSiteUrl` string — Public destination URL. - `width` integer — Original width. - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — Public X profile. - `id` string, required - `username` string, required - `name` string, required - `description` string - `followers` integer - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — 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. - … - `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 are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - … - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - … - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - … - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - … - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `quoted_tweet` EmbeddedTweetLevel3 — Public tweet fields, excluding nested tweets. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `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. - … - `limitedActions` object[] — Public restrictions & prompts. - … - `source` string - `displayTextRange` integer[] - `contentDisclosure` ContentDisclosure — Content disclosure metadata shown by X when a tweet is labeled as paid partnership content or AI-generated media. - … - `article` TweetArticleMetadata — Describes an X Article preview and its lifecycle metadata. - … - `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. - … - `card` TweetCard — Describes a public card and its referenced profiles. - … - `communityId` string — Community ID. - `communityNote` TweetCommunityNote — Community Note presentation metadata returned by X. - … - `edit` TweetEdit — Lists edit-chain identifiers and the remaining edit window. - … - `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. - … - `isTranslatable` boolean - `grokShareAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `jetfuelAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - … - `place` TweetPlace — Describes public place metadata on a geotagged tweet. - … - `postCta` PublicMetadata — Public metadata whose fields are defined by X. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - … - `reactionContext` object — Public post & user this reaction references. - … - `sportsContext` object — Game metadata attached to this post. - … - `tombstone` TweetTombstone — Public visibility notice attached to an available tweet. - … - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - … - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `media` TweetMedia[] — Media, omitted when unavailable. - … - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — Public X profile. - … - `quoted_tweet` EmbeddedTweetLevel4 — Public tweet fields, excluding nested tweets. - … - `retweeted_tweet` EmbeddedTweetLevel4 — Public tweet fields, excluding nested tweets. - … - `retweeted_tweet` EmbeddedTweetLevel3 — Public tweet fields, excluding nested tweets. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `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. - … - `limitedActions` object[] — Public restrictions & prompts. - … - `source` string - `displayTextRange` integer[] - `contentDisclosure` ContentDisclosure — Content disclosure metadata shown by X when a tweet is labeled as paid partnership content or AI-generated media. - … - `article` TweetArticleMetadata — Describes an X Article preview and its lifecycle metadata. - … - `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. - … - `card` TweetCard — Describes a public card and its referenced profiles. - … - `communityId` string — Community ID. - `communityNote` TweetCommunityNote — Community Note presentation metadata returned by X. - … - `edit` TweetEdit — Lists edit-chain identifiers and the remaining edit window. - … - `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. - … - `isTranslatable` boolean - `grokShareAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `jetfuelAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - … - `place` TweetPlace — Describes public place metadata on a geotagged tweet. - … - `postCta` PublicMetadata — Public metadata whose fields are defined by X. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - … - `reactionContext` object — Public post & user this reaction references. - … - `sportsContext` object — Game metadata attached to this post. - … - `tombstone` TweetTombstone — Public visibility notice attached to an available tweet. - … - `unmentionedUserIds` string[] — User IDs that left this conversation. - `viewState` string - `entities` TweetEntities — Lists hashtags, symbols, links, and mentions from tweet text. - … - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `media` TweetMedia[] — Media, omitted when unavailable. - … - `retweetCount` integer, required - `replyCount` integer, required - `likeCount` integer, required - `quoteCount` integer, required - `viewCount` integer, required - `bookmarkCount` integer, required - `author` UserProfile — Public X profile. - … - `quoted_tweet` EmbeddedTweetLevel4 — Public tweet fields, excluding nested tweets. - … - `retweeted_tweet` EmbeddedTweetLevel4 — Public tweet fields, excluding nested tweets. - … - `retweeted_tweet` EmbeddedTweet — Public tweet fields, excluding nested tweets. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `isRetweet` boolean - `quotedTweetId` string - `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. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public restrictions & prompts. - `action` string - `prompt` object - `ctaType` string - `headline` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `subtext` string - `source` string - `displayTextRange` integer[] - `contentDisclosure` ContentDisclosure — Content disclosure metadata shown by X when a tweet is labeled as paid partnership content or AI-generated media. - `advertising` object - `isPaidPromotion` boolean — True when X labels the tweet as paid promotion content. - `aiGenerated` object - `detectionSource` string — Source of the AI-generated media disclosure. - `hasAiGeneratedMedia` boolean — True when X labels the tweet as containing AI-generated media. - `article` TweetArticleMetadata — Describes an X Article preview and its lifecycle metadata. - `coverMedia` PublicMetadata — Public metadata whose fields are defined by X. - `id` string - `lifecycleState` PublicMetadata — Public metadata whose fields are defined by X. - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `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. - `card` TweetCard — Describes a public card and its referenced profiles. - `id` string - `name` string - `url` string - `bindingValues` PublicMetadata — Public metadata whose fields are defined by X. - `platform` PublicMetadata — Public metadata whose fields are defined by X. - `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 - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — 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. - … - `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 are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - … - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - … - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - … - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - … - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `communityId` string — Community ID. - `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 are defined by X. - `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 are defined by X. - `jetfuelAttachment` PublicMetadata — Public metadata whose fields are defined by X. - `noteTweet` TweetNote — Complete Note Tweet content and rich-text metadata. - `id` string - `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 - `mediaId` string, required - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Describes public place metadata on a geotagged tweet. - `boundingBox` PublicMetadata — Public metadata whose fields are defined by X. - `country` string - `countryCode` string - `fullName` string - `id` string - `name` string - `placeType` string - `url` string - `postCta` PublicMetadata — Public metadata whose fields are defined by X. - `possiblySensitive` boolean - `previousCounts` TweetPreviousCounts — Engagement counts retained from a prior tweet edit. - `bookmarkCount` integer - `likeCount` integer - `quoteCount` integer - `replyCount` integer - `retweetCount` integer - `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 - `following` integer - `verified` boolean - `isBlueVerified` boolean — Whether X shows a blue verification badge - `isVerified` boolean — Whether X marks the profile as verified - `profilePicture` string - `coverPicture` string - `profileBannerUrl` string — Original X profile banner field when available - `location` string — 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. - … - `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 are defined by X. - `grokTranslatedBio` PublicMetadata — Public metadata whose fields are defined by X. - `pinnedTweetIds` string[] - `isAutomated` boolean - `automatedBy` string - `unavailable` boolean - `unavailableReason` string - `verifiedType` string - `affiliatesHighlightedLabel` UserAffiliateLabel — Organization affiliation label shown on an X profile. - … - `businessAccountAffiliatesCount` integer - `creatorSubscriptionsCount` integer - `hasGraduatedAccess` boolean - `hasHiddenSubscriptionsOnProfile` boolean - `highlightsInfo` UserHighlightsInfo — Profile highlight availability and count metadata. - … - `identityVerification` UserIdentityVerification — Identity verification metadata displayed by X. - … - `isProfileTranslatable` boolean - `parodyCommentaryFanLabel` string - `profileDescriptionLanguage` string - `profileImageShape` string - `profileInterstitialType` string - `profileSortEnabled` boolean - `profileTranslatorType` string - `superFollowEligible` boolean - `superFollowsUserProfileActive` boolean — Whether X marks the subscription profile as active. - `tipJar` UserTipJar — Public payment and creator-support handles shown on X. - … - `communityRole` string — Community role when returned by community member reads - `profile_bio` PublicMetadata — Public metadata whose fields are defined by X. - `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. - … truncated; see the full OpenAPI document linked below ## Other responses - `400` — Missing query - `401` — Non-MPP paid reads require Bearer authentication. Missing credentials offer guest checkout without creating 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 and checkout; a failed request never creates checkout. Guest keys offer top-up. - `403` — Account is protected. Choose a public account. Applies to initial and continuation requests in every timeline mode. No results are collected or charged. Public profile lookup remains available. - `404` — Not found - `409` — Cursor is in use. Retry `coverage_cursor_unavailable` later. - `410` — Restart without the `coverage_cursor_gone` cursor. - `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. - `429` — Xquik tier rate limit exceeded. The response includes a `Retry-After` header with the number of seconds to wait before retrying. - `502` — Dependency unavailable, unauthorized, or 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. - `503` — Coverage unavailable. Retry x_api_unavailable after Retry-After. Retry pagination_stalled once after 30 seconds. - `default` — Unexpected error. ## Changes - **2026-09-26** `9ae77b3e4fdc` — 24 warning - added the new `bookmark_folders_unavailable` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `429` - added the new `bookmark_folders_unavailable` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #2: StructuredError]/code` response property for the response status `429` - added the new `bookmark_folders_unavailable` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `400` - added the new `bookmark_folders_unavailable` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `403` - …20 more - …earlier changes not shown [Full history](https://skmtc.dev/xquik-dev/apis/xquik-api-2/changes/api/v1/x/tweets/search/get.md) --- [API](https://skmtc.dev/xquik-dev/apis/xquik-api-2.md) · [All operations](https://skmtc.dev/xquik-dev/apis/xquik-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/xquik-dev/apis/xquik-api-2/revisions/9ae77b3e4fdc?raw)