x-twitter-scraper 0.5.5 → 0.7.0

data/lib/x_twitter_scraper/models/paginated_tweets.rb

@@ -23,11 +23,10 @@ module XTwitterScraper
       required :tweets, -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::SearchTweet] }
 
       # @!method initialize(has_next_page:, next_cursor:, tweets:)
-      #   Paginated tweet results. The item count can be lower than pageSize when the
-      #   source returns fewer tweets, filters remove tweets, or remaining credits cover
-      #   fewer results. Follow next_cursor while has_next_page is true. An empty page can
-      #   still have has_next_page true after filtering. Zero affordable results returns
-      #   402 insufficient_credits.
+      #   Paginated tweets. Source visibility, filters, or remaining credits can reduce
+      #   results. An empty filtered page can still have has_next_page true. Follow
+      #   next_cursor while has_next_page is true. Zero affordable results returns 402
+      #   insufficient_credits.
       #
       #   @param has_next_page [Boolean]
       #   @param next_cursor [String]

data/lib/x_twitter_scraper/models/radar_item.rb

@@ -24,6 +24,7 @@ module XTwitterScraper
       required :created_at, Time, api_name: :createdAt
 
       # @!attribute language
+      #   BCP-47 language code. und means the source did not identify a language.
       #
       #   @return [String]
       required :language, String
@@ -31,7 +32,18 @@ module XTwitterScraper
       # @!attribute metadata
       #   Source-specific fields. Shape varies per source:
       #
-      #   - reddit: { subreddit: string, author: string }
+      #   - reddit: { author, authorId?, subreddit, subredditId?, subredditSubscribers?,
+      #     sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?,
+      #     numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?,
+      #     postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?,
+      #     editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?,
+      #     isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?,
+      #     isSelf?, isSpoiler?, isVideo?, locked?, stickied? }. `score` is Reddit's
+      #     public net score. Exact public upvote and downvote counts are not available.
+      #     Estimated counts derive from the public score and upvote ratio, which Reddit
+      #     may fuzz. Comment bodies are not included. Current items combine public
+      #     listing discovery with server-rendered post data and use `sourceFormat: html`;
+      #     `json` and `rss` remain for legacy rows.
       #   - github: { starsToday: number }
       #   - hacker_news: { points: number, numberComments: number }
       #   - google_trends: { approxTraffic: number }
@@ -39,10 +51,15 @@ module XTwitterScraper
       #   - wikipedia: { views: number }
       #   - trustmrr: { mrr, growthPercent, last30Days, total, customers,
       #     activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
-      #     growthMrrPercent?, multiple?, paymentProvider?, rank? }
+      #     foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?,
+      #     multiple?, paymentProvider?, profitMarginLast30Days?, rank?,
+      #     revenuePerVisitor?, targetAudience?, visitorsLast30Days? } For the startup
+      #     growth source, xHandle is the founder's X username without @. The rank field
+      #     is the source's revenue rank. Result order represents reported 30-day
+      #     revenue-growth rank.
       #
-      #   @return [Hash{Symbol=>Object}]
-      required :metadata, XTwitterScraper::Internal::Type::HashOf[XTwitterScraper::Internal::Type::Unknown]
+      #   @return [XTwitterScraper::Models::RadarItem::Metadata]
+      required :metadata, -> { XTwitterScraper::RadarItem::Metadata }
 
       # @!attribute published_at
       #
@@ -81,6 +98,7 @@ module XTwitterScraper
       optional :description, String
 
       # @!attribute image_url
+      #   Source image. Startup growth items return the logo here.
       #
       #   @return [String, nil]
       optional :image_url, String, api_name: :imageUrl
@@ -103,9 +121,9 @@ module XTwitterScraper
       #
       #   @param created_at [Time]
       #
-      #   @param language [String]
+      #   @param language [String] BCP-47 language code. und means the source did not identify a language.
       #
-      #   @param metadata [Hash{Symbol=>Object}] Source-specific fields. Shape varies per source:
+      #   @param metadata [XTwitterScraper::Models::RadarItem::Metadata] Source-specific fields. Shape varies per source:
       #
       #   @param published_at [Time]
       #
@@ -121,7 +139,7 @@ module XTwitterScraper
       #
       #   @param description [String]
       #
