--- title: "Search tweets by query, Tweet ID, X status URL, or account date window" method: GET path: "/api/v1/x/tweets/search" tags: ["Tweets"] --- # Search tweets by query, Tweet ID, X status URL, or account date window `GET /api/v1/x/tweets/search` No-mode search maximizes coverage. New cursorless `Latest` sessions return rows newest-first across cursor pages. Existing cursors preserve their established ordering. ## 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' - `minFaves` 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 has_next_page is true. An empty filtered page can still have has_next_page true. 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 - `quotedTweetId` string — Quoted tweet ID. - `inReplyToId` string - `inReplyToUserId` string - `inReplyToUsername` string - `conversationId` string - `conversationControl` object — Public reply policy and conversation owner. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public interaction restrictions and user-facing 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 — Article metadata attached to a tweet. - `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 - `card` TweetCard — Public card metadata attached to a tweet. - `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[] — Public availability details for card user references X could not resolve. - `message` string — Human-readable availability message from X. - `reason` string — Machine-readable availability reason from X. - `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 - `createdAt` string - `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 - `destinationUrl` string - `visualStyle` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `edit` TweetEdit — Tweet edits. - `editTweetIds` string[] - `editableUntilMsecs` string - `initialTweetId` string - `isTranslatable` boolean - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - `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 - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Public place metadata attached to a 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 - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - `info` object - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - `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 - `quoted_tweet` EmbeddedTweet — Public fields shared by tweet response shapes. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `quotedTweetId` string — Quoted tweet ID. - `inReplyToId` string - `inReplyToUserId` string - `inReplyToUsername` string - `conversationId` string - `conversationControl` object — Public reply policy and conversation owner. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public interaction restrictions and user-facing 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 — Article metadata attached to a tweet. - `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 - `card` TweetCard — Public card metadata attached to a tweet. - `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[] — Public availability details for card user references X could not resolve. - `message` string — Human-readable availability message from X. - `reason` string — Machine-readable availability reason from X. - `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 - `createdAt` string - `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 - `destinationUrl` string - `visualStyle` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `edit` TweetEdit — Tweet edits. - `editTweetIds` string[] - `editableUntilMsecs` string - `initialTweetId` string - `isTranslatable` boolean - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - … - `smarttags` object[] - … - `symbols` TweetSymbol[] - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - … - `urls` TweetUrlEntity[] - … - `user_mentions` TweetUserMention[] - … - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Public place metadata attached to a 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 - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - `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 - `quoted_tweet` EmbeddedTweet — recursive - `retweeted_tweet` EmbeddedTweet — recursive - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `media` TweetMedia[] — Attached media items, 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. - `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 — X user profile with bio, follower counts, and verification status. - `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 - `createdAt` string - `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. - `retweeted_tweet` EmbeddedTweet — Public fields shared by tweet response shapes. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `quotedTweetId` string — Quoted tweet ID. - `inReplyToId` string - `inReplyToUserId` string - `inReplyToUsername` string - `conversationId` string - `conversationControl` object — Public reply policy and conversation owner. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public interaction restrictions and user-facing 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 — Article metadata attached to a tweet. - `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 - `card` TweetCard — Public card metadata attached to a tweet. - `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[] — Public availability details for card user references X could not resolve. - `message` string — Human-readable availability message from X. - `reason` string — Machine-readable availability reason from X. - `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 - `createdAt` string - `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 - `destinationUrl` string - `visualStyle` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `edit` TweetEdit — Tweet edits. - `editTweetIds` string[] - `editableUntilMsecs` string - `initialTweetId` string - `isTranslatable` boolean - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - … - `smarttags` object[] - … - `symbols` TweetSymbol[] - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - … - `urls` TweetUrlEntity[] - … - `user_mentions` TweetUserMention[] - … - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Public place metadata attached to a 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 - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - `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 - `quoted_tweet` EmbeddedTweet — recursive - `retweeted_tweet` EmbeddedTweet — recursive - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `media` TweetMedia[] — Attached media items, 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. - `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 — X user profile with bio, follower counts, and verification status. - `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 - `createdAt` string - `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. - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `media` TweetMedia[] — Attached media items, 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. - `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 — X user profile with bio, follower counts, and verification status. - `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 - `createdAt` string - `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. - `has_next_page` boolean, required - `next_cursor` string, required - TweetSearchCoverageResponse — Automatic search, user Tweet, and reply coverage preserves shape, filters, aliases, and billing. Follow next_cursor while has_next_page is true. An empty filtered page can still have has_next_page true. 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 - `quotedTweetId` string — Quoted tweet ID. - `inReplyToId` string - `inReplyToUserId` string - `inReplyToUsername` string - `conversationId` string - `conversationControl` object — Public reply policy and conversation owner. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public interaction restrictions and user-facing 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 — Article metadata attached to a tweet. - `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 - `card` TweetCard — Public card metadata attached to a tweet. - `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[] — Public availability details for card user references X could not resolve. - `message` string — Human-readable availability message from X. - `reason` string — Machine-readable availability reason from X. - `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 - `createdAt` string - `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 - `destinationUrl` string - `visualStyle` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `edit` TweetEdit — Tweet edits. - `editTweetIds` string[] - `editableUntilMsecs` string - `initialTweetId` string - `isTranslatable` boolean - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - `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 - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Public place metadata attached to a 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 - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - `info` object - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - `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 - `quoted_tweet` EmbeddedTweet — Public fields shared by tweet response shapes. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `quotedTweetId` string — Quoted tweet ID. - `inReplyToId` string - `inReplyToUserId` string - `inReplyToUsername` string - `conversationId` string - `conversationControl` object — Public reply policy and conversation owner. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public interaction restrictions and user-facing 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 — Article metadata attached to a tweet. - `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 - `card` TweetCard — Public card metadata attached to a tweet. - `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[] — Public availability details for card user references X could not resolve. - `message` string — Human-readable availability message from X. - `reason` string — Machine-readable availability reason from X. - `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 - `createdAt` string - `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 - `destinationUrl` string - `visualStyle` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `edit` TweetEdit — Tweet edits. - `editTweetIds` string[] - `editableUntilMsecs` string - `initialTweetId` string - `isTranslatable` boolean - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - … - `smarttags` object[] - … - `symbols` TweetSymbol[] - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - … - `urls` TweetUrlEntity[] - … - `user_mentions` TweetUserMention[] - … - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Public place metadata attached to a 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 - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - `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 - `quoted_tweet` EmbeddedTweet — recursive - `retweeted_tweet` EmbeddedTweet — recursive - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `media` TweetMedia[] — Attached media items, 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. - `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 — X user profile with bio, follower counts, and verification status. - `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 - `createdAt` string - `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. - `retweeted_tweet` EmbeddedTweet — Public fields shared by tweet response shapes. - `id` string, required - `text` string, required - `type` string - `createdAt` string - `url` string - `lang` string - `isReply` boolean - `isLimitedReply` boolean - `isNoteTweet` boolean - `isQuoteStatus` boolean - `quotedTweetId` string — Quoted tweet ID. - `inReplyToId` string - `inReplyToUserId` string - `inReplyToUsername` string - `conversationId` string - `conversationControl` object — Public reply policy and conversation owner. - `inviteViaMention` boolean - `ownerUsername` string - `policy` string - `limitedActions` object[] — Public interaction restrictions and user-facing 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 — Article metadata attached to a tweet. - `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 - `card` TweetCard — Public card metadata attached to a tweet. - `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[] — Public availability details for card user references X could not resolve. - `message` string — Human-readable availability message from X. - `reason` string — Machine-readable availability reason from X. - `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 - `createdAt` string - `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 - `destinationUrl` string - `visualStyle` string - `metadata` PublicMetadata — Public metadata whose fields are defined by X. - `edit` TweetEdit — Tweet edits. - `editTweetIds` string[] - `editableUntilMsecs` string - `initialTweetId` string - `isTranslatable` boolean - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - … - `smarttags` object[] - … - `symbols` TweetSymbol[] - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - … - `urls` TweetUrlEntity[] - … - `user_mentions` TweetUserMention[] - … - `richtextTags` object[] - `fromIndex` integer, required - `toIndex` integer, required - `types` string[], required - `place` TweetPlace — Public place metadata attached to a 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 - `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 — Public tweet entities. - `hashtags` TweetHashtag[] - `indices` integer[] - `text` string, required - `smarttags` object[] - `symbols` TweetSymbol[] - `indices` integer[] - `text` string - `tag` object - … - `timestamps` object[] — Video timestamp entities with indices, seconds, and text. - `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 - `quoted_tweet` EmbeddedTweet — recursive - `retweeted_tweet` EmbeddedTweet — recursive - `scopes` PublicMetadata — Public metadata whose fields are defined by X. - `media` TweetMedia[] — Attached media items, 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. - `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 — X user profile with bio, follower counts, and verification status. - `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 - `createdAt` string - `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 - … truncated; see the full OpenAPI document linked below ## Other responses - `400` — Missing query - `401` — Non-MPP paid reads require Bearer authentication. Missing credentials advertise guest checkout without creating it. Invalid credentials return a plain error. Confirm before calling an advertised action. - `402` — Payment required. MPP reads include `WWW-Authenticate`. Authenticated reads include balances and checkout. Guest keys expose guest top-up only. A failed request never creates checkout. Confirm first. - `409` — Cursor is in use. Retry `coverage_cursor_unavailable` later. - `410` — Restart without the `coverage_cursor_gone` cursor. - `424` — Dependency unavailable, unauthorized, or rate limited. Default v1 returns 502. The best-practice response contract returns 424 for transparent dependency failures. - `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 rate limited. Default v1 returns 502. The best-practice response contract returns 424 for transparent dependency failures. - `503` — Automatic or explicit maximum coverage is temporarily busy. - `default` — Unexpected error. --- [API](https://skmtc.net/xquik-dev/apis/xquik-api-2.md) · [All operations](https://skmtc.net/xquik-dev/apis/xquik-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xquik-dev/xquik-api-2/revisions/352bea67aca5/schema)