x-twitter-scraper 0.9.0 → 0.10.0

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

@@ -22,6 +22,35 @@ module XTwitterScraper
         sig { returns(String) }
         attr_accessor :id
 
+        # Words or quoted phrases where any one can match. Separate with spaces, commas,
+        # or lines.
+        sig { returns(T.nilable(String)) }
+        attr_reader :any_words
+
+        sig { params(any_words: String).void }
+        attr_writer :any_words
+
+        # Only return tweets from Blue-verified authors.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :blue_verified_only
+
+        sig { params(blue_verified_only: T::Boolean).void }
+        attr_writer :blue_verified_only
+
+        # Cashtags separated by spaces, commas, or lines.
+        sig { returns(T.nilable(String)) }
+        attr_reader :cashtags
+
+        sig { params(cashtags: String).void }
+        attr_writer :cashtags
+
+        # Conversation ID filter.
+        sig { returns(T.nilable(String)) }
+        attr_reader :conversation_id
+
+        sig { params(conversation_id: String).void }
+        attr_writer :conversation_id
+
         # Pagination cursor for thread tweets
         sig { returns(T.nilable(String)) }
         attr_reader :cursor
@@ -29,6 +58,143 @@ module XTwitterScraper
         sig { params(cursor: String).void }
         attr_writer :cursor
 
+        # Exact phrase to match.
+        sig { returns(T.nilable(String)) }
+        attr_reader :exact_phrase
+
+        sig { params(exact_phrase: String).void }
+        attr_writer :exact_phrase
+
+        # Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+        sig { returns(T.nilable(String)) }
+        attr_reader :exclude_words
+
+        sig { params(exclude_words: String).void }
+        attr_writer :exclude_words
+
+        # Filter by author username.
+        sig { returns(T.nilable(String)) }
+        attr_reader :from_user
+
+        sig { params(from_user: String).void }
+        attr_writer :from_user
+
+        # Hashtags separated by spaces, commas, or lines.
+        sig { returns(T.nilable(String)) }
+        attr_reader :hashtags
+
+        sig { params(hashtags: String).void }
+        attr_writer :hashtags
+
+        # Only replies to this tweet ID.
+        sig { returns(T.nilable(String)) }
+        attr_reader :in_reply_to_tweet_id
+
+        sig { params(in_reply_to_tweet_id: String).void }
+        attr_writer :in_reply_to_tweet_id
+
+        # Language code filter, e.g. en or tr.
+        sig { returns(T.nilable(String)) }
+        attr_reader :language
+
+        sig { params(language: String).void }
+        attr_writer :language
+
+        # Maximum likes threshold. maxLikes is also accepted.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :max_faves
+
+        sig { params(max_faves: Integer).void }
+        attr_writer :max_faves
+
+        # Maximum quotes threshold.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :max_quotes
+
+        sig { params(max_quotes: Integer).void }
+        attr_writer :max_quotes
+
+        # Maximum replies threshold.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :max_replies
+
+        sig { params(max_replies: Integer).void }
+        attr_writer :max_replies
+
+        # Maximum retweets threshold.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :max_retweets
+
+        sig { params(max_retweets: Integer).void }
+        attr_writer :max_retweets
+
+        # Filter by media type.
+        sig do
+          returns(
+            T.nilable(
+              XTwitterScraper::X::TweetGetThreadParams::MediaType::OrSymbol
+            )
+          )
+        end
+        attr_reader :media_type
+
+        sig do
+          params(
+            media_type:
+              XTwitterScraper::X::TweetGetThreadParams::MediaType::OrSymbol
+          ).void
+        end
+        attr_writer :media_type
+
+        # Filter tweets mentioning a username.
+        sig { returns(T.nilable(String)) }
+        attr_reader :mentioning
+
+        sig { params(mentioning: String).void }
+        attr_writer :mentioning
+
+        # Minimum bookmark count threshold.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :min_bookmarks
+
+        sig { params(min_bookmarks: Integer).void }
+        attr_writer :min_bookmarks
+
+        # Minimum likes threshold. minLikes is also accepted.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :min_faves
+
+        sig { params(min_faves: Integer).void }
+        attr_writer :min_faves
+
+        # Minimum quote count threshold.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :min_quotes
+
+        sig { params(min_quotes: Integer).void }
+        attr_writer :min_quotes
+
+        # Minimum replies threshold.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :min_replies
+
+        sig { params(min_replies: Integer).void }
+        attr_writer :min_replies
+
+        # Minimum retweets threshold.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :min_retweets
+
+        sig { params(min_retweets: Integer).void }
+        attr_writer :min_retweets
+
+        # Minimum view count threshold.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :min_views
+
+        sig { params(min_views: Integer).void }
+        attr_writer :min_views
+
         # 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.
