x-twitter-scraper 0.6.0 → 0.7.0

data/rbi/x_twitter_scraper/models/x/tweet_get_thread_params.rbi

@@ -29,10 +29,8 @@ module XTwitterScraper
         sig { params(cursor: String).void }
         attr_writer :cursor
 
-        # Maximum items requested from this page (1-100, default 20). The response can
-        # contain fewer items because the source returned fewer, filters removed items, or
-        # remaining credits cover fewer results. Keep requesting next_cursor while
-        # has_next_page is true, even when a page is empty. The deprecated limit and count
+        # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+        # results. Continue while has_next_page is true. Deprecated limit and count
         # aliases remain accepted.
         sig { returns(T.nilable(Integer)) }
         attr_reader :page_size
@@ -52,10 +50,8 @@ module XTwitterScraper
           id:,
           # Pagination cursor for thread tweets
           cursor: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           request_options: {}

data/rbi/x_twitter_scraper/models/x/user_retrieve_likes_params.rbi

@@ -146,10 +146,8 @@ module XTwitterScraper
         sig { params(min_retweets: Integer).void }
         attr_writer :min_retweets
 
-        # Maximum items requested from this page (1-100, default 20). The response can
-        # contain fewer items because the source returned fewer, filters removed items, or
-        # remaining credits cover fewer results. Keep requesting next_cursor while
-        # has_next_page is true, even when a page is empty. The deprecated limit and count
+        # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+        # results. Continue while has_next_page is true. Deprecated limit and count
         # aliases remain accepted.
         sig { returns(T.nilable(Integer)) }
         attr_reader :page_size
@@ -332,10 +330,8 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.

data/rbi/x_twitter_scraper/models/x/user_retrieve_media_params.rbi

@@ -146,10 +146,8 @@ module XTwitterScraper
         sig { params(min_retweets: Integer).void }
         attr_writer :min_retweets
 
-        # Maximum items requested from this page (1-100, default 20). The response can
-        # contain fewer items because the source returned fewer, filters removed items, or
-        # remaining credits cover fewer results. Keep requesting next_cursor while
-        # has_next_page is true, even when a page is empty. The deprecated limit and count
+        # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+        # results. Continue while has_next_page is true. Deprecated limit and count
         # aliases remain accepted.
         sig { returns(T.nilable(Integer)) }
         attr_reader :page_size
@@ -332,10 +330,8 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.

data/rbi/x_twitter_scraper/models/x/user_retrieve_mentions_params.rbi

@@ -146,10 +146,8 @@ module XTwitterScraper
         sig { params(min_retweets: Integer).void }
         attr_writer :min_retweets
 
-        # Maximum items requested from this page (1-100, default 20). The response can
-        # contain fewer items because the source returned fewer, filters removed items, or
-        # remaining credits cover fewer results. Keep requesting next_cursor while
-        # has_next_page is true, even when a page is empty. The deprecated limit and count
+        # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+        # results. Continue while has_next_page is true. Deprecated limit and count
         # aliases remain accepted.
         sig { returns(T.nilable(Integer)) }
         attr_reader :page_size
@@ -348,10 +346,8 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.

data/rbi/x_twitter_scraper/models/x/user_retrieve_replies_params.rbi

@@ -153,10 +153,8 @@ module XTwitterScraper
         sig { params(min_retweets: Integer).void }
         attr_writer :min_retweets
 
-        # Maximum items requested from this page (1-100, default 20). The response can
-        # contain fewer items because the source returned fewer, filters removed items, or
-        # remaining credits cover fewer results. Keep requesting next_cursor while
-        # has_next_page is true, even when a page is empty. The deprecated limit and count
+        # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+        # results. Continue while has_next_page is true. Deprecated limit and count
         # aliases remain accepted.
         sig { returns(T.nilable(Integer)) }
         attr_reader :page_size
@@ -342,10 +340,8 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.

data/rbi/x_twitter_scraper/models/x/user_retrieve_tweets_params.rbi

@@ -160,10 +160,8 @@ module XTwitterScraper
         sig { params(min_retweets: Integer).void }
         attr_writer :min_retweets
 
-        # Maximum items requested from this page (1-100, default 20). The response can
-        # contain fewer items because the source returned fewer, filters removed items, or
-        # remaining credits cover fewer results. Keep requesting next_cursor while
-        # has_next_page is true, even when a page is empty. The deprecated limit and count
+        # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+        # results. Continue while has_next_page is true. Deprecated limit and count
         # aliases remain accepted.
         sig { returns(T.nilable(Integer)) }
         attr_reader :page_size
@@ -352,10 +350,8 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.

data/rbi/x_twitter_scraper/models/x_get_article_response.rbi