-      #   @param image_url [String]
+      #   @param image_url [String] Source image. Startup growth items return the logo here.
       #
       #   @param url [String]
 
@@ -142,6 +160,125 @@ module XTwitterScraper
         #   @return [Array<Symbol>]
       end
 
+      # @see XTwitterScraper::Models::RadarItem#metadata
+      class Metadata < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute author
+        #
+        #   @return [String, nil]
+        optional :author, String
+
+        # @!attribute content_url
+        #
+        #   @return [String, nil]
+        optional :content_url, String, api_name: :contentUrl
+
+        # @!attribute estimated_downvotes
+        #
+        #   @return [Integer, nil]
+        optional :estimated_downvotes, Integer, api_name: :estimatedDownvotes
+
+        # @!attribute estimated_upvotes
+        #
+        #   @return [Integer, nil]
+        optional :estimated_upvotes, Integer, api_name: :estimatedUpvotes
+
+        # @!attribute number_comments
+        #
+        #   @return [Integer, nil]
+        optional :number_comments, Integer, api_name: :numberComments
+
+        # @!attribute score
+        #
+        #   @return [Integer, nil]
+        optional :score, Integer
+
+        # @!attribute selftext
+        #
+        #   @return [String, nil]
+        optional :selftext, String
+
+        # @!attribute source_format
+        #   Current items use html. json and rss are retained for legacy rows.
+        #
+        #   @return [Symbol, XTwitterScraper::Models::RadarItem::Metadata::SourceFormat, nil]
+        optional :source_format,
+                 enum: -> { XTwitterScraper::RadarItem::Metadata::SourceFormat },
+                 api_name: :sourceFormat
+
+        # @!attribute subreddit
+        #
+        #   @return [String, nil]
+        optional :subreddit, String
+
+        # @!attribute upvote_ratio
+        #
+        #   @return [Float, nil]
+        optional :upvote_ratio, Float, api_name: :upvoteRatio
+
+        # @!method initialize(author: nil, content_url: nil, estimated_downvotes: nil, estimated_upvotes: nil, number_comments: nil, score: nil, selftext: nil, source_format: nil, subreddit: nil, upvote_ratio: nil)
+        #   Source-specific fields. Shape varies per source:
+        #
+        #   - reddit: { author, authorId?, subreddit, subredditId?, subredditSubscribers?,
+        #     sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?,
+        #     numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?,
+        #     postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?,
+        #     editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?,
+        #     isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?,
+        #     isSelf?, isSpoiler?, isVideo?, locked?, stickied? }. `score` is Reddit's
+        #     public net score. Exact public upvote and downvote counts are not available.
+        #     Estimated counts derive from the public score and upvote ratio, which Reddit
+        #     may fuzz. Comment bodies are not included. Current items combine public
+        #     listing discovery with server-rendered post data and use `sourceFormat: html`;
+        #     `json` and `rss` remain for legacy rows.
+        #   - github: { starsToday: number }
+        #   - hacker_news: { points: number, numberComments: number }
+        #   - google_trends: { approxTraffic: number }
+        #   - polymarket: { volume24hr: number }
+        #   - wikipedia: { views: number }
+        #   - trustmrr: { mrr, growthPercent, last30Days, total, customers,
+        #     activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
+        #     foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?,
+        #     multiple?, paymentProvider?, profitMarginLast30Days?, rank?,
+        #     revenuePerVisitor?, targetAudience?, visitorsLast30Days? } For the startup
+        #     growth source, xHandle is the founder's X username without @. The rank field
+        #     is the source's revenue rank. Result order represents reported 30-day
+        #     revenue-growth rank.
+        #
+        #   @param author [String]
+        #
+        #   @param content_url [String]
+        #
+        #   @param estimated_downvotes [Integer]
+        #
+        #   @param estimated_upvotes [Integer]
+        #
+        #   @param number_comments [Integer]
+        #
+        #   @param score [Integer]
+        #
+        #   @param selftext [String]
+        #
+        #   @param source_format [Symbol, XTwitterScraper::Models::RadarItem::Metadata::SourceFormat] Current items use html. json and rss are retained for legacy rows.
+        #
+        #   @param subreddit [String]
+        #
+        #   @param upvote_ratio [Float]
+
+        # Current items use html. json and rss are retained for legacy rows.
+        #
+        # @see XTwitterScraper::Models::RadarItem::Metadata#source_format
+        module SourceFormat
+          extend XTwitterScraper::Internal::Type::Enum
+
+          HTML = :html
+          JSON = :json
+          RSS = :rss
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
       # @see XTwitterScraper::Models::RadarItem#source
       module Source
         extend XTwitterScraper::Internal::Type::Enum