@@ -38,22 +204,223 @@ module XTwitterScraper
         sig { params(page_size: Integer).void }
         attr_writer :page_size
 
+        # Quote mode.
+        sig do
+          returns(
+            T.nilable(
+              XTwitterScraper::X::TweetGetThreadParams::Quotes::OrSymbol
+            )
+          )
+        end
+        attr_reader :quotes
+
+        sig do
+          params(
+            quotes: XTwitterScraper::X::TweetGetThreadParams::Quotes::OrSymbol
+          ).void
+        end
+        attr_writer :quotes
+
+        # Only quotes of this tweet ID.
+        sig { returns(T.nilable(String)) }
+        attr_reader :quotes_of_tweet_id
+
+        sig { params(quotes_of_tweet_id: String).void }
+        attr_writer :quotes_of_tweet_id
+
+        # Reply mode.
+        sig do
+          returns(
+            T.nilable(
+              XTwitterScraper::X::TweetGetThreadParams::Replies::OrSymbol
+            )
+          )
+        end
+        attr_reader :replies
+
+        sig do
+          params(
+            replies: XTwitterScraper::X::TweetGetThreadParams::Replies::OrSymbol
+          ).void
+        end
+        attr_writer :replies
+
+        # Retweet mode.
+        sig do
+          returns(
+            T.nilable(
+              XTwitterScraper::X::TweetGetThreadParams::Retweets::OrSymbol
+            )
+          )
+        end
+        attr_reader :retweets
+
+        sig do
+          params(
+            retweets:
+              XTwitterScraper::X::TweetGetThreadParams::Retweets::OrSymbol
+          ).void
+        end
+        attr_writer :retweets
+
+        # Only retweets of this tweet ID.
+        sig { returns(T.nilable(String)) }
+        attr_reader :retweets_of_tweet_id
+
+        sig { params(retweets_of_tweet_id: String).void }
+        attr_writer :retweets_of_tweet_id
+
+        # Start date in YYYY-MM-DD format.
+        sig { returns(T.nilable(Date)) }
+        attr_reader :since_date
+
+        sig { params(since_date: Date).void }
+        attr_writer :since_date
+
+        # Filter replies sent to a username.
+        sig { returns(T.nilable(String)) }
+        attr_reader :to_user
+
+        sig { params(to_user: String).void }
+        attr_writer :to_user
+
+        # End date in YYYY-MM-DD format.
+        sig { returns(T.nilable(Date)) }
+        attr_reader :until_date
+
+        sig { params(until_date: Date).void }
+        attr_writer :until_date
+
+        # URL substring or domain filter.
+        sig { returns(T.nilable(String)) }
+        attr_reader :url
+
+        sig { params(url: String).void }
+        attr_writer :url
+
+        # Only return tweets from verified authors.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :verified_only
+
+        sig { params(verified_only: T::Boolean).void }
+        attr_writer :verified_only
+
         sig do
           params(
             id: String,
+            any_words: String,
+            blue_verified_only: T::Boolean,
+            cashtags: String,
+            conversation_id: String,
             cursor: String,
+            exact_phrase: String,
+            exclude_words: String,
+            from_user: String,
+            hashtags: String,
+            in_reply_to_tweet_id: String,
+            language: String,
+            max_faves: Integer,
+            max_quotes: Integer,
+            max_replies: Integer,
+            max_retweets: Integer,
+            media_type:
+              XTwitterScraper::X::TweetGetThreadParams::MediaType::OrSymbol,
+            mentioning: String,
+            min_bookmarks: Integer,
+            min_faves: Integer,
+            min_quotes: Integer,
+            min_replies: Integer,
+            min_retweets: Integer,
+            min_views: Integer,
             page_size: Integer,
+            quotes: XTwitterScraper::X::TweetGetThreadParams::Quotes::OrSymbol,
+            quotes_of_tweet_id: String,
+            replies:
+              XTwitterScraper::X::TweetGetThreadParams::Replies::OrSymbol,
+            retweets:
+              XTwitterScraper::X::TweetGetThreadParams::Retweets::OrSymbol,
+            retweets_of_tweet_id: String,
+            since_date: Date,
+            to_user: String,
+            until_date: Date,
+            url: String,
+            verified_only: T::Boolean,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
           id:,
+          # Words or quoted phrases where any one can match. Separate with spaces, commas,
+          # or lines.
+          any_words: nil,
+          # Only return tweets from Blue-verified authors.
+          blue_verified_only: nil,
+          # Cashtags separated by spaces, commas, or lines.
+          cashtags: nil,
+          # Conversation ID filter.
+          conversation_id: nil,
           # Pagination cursor for thread tweets
           cursor: nil,
+          # Exact phrase to match.
+          exact_phrase: nil,
+          # Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+          exclude_words: nil,
+          # Filter by author username.
+          from_user: nil,
+          # Hashtags separated by spaces, commas, or lines.
+          hashtags: nil,
+          # Only replies to this tweet ID.
+          in_reply_to_tweet_id: nil,
+          # Language code filter, e.g. en or tr.
+          language: nil,
+          # Maximum likes threshold. maxLikes is also accepted.
+          max_faves: nil,
+          # Maximum quotes threshold.
+          max_quotes: nil,
+          # Maximum replies threshold.
+          max_replies: nil,
+          # Maximum retweets threshold.
+          max_retweets: nil,
+          # Filter by media type.
+          media_type: nil,
+          # Filter tweets mentioning a username.
+          mentioning: nil,
+          # Minimum bookmark count threshold.
+          min_bookmarks: nil,
+          # Minimum likes threshold. minLikes is also accepted.
+          min_faves: nil,
+          # Minimum quote count threshold.
+          min_quotes: nil,
+          # Minimum replies threshold.
+          min_replies: nil,
+          # Minimum retweets threshold.
+          min_retweets: nil,
+          # Minimum view count threshold.
+          min_views: 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.
+          quotes: nil,
+          # Only quotes of this tweet ID.
+          quotes_of_tweet_id: nil,
+          # Reply mode.
+          replies: nil,
+          # Retweet mode.
+          retweets: nil,
+          # Only retweets of this tweet ID.
+          retweets_of_tweet_id: nil,
+          # Start date in YYYY-MM-DD format.
+          since_date: nil,
+          # Filter replies sent to a username.
+          to_user: nil,
+          # End date in YYYY-MM-DD format.
+          until_date: nil,
+          # URL substring or domain filter.
+          url: nil,
+          # Only return tweets from verified authors.
+          verified_only: nil,
           request_options: {}
         )
         end