@@ -388,12 +388,6 @@ module XTwitterScraper
         sig { returns(String) }
         attr_accessor :username
 
-        sig { returns(T.nilable(T::Boolean)) }
-        attr_reader :can_dm
-
-        sig { params(can_dm: T::Boolean).void }
-        attr_writer :can_dm
-
         sig { returns(T.nilable(String)) }
         attr_reader :created_at
 
@@ -490,7 +484,6 @@ module XTwitterScraper
             id: String,
             name: String,
             username: String,
-            can_dm: T::Boolean,
             created_at: String,
             description: String,
             favourites_count: Integer,
@@ -512,7 +505,6 @@ module XTwitterScraper
           id:,
           name:,
           username:,
-          can_dm: nil,
           created_at: nil,
           description: nil,
           favourites_count: nil,
@@ -537,7 +529,6 @@ module XTwitterScraper
               id: String,
               name: String,
               username: String,
-              can_dm: T::Boolean,
               created_at: String,
               description: String,
               favourites_count: Integer,

data/rbi/x_twitter_scraper/models/x_get_trends_response.rbi

@@ -70,6 +70,10 @@ module XTwitterScraper
         sig { params(description: String).void }
         attr_writer :description
 
+        # Promotion identifier from X. Null for organic trends.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :promoted_content
+
         sig { returns(T.nilable(String)) }
         attr_reader :query
 
@@ -82,20 +86,53 @@ module XTwitterScraper
         sig { params(rank: Integer).void }
         attr_writer :rank
 
+        # Approximate public post volume when X supplies it.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :tweet_volume
+
+        # X search URL for the trend.
+        sig { returns(T.nilable(String)) }
+        attr_reader :url
+
+        sig { params(url: String).void }
+        attr_writer :url
+
         sig do
           params(
             name: String,
             description: String,
+            promoted_content: T.nilable(String),
             query: String,
-            rank: Integer
+            rank: Integer,
+            tweet_volume: T.nilable(Integer),
+            url: String
           ).returns(T.attached_class)
         end
-        def self.new(name:, description: nil, query: nil, rank: nil)
+        def self.new(
+          name:,
+          description: nil,
+          # Promotion identifier from X. Null for organic trends.
+          promoted_content: nil,
+          query: nil,
+          rank: nil,
+          # Approximate public post volume when X supplies it.
+          tweet_volume: nil,
+          # X search URL for the trend.
+          url: nil
+        )
         end
 
         sig do
           override.returns(
-            { name: String, description: String, query: String, rank: Integer }
+            {
+              name: String,
+              description: String,
+              promoted_content: T.nilable(String),
+              query: String,
+              rank: Integer,
+              tweet_volume: T.nilable(Integer),
+              url: String
+            }
           )
         end
         def to_hash

data/rbi/x_twitter_scraper/resources/x/accounts.rbi

@@ -17,7 +17,7 @@ module XTwitterScraper
             totp_secret: String,
             username: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
-          ).returns(T.anything)
+          ).returns(XTwitterScraper::Models::X::AccountCreateResponse::Variants)
         end
         def create(
           # Account email

data/rbi/x_twitter_scraper/resources/x/communities/tweets.rbi

@@ -29,10 +29,8 @@ module XTwitterScraper
             q:,
             # Pagination cursor for community results
             cursor: nil,
-            # Maximum items requested from this page (1-100, default 20). The response can
-            # contain fewer items because the source returned fewer, filters removed items, or
-            # remaining credits cover fewer results. Keep requesting next_cursor while
-            # has_next_page is true, even when a page is empty. The deprecated limit and count
+            # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+            # results. Continue while has_next_page is true. Deprecated limit and count
             # aliases remain accepted.
             page_size: nil,
             # Sort order for community results (Latest or Top)
@@ -55,10 +53,8 @@ module XTwitterScraper
             id,
             # Pagination cursor for community tweets
             cursor: nil,
-            # Maximum items requested from this page (1-100, default 20). The response can
-            # contain fewer items because the source returned fewer, filters removed items, or
-            # remaining credits cover fewer results. Keep requesting next_cursor while
-            # has_next_page is true, even when a page is empty. The deprecated limit and count
+            # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+            # results. Continue while has_next_page is true. Deprecated limit and count
             # aliases remain accepted.
             page_size: nil,
             request_options: {}

data/rbi/x_twitter_scraper/resources/x/communities.rbi

@@ -140,10 +140,8 @@ module XTwitterScraper
           q:,
           # Pagination cursor for community search
           cursor: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Sort order (Latest or Top)

data/rbi/x_twitter_scraper/resources/x/lists.rbi

@@ -71,10 +71,8 @@ module XTwitterScraper
           cursor: nil,
           # Include replies (default false)
           include_replies: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Unix timestamp - filter after

data/rbi/x_twitter_scraper/resources/x/tweets.rbi

@@ -207,10 +207,8 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.
@@ -241,11 +239,10 @@ module XTwitterScraper
         )
         end
 