data/lib/x_twitter_scraper/models/search_tweet.rb

@@ -47,12 +47,30 @@ module XTwitterScraper
       #   @return [Integer]
       required :view_count, Integer, api_name: :viewCount
 
+      # @!attribute article
+      #   Article metadata attached to a tweet.
+      #
+      #   @return [XTwitterScraper::Models::SearchTweet::Article, nil]
+      optional :article, -> { XTwitterScraper::SearchTweet::Article }
+
       # @!attribute author
       #   X user profile with bio, follower counts, and verification status.
       #
       #   @return [XTwitterScraper::Models::UserProfile, nil]
       optional :author, -> { XTwitterScraper::UserProfile }
 
+      # @!attribute card
+      #   Public card metadata attached to a tweet.
+      #
+      #   @return [XTwitterScraper::Models::SearchTweet::Card, nil]
+      optional :card, -> { XTwitterScraper::SearchTweet::Card }
+
+      # @!attribute community_note
+      #   Community Note presentation metadata returned by X.
+      #
+      #   @return [XTwitterScraper::Models::SearchTweet::CommunityNote, nil]
+      optional :community_note, -> { XTwitterScraper::SearchTweet::CommunityNote }, api_name: :communityNote
+
       # @!attribute content_disclosure
       #   Content disclosure metadata shown by X when a tweet is labeled as paid
       #   partnership content or AI-generated media.
@@ -79,6 +97,12 @@ module XTwitterScraper
                XTwitterScraper::Internal::Type::ArrayOf[Integer],
                api_name: :displayTextRange
 
+      # @!attribute edit
+      #   Edit history metadata returned by X.
+      #
+      #   @return [XTwitterScraper::Models::SearchTweet::Edit, nil]
+      optional :edit, -> { XTwitterScraper::SearchTweet::Edit }
+
       # @!attribute entities
       #   Parsed search-result entities including URLs, mentions, hashtags, and media
       #   markers
@@ -128,6 +152,11 @@ module XTwitterScraper
       #   @return [Boolean, nil]
       optional :is_reply, XTwitterScraper::Internal::Type::Boolean, api_name: :isReply
 
+      # @!attribute is_translatable
+      #
+      #   @return [Boolean, nil]
+      optional :is_translatable, XTwitterScraper::Internal::Type::Boolean, api_name: :isTranslatable
+
       # @!attribute lang
       #   Search result language code.
       #
@@ -140,6 +169,33 @@ module XTwitterScraper
       #   @return [Array<XTwitterScraper::Models::TweetMedia>, nil]
       optional :media, -> { XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::TweetMedia] }
 
+      # @!attribute note_tweet
+      #   Complete Note Tweet content and rich-text metadata.
+      #
+      #   @return [XTwitterScraper::Models::SearchTweet::NoteTweet, nil]
+      optional :note_tweet, -> { XTwitterScraper::SearchTweet::NoteTweet }, api_name: :noteTweet
+
+      # @!attribute place
+      #   Public place metadata attached to a tweet.
+      #
+      #   @return [XTwitterScraper::Models::SearchTweet::Place, nil]
+      optional :place, -> { XTwitterScraper::SearchTweet::Place }
+
+      # @!attribute possibly_sensitive
+      #
+      #   @return [Boolean, nil]
+      optional :possibly_sensitive, XTwitterScraper::Internal::Type::Boolean, api_name: :possiblySensitive
+
+      # @!attribute previous_counts
+      #   Engagement counts retained from a prior tweet edit.
+      #
+      #   @return [XTwitterScraper::Models::SearchTweet::PreviousCounts, nil]
+      optional :previous_counts,
+               -> {
+                 XTwitterScraper::SearchTweet::PreviousCounts
+               },
+               api_name: :previousCounts
+
       # @!attribute quoted_tweet
       #   Quoted or retweeted tweet context. Every object includes id, text, and
       #   engagement metrics. A zero metric can mean X did not report the count. Author,