@@ -62,14 +429,213 @@ module XTwitterScraper
           override.returns(
             {
               id: String,
+              any_words: String,
+              blue_verified_only: T::Boolean,
+              cashtags: String,
+              conversation_id: String,
               cursor: String,
+              exact_phrase: String,
+              exclude_words: String,
+              from_user: String,
+              hashtags: String,
+              in_reply_to_tweet_id: String,
+              language: String,
+              max_faves: Integer,
+              max_quotes: Integer,
+              max_replies: Integer,
+              max_retweets: Integer,
+              media_type:
+                XTwitterScraper::X::TweetGetThreadParams::MediaType::OrSymbol,
+              mentioning: String,
+              min_bookmarks: Integer,
+              min_faves: Integer,
+              min_quotes: Integer,
+              min_replies: Integer,
+              min_retweets: Integer,
+              min_views: Integer,
               page_size: Integer,
+              quotes:
+                XTwitterScraper::X::TweetGetThreadParams::Quotes::OrSymbol,
+              quotes_of_tweet_id: String,
+              replies:
+                XTwitterScraper::X::TweetGetThreadParams::Replies::OrSymbol,
+              retweets:
+                XTwitterScraper::X::TweetGetThreadParams::Retweets::OrSymbol,
+              retweets_of_tweet_id: String,
+              since_date: Date,
+              to_user: String,
+              until_date: Date,
+              url: String,
+              verified_only: T::Boolean,
               request_options: XTwitterScraper::RequestOptions
             }
           )
         end
         def to_hash
         end