-        # Returns visible replies. For an unfiltered first page, Xquik compares a terminal
-        # page with the post's reported reply count. If the page is visibly incomplete,
-        # the endpoint returns 424 `replies_incomplete` instead of presenting partial
-        # coverage as complete. Use tweet search with a `conversation_id:{id}` query as
-        # the broader fallback.
+        # Returns direct replies. Complete mode merges available timeline views, supported
+        # rankings, every forward cursor module, labeled hidden-content branches,
+        # exact-parent time partitions scaled to the reported reply count, and search. It
+        # separates nested replies and returns 424 below 80% coverage.
         sig do
           params(
             id: String,
@@ -259,6 +256,7 @@ module XTwitterScraper
             hashtags: String,
             in_reply_to_tweet_id: String,
             language: String,
+            limit: Integer,
             media_type:
               XTwitterScraper::X::TweetGetRepliesParams::MediaType::OrSymbol,
             mentioning: String,
@@ -266,6 +264,7 @@ module XTwitterScraper
             min_quotes: Integer,
             min_replies: Integer,
             min_retweets: Integer,
+            mode: XTwitterScraper::X::TweetGetRepliesParams::Mode::OrSymbol,
             page_size: Integer,
             quotes: XTwitterScraper::X::TweetGetRepliesParams::Quotes::OrSymbol,
             quotes_of_tweet_id: String,
@@ -282,7 +281,7 @@ module XTwitterScraper
             url: String,
             verified_only: T::Boolean,
             request_options: XTwitterScraper::RequestOptions::OrHash
-          ).returns(XTwitterScraper::PaginatedTweets)
+          ).returns(XTwitterScraper::Models::X::TweetGetRepliesResponse)
         end
         def get_replies(
           # Tweet ID to get replies
@@ -308,6 +307,10 @@ module XTwitterScraper
           in_reply_to_tweet_id: nil,
           # Language code filter, e.g. en or tr.
           language: nil,
+          # With mode=complete, maximum combined direct and nested reply rows (1-25000).
+          # Without complete mode, this is the deprecated pageSize alias and uses the normal
+          # 1-100 page range.
+          limit: nil,
           # Filter by media type.
           media_type: nil,
           # Filter tweets mentioning a username.
@@ -320,10 +323,11 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Set complete for maximum-coverage collection. Complete mode accepts only limit.
+          # Remove cursor, pageSize, count, time ranges, and tweet filters.
+          mode: nil,
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.
@@ -391,10 +395,8 @@ module XTwitterScraper
           id,
           # Pagination cursor for thread tweets
           cursor: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           request_options: {}

data/rbi/x_twitter_scraper/resources/x/users.rbi

@@ -219,10 +219,8 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.
@@ -323,10 +321,8 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.
@@ -429,10 +425,8 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.
@@ -540,10 +534,8 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.
@@ -667,10 +659,8 @@ module XTwitterScraper
           min_replies: nil,
           # Minimum retweets threshold.
           min_retweets: nil,
-          # Maximum items requested from this page (1-100, default 20). The response can
-          # contain fewer items because the source returned fewer, filters removed items, or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true, even when a page is empty. The deprecated limit and count
+          # Maximum page items (1-100, default 20). Source, filters, or credits can reduce
+          # results. Continue while has_next_page is true. Deprecated limit and count
           # aliases remain accepted.
           page_size: nil,
           # Quote mode.

data/sig/x_twitter_scraper/models/content_disclosure.rbs

@@ -46,17 +46,9 @@ module XTwitterScraper
       end
 
       type ai_generated =
-        {
-          can_edit: bool,
-          detection_source: String,
-          has_ai_generated_media: bool
-        }
+        { detection_source: String, has_ai_generated_media: bool }
 
       class AIGenerated < XTwitterScraper::Internal::Type::BaseModel
-        attr_reader can_edit: bool?
-
-        def can_edit=: (bool) -> bool
-
         attr_reader detection_source: String?
 
         def detection_source=: (String) -> String
@@ -66,13 +58,11 @@ module XTwitterScraper
         def has_ai_generated_media=: (bool) -> bool
 
         def initialize: (
-          ?can_edit: bool,
           ?detection_source: String,
           ?has_ai_generated_media: bool
         ) -> void
 
         def to_hash: -> {
-          can_edit: bool,
           detection_source: String,
           has_ai_generated_media: bool
         }