@@ -173,7 +229,12 @@ module XTwitterScraper
       #   @return [String, nil]
       optional :url, String
 
-      # @!method initialize(id:, bookmark_count:, like_count:, quote_count:, reply_count:, retweet_count:, text:, view_count:, author: nil, content_disclosure: nil, conversation_id: nil, created_at: nil, display_text_range: nil, entities: nil, in_reply_to_id: nil, in_reply_to_user_id: nil, in_reply_to_username: nil, is_limited_reply: nil, is_note_tweet: nil, is_quote_status: nil, is_reply: nil, lang: nil, media: nil, quoted_tweet: nil, retweeted_tweet: nil, source: nil, type: nil, url: nil)
+      # @!attribute view_state
+      #
+      #   @return [String, nil]
+      optional :view_state, String, api_name: :viewState
+
+      # @!method initialize(id:, bookmark_count:, like_count:, quote_count:, reply_count:, retweet_count:, text:, view_count:, article: nil, author: nil, card: nil, community_note: nil, content_disclosure: nil, conversation_id: nil, created_at: nil, display_text_range: nil, edit: nil, entities: nil, in_reply_to_id: nil, in_reply_to_user_id: nil, in_reply_to_username: nil, is_limited_reply: nil, is_note_tweet: nil, is_quote_status: nil, is_reply: nil, is_translatable: nil, lang: nil, media: nil, note_tweet: nil, place: nil, possibly_sensitive: nil, previous_counts: nil, quoted_tweet: nil, retweeted_tweet: nil, source: nil, type: nil, url: nil, view_state: nil)
       #   Some parameter documentations has been truncated, see
       #   {XTwitterScraper::Models::SearchTweet} for more details.
       #
@@ -196,8 +257,14 @@ module XTwitterScraper
       #
       #   @param view_count [Integer]
       #
+      #   @param article [XTwitterScraper::Models::SearchTweet::Article] Article metadata attached to a tweet.
+      #
       #   @param author [XTwitterScraper::Models::UserProfile] X user profile with bio, follower counts, and verification status.
       #
+      #   @param card [XTwitterScraper::Models::SearchTweet::Card] Public card metadata attached to a tweet.
+      #
+      #   @param community_note [XTwitterScraper::Models::SearchTweet::CommunityNote] Community Note presentation metadata returned by X.
+      #
       #   @param content_disclosure [XTwitterScraper::Models::ContentDisclosure] Content disclosure metadata shown by X when a tweet is labeled as paid partnersh
       #
       #   @param conversation_id [String] Root tweet ID for the search result conversation
@@ -206,6 +273,8 @@ module XTwitterScraper
       #
       #   @param display_text_range [Array<Integer>] Rendered text's start and end offsets.
       #
+      #   @param edit [XTwitterScraper::Models::SearchTweet::Edit] Edit history metadata returned by X.
+      #
       #   @param entities [Hash{Symbol=>Object}] Parsed search-result entities including URLs, mentions, hashtags, and media mark
       #
       #   @param in_reply_to_id [String] ID of the tweet this result replies to.
@@ -222,10 +291,20 @@ module XTwitterScraper
       #
       #   @param is_reply [Boolean] True when this search result is a reply
       #
+      #   @param is_translatable [Boolean]
+      #
       #   @param lang [String] Search result language code.
       #
       #   @param media [Array<XTwitterScraper::Models::TweetMedia>] Search-result media attachments, omitted when no media is present
       #
+      #   @param note_tweet [XTwitterScraper::Models::SearchTweet::NoteTweet] Complete Note Tweet content and rich-text metadata.
+      #
+      #   @param place [XTwitterScraper::Models::SearchTweet::Place] Public place metadata attached to a tweet.
+      #
+      #   @param possibly_sensitive [Boolean]
+      #
+      #   @param previous_counts [XTwitterScraper::Models::SearchTweet::PreviousCounts] Engagement counts retained from a prior tweet edit.
+      #
       #   @param quoted_tweet [XTwitterScraper::Models::EmbeddedTweet] Quoted or retweeted tweet context. Every object includes id, text, and engagemen
       #
       #   @param retweeted_tweet [XTwitterScraper::Models::EmbeddedTweet] Quoted or retweeted tweet context. Every object includes id, text, and engagemen