+
+        # Filter by media type.
+        module MediaType
+          extend XTwitterScraper::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, XTwitterScraper::X::TweetGetThreadParams::MediaType)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          IMAGES =
+            T.let(
+              :images,
+              XTwitterScraper::X::TweetGetThreadParams::MediaType::TaggedSymbol
+            )
+          VIDEOS =
+            T.let(
+              :videos,
+              XTwitterScraper::X::TweetGetThreadParams::MediaType::TaggedSymbol
+            )
+          GIFS =
+            T.let(
+              :gifs,
+              XTwitterScraper::X::TweetGetThreadParams::MediaType::TaggedSymbol
+            )
+          MEDIA =
+            T.let(
+              :media,
+              XTwitterScraper::X::TweetGetThreadParams::MediaType::TaggedSymbol
+            )
+          LINKS =
+            T.let(
+              :links,
+              XTwitterScraper::X::TweetGetThreadParams::MediaType::TaggedSymbol
+            )
+          NONE =
+            T.let(
+              :none,
+              XTwitterScraper::X::TweetGetThreadParams::MediaType::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                XTwitterScraper::X::TweetGetThreadParams::MediaType::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        # Quote mode.
+        module Quotes
+          extend XTwitterScraper::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, XTwitterScraper::X::TweetGetThreadParams::Quotes)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          INCLUDE =
+            T.let(
+              :include,
+              XTwitterScraper::X::TweetGetThreadParams::Quotes::TaggedSymbol
+            )
+          EXCLUDE =
+            T.let(
+              :exclude,
+              XTwitterScraper::X::TweetGetThreadParams::Quotes::TaggedSymbol
+            )
+          ONLY =
+            T.let(
+              :only,
+              XTwitterScraper::X::TweetGetThreadParams::Quotes::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                XTwitterScraper::X::TweetGetThreadParams::Quotes::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        # Reply mode.
+        module Replies
+          extend XTwitterScraper::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, XTwitterScraper::X::TweetGetThreadParams::Replies)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          INCLUDE =
+            T.let(
+              :include,
+              XTwitterScraper::X::TweetGetThreadParams::Replies::TaggedSymbol
+            )
+          EXCLUDE =
+            T.let(
+              :exclude,
+              XTwitterScraper::X::TweetGetThreadParams::Replies::TaggedSymbol
+            )
+          ONLY =
+            T.let(
+              :only,
+              XTwitterScraper::X::TweetGetThreadParams::Replies::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                XTwitterScraper::X::TweetGetThreadParams::Replies::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        # Retweet mode.
+        module Retweets
+          extend XTwitterScraper::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, XTwitterScraper::X::TweetGetThreadParams::Retweets)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          INCLUDE =
+            T.let(
+              :include,
+              XTwitterScraper::X::TweetGetThreadParams::Retweets::TaggedSymbol
+            )
+          EXCLUDE =
+            T.let(
+              :exclude,
+              XTwitterScraper::X::TweetGetThreadParams::Retweets::TaggedSymbol
+            )
+          ONLY =
+            T.let(
+              :only,
+              XTwitterScraper::X::TweetGetThreadParams::Retweets::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                XTwitterScraper::X::TweetGetThreadParams::Retweets::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/x_twitter_scraper/models/x/tweet_search_params.rbi

@@ -220,7 +220,7 @@ module XTwitterScraper
         sig { params(min_bookmarks: Integer).void }
         attr_writer :min_bookmarks
 
-        # Minimum likes threshold.
+        # Minimum likes threshold. minLikes is also accepted.
         sig { returns(T.nilable(Integer)) }
         attr_reader :min_faves
 
@@ -597,7 +597,7 @@ module XTwitterScraper
           mentioning: nil,
           # Minimum bookmark count threshold.
           min_bookmarks: nil,
-          # Minimum likes threshold.
+          # Minimum likes threshold. minLikes is also accepted.
           min_faves: nil,
           # Minimum quote count threshold.
           min_quotes: nil,

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

@@ -188,7 +188,7 @@ module XTwitterScraper
         sig { params(min_bookmarks: Integer).void }
         attr_writer :min_bookmarks
 
-        # Minimum likes threshold.
+        # Minimum likes threshold. minLikes is also accepted.
         sig { returns(T.nilable(Integer)) }
         attr_reader :min_faves
 
@@ -494,7 +494,7 @@ module XTwitterScraper
           mentioning: nil,
           # Minimum bookmark count threshold.
           min_bookmarks: nil,
-          # Minimum likes threshold.
+          # Minimum likes threshold. minLikes is also accepted.
           min_faves: nil,
           # Minimum quote count threshold.
           min_quotes: nil,

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

@@ -188,7 +188,7 @@ module XTwitterScraper
         sig { params(min_bookmarks: Integer).void }
         attr_writer :min_bookmarks
 
-        # Minimum likes threshold.
+        # Minimum likes threshold. minLikes is also accepted.
         sig { returns(T.nilable(Integer)) }
         attr_reader :min_faves
 
@@ -494,7 +494,7 @@ module XTwitterScraper
           mentioning: nil,
           # Minimum bookmark count threshold.
           min_bookmarks: nil,
-          # Minimum likes threshold.
+          # Minimum likes threshold. minLikes is also accepted.
           min_faves: nil,
           # Minimum quote count threshold.
           min_quotes: nil,

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

@@ -188,7 +188,7 @@ module XTwitterScraper
         sig { params(min_bookmarks: Integer).void }
         attr_writer :min_bookmarks
 
-        # Minimum likes threshold.
+        # Minimum likes threshold. minLikes is also accepted.
         sig { returns(T.nilable(Integer)) }
         attr_reader :min_faves
 
@@ -510,7 +510,7 @@ module XTwitterScraper
           mentioning: nil,
           # Minimum bookmark count threshold.
           min_bookmarks: nil,
-          # Minimum likes threshold.
+          # Minimum likes threshold. minLikes is also accepted.
           min_faves: nil,
           # Minimum quote count threshold.
           min_quotes: nil,

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

@@ -196,7 +196,7 @@ module XTwitterScraper
         sig { params(min_bookmarks: Integer).void }
         attr_writer :min_bookmarks
 
-        # Minimum likes threshold.
+        # Minimum likes threshold. minLikes is also accepted.
         sig { returns(T.nilable(Integer)) }
         attr_reader :min_faves
 
@@ -505,7 +505,7 @@ module XTwitterScraper
           mentioning: nil,
           # Minimum bookmark count threshold.
           min_bookmarks: nil,
-          # Minimum likes threshold.
+          # Minimum likes threshold. minLikes is also accepted.
           min_faves: nil,
           # Minimum quote count threshold.
           min_quotes: nil,