@@ -235,6 +314,297 @@ module XTwitterScraper
       #   @param type [String]
       #
       #   @param url [String] Search result permalink.
+      #
+      #   @param view_state [String]
+
+      # @see XTwitterScraper::Models::SearchTweet#article
+      class Article < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute cover_media_url
+        #
+        #   @return [String, nil]
+        optional :cover_media_url, String, api_name: :coverMediaUrl
+
+        # @!attribute preview_text
+        #
+        #   @return [String, nil]
+        optional :preview_text, String, api_name: :previewText
+
+        # @!attribute title
+        #
+        #   @return [String, nil]
+        optional :title, String
+
+        # @!method initialize(id: nil, cover_media_url: nil, preview_text: nil, title: nil)
+        #   Article metadata attached to a tweet.
+        #
+        #   @param id [String]
+        #   @param cover_media_url [String]
+        #   @param preview_text [String]
+        #   @param title [String]
+      end
+
+      # @see XTwitterScraper::Models::SearchTweet#card
+      class Card < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute binding_values
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :binding_values,
+                 XTwitterScraper::Internal::Type::HashOf[XTwitterScraper::Internal::Type::Unknown],
+                 api_name: :bindingValues
+
+        # @!attribute name
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!attribute url
+        #
+        #   @return [String, nil]
+        optional :url, String
+
+        # @!method initialize(id: nil, binding_values: nil, name: nil, url: nil)
+        #   Public card metadata attached to a tweet.
+        #
+        #   @param id [String]
+        #   @param binding_values [Hash{Symbol=>Object}]
+        #   @param name [String]
+        #   @param url [String]
+      end
+
+      # @see XTwitterScraper::Models::SearchTweet#community_note
+      class CommunityNote < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute destination_url
+        #
+        #   @return [String, nil]
+        optional :destination_url, String, api_name: :destinationUrl
+
+        # @!attribute footer
+        #
+        #   @return [String, nil]
+        optional :footer, String
+
+        # @!attribute short_title
+        #
+        #   @return [String, nil]
+        optional :short_title, String, api_name: :shortTitle
+
+        # @!attribute subtitle
+        #
+        #   @return [String, nil]
+        optional :subtitle, String
+
+        # @!attribute title
+        #
+        #   @return [String, nil]
+        optional :title, String
+
+        # @!attribute visual_style
+        #
+        #   @return [String, nil]
+        optional :visual_style, String, api_name: :visualStyle
+
+        # @!method initialize(id: nil, destination_url: nil, footer: nil, short_title: nil, subtitle: nil, title: nil, visual_style: nil)
+        #   Community Note presentation metadata returned by X.
+        #
+        #   @param id [String]
+        #   @param destination_url [String]
+        #   @param footer [String]
+        #   @param short_title [String]
+        #   @param subtitle [String]
+        #   @param title [String]
+        #   @param visual_style [String]
+      end
+
+      # @see XTwitterScraper::Models::SearchTweet#edit
+      class Edit < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute editable_until_msecs
+        #
+        #   @return [String, nil]
+        optional :editable_until_msecs, String, api_name: :editableUntilMsecs
+
+        # @!attribute edit_tweet_ids
+        #
+        #   @return [Array<String>, nil]
+        optional :edit_tweet_ids, XTwitterScraper::Internal::Type::ArrayOf[String], api_name: :editTweetIds
+
+        # @!method initialize(editable_until_msecs: nil, edit_tweet_ids: nil)
+        #   Edit history metadata returned by X.
+        #
+        #   @param editable_until_msecs [String]
+        #   @param edit_tweet_ids [Array<String>]
+      end
+
+      # @see XTwitterScraper::Models::SearchTweet#note_tweet
+      class NoteTweet < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute text
+        #
+        #   @return [String]
+        required :text, String
+
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute entities
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :entities, XTwitterScraper::Internal::Type::HashOf[XTwitterScraper::Internal::Type::Unknown]
+
+        # @!attribute is_expandable
+        #
+        #   @return [Boolean, nil]
+        optional :is_expandable, XTwitterScraper::Internal::Type::Boolean, api_name: :isExpandable
+
+        # @!attribute richtext_tags
+        #
+        #   @return [Array<XTwitterScraper::Models::SearchTweet::NoteTweet::RichtextTag>, nil]
+        optional :richtext_tags,
+                 -> {
+                   XTwitterScraper::Internal::Type::ArrayOf[XTwitterScraper::SearchTweet::NoteTweet::RichtextTag]
+                 },
+                 api_name: :richtextTags
+
+        # @!method initialize(text:, id: nil, entities: nil, is_expandable: nil, richtext_tags: nil)
+        #   Complete Note Tweet content and rich-text metadata.
+        #
+        #   @param text [String]
+        #   @param id [String]
+        #   @param entities [Hash{Symbol=>Object}]
+        #   @param is_expandable [Boolean]
+        #   @param richtext_tags [Array<XTwitterScraper::Models::SearchTweet::NoteTweet::RichtextTag>]
+
+        class RichtextTag < XTwitterScraper::Internal::Type::BaseModel
+          # @!attribute from_index
+          #
+          #   @return [Integer]
+          required :from_index, Integer, api_name: :fromIndex
+
+          # @!attribute to_index
+          #
+          #   @return [Integer]
+          required :to_index, Integer, api_name: :toIndex
+
+          # @!attribute types
+          #
+          #   @return [Array<String>]
+          required :types, XTwitterScraper::Internal::Type::ArrayOf[String]
+
+          # @!method initialize(from_index:, to_index:, types:)
+          #   @param from_index [Integer]
+          #   @param to_index [Integer]
+          #   @param types [Array<String>]
+        end
+      end
+
+      # @see XTwitterScraper::Models::SearchTweet#place
+      class Place < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String, nil]
+        optional :id, String
+
+        # @!attribute bounding_box
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :bounding_box,
+                 XTwitterScraper::Internal::Type::HashOf[XTwitterScraper::Internal::Type::Unknown],
+                 api_name: :boundingBox
+
+        # @!attribute country
+        #
+        #   @return [String, nil]
+        optional :country, String
+
+        # @!attribute country_code
+        #
+        #   @return [String, nil]
+        optional :country_code, String, api_name: :countryCode
+
+        # @!attribute full_name
+        #
+        #   @return [String, nil]
+        optional :full_name, String, api_name: :fullName
+
+        # @!attribute name
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!attribute place_type
+        #
+        #   @return [String, nil]
+        optional :place_type, String, api_name: :placeType
+
+        # @!attribute url
+        #
+        #   @return [String, nil]
+        optional :url, String
+
+        # @!method initialize(id: nil, bounding_box: nil, country: nil, country_code: nil, full_name: nil, name: nil, place_type: nil, url: nil)
+        #   Public place metadata attached to a tweet.
+        #
+        #   @param id [String]
+        #   @param bounding_box [Hash{Symbol=>Object}]
+        #   @param country [String]
+        #   @param country_code [String]
+        #   @param full_name [String]
+        #   @param name [String]
+        #   @param place_type [String]
+        #   @param url [String]
+      end
+
+      # @see XTwitterScraper::Models::SearchTweet#previous_counts
+      class PreviousCounts < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute bookmark_count
+        #
+        #   @return [Integer, nil]
+        optional :bookmark_count, Integer, api_name: :bookmarkCount
+
+        # @!attribute like_count
+        #
+        #   @return [Integer, nil]
+        optional :like_count, Integer, api_name: :likeCount
+
+        # @!attribute quote_count
+        #
+        #   @return [Integer, nil]
+        optional :quote_count, Integer, api_name: :quoteCount
+
+        # @!attribute reply_count
+        #
+        #   @return [Integer, nil]
+        optional :reply_count, Integer, api_name: :replyCount
+
+        # @!attribute retweet_count
+        #
+        #   @return [Integer, nil]
+        optional :retweet_count, Integer, api_name: :retweetCount
+
+        # @!method initialize(bookmark_count: nil, like_count: nil, quote_count: nil, reply_count: nil, retweet_count: nil)
+        #   Engagement counts retained from a prior tweet edit.
+        #
+        #   @param bookmark_count [Integer]
+        #   @param like_count [Integer]
+        #   @param quote_count [Integer]
+        #   @param reply_count [Integer]
+        #   @param retweet_count [Integer]
+      end
     end
   end
 end