x-twitter-scraper 0.7.2 → 0.9.0

data/lib/x_twitter_scraper/version.rb

@@ -5,5 +5,5 @@
 # frozen_string_literal: true
 
 module XTwitterScraper
-  VERSION = "0.7.2"
+  VERSION = "0.9.0"
 end

data/lib/x_twitter_scraper.rb

@@ -58,6 +58,7 @@ require_relative "x_twitter_scraper/internal/transport/pooled_net_requester"
 require_relative "x_twitter_scraper/client"
 require_relative "x_twitter_scraper/models/user_profile"
 require_relative "x_twitter_scraper/models/paginated_tweets"
+require_relative "x_twitter_scraper/models/paginated_users"
 require_relative "x_twitter_scraper/models/account_retrieve_params"
 require_relative "x_twitter_scraper/models/account_retrieve_response"
 require_relative "x_twitter_scraper/models/account_set_x_username_params"
@@ -135,7 +136,6 @@ require_relative "x_twitter_scraper/models/monitors/keyword_retrieve_response"
 require_relative "x_twitter_scraper/models/monitors/keyword_update_params"
 require_relative "x_twitter_scraper/models/monitors/keyword_update_response"
 require_relative "x_twitter_scraper/models/monitor_update_params"
-require_relative "x_twitter_scraper/models/paginated_users"
 require_relative "x_twitter_scraper/models/radar_item"
 require_relative "x_twitter_scraper/models/radar_retrieve_trending_topics_params"
 require_relative "x_twitter_scraper/models/radar_retrieve_trending_topics_response"
@@ -154,6 +154,7 @@ require_relative "x_twitter_scraper/models/style_retrieve_params"
 require_relative "x_twitter_scraper/models/style_update_params"
 require_relative "x_twitter_scraper/models/subscribe_create_params"
 require_relative "x_twitter_scraper/models/subscribe_create_response"
+require_relative "x_twitter_scraper/models/support/attachment_download_params"
 require_relative "x_twitter_scraper/models/support/ticket_create_params"
 require_relative "x_twitter_scraper/models/support/ticket_create_response"
 require_relative "x_twitter_scraper/models/support/ticket_list_params"
@@ -258,13 +259,16 @@ require_relative "x_twitter_scraper/models/x/tweets/retweet_create_response"
 require_relative "x_twitter_scraper/models/x/tweets/retweet_delete_params"
 require_relative "x_twitter_scraper/models/x/tweets/retweet_delete_response"
 require_relative "x_twitter_scraper/models/x/tweet_search_params"
+require_relative "x_twitter_scraper/models/x/tweet_search_response"
 require_relative "x_twitter_scraper/models/x/user_remove_follower_params"
 require_relative "x_twitter_scraper/models/x/user_remove_follower_response"
 require_relative "x_twitter_scraper/models/x/user_retrieve_batch_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_batch_response"
 require_relative "x_twitter_scraper/models/x/user_retrieve_followers_params"
+require_relative "x_twitter_scraper/models/x/user_retrieve_followers_response"
 require_relative "x_twitter_scraper/models/x/user_retrieve_followers_you_know_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_following_params"
+require_relative "x_twitter_scraper/models/x/user_retrieve_following_response"
 require_relative "x_twitter_scraper/models/x/user_retrieve_likes_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_media_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_mentions_params"
@@ -273,6 +277,7 @@ require_relative "x_twitter_scraper/models/x/user_retrieve_replies_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_search_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_tweets_params"
 require_relative "x_twitter_scraper/models/x/user_retrieve_verified_followers_params"
+require_relative "x_twitter_scraper/models/x/user_retrieve_verified_followers_response"
 require_relative "x_twitter_scraper/models/x/users/follow_create_params"
 require_relative "x_twitter_scraper/models/x/users/follow_create_response"
 require_relative "x_twitter_scraper/models/x/users/follow_delete_all_params"
@@ -303,6 +308,7 @@ require_relative "x_twitter_scraper/resources/radar"
 require_relative "x_twitter_scraper/resources/styles"
 require_relative "x_twitter_scraper/resources/subscribe"
 require_relative "x_twitter_scraper/resources/support"
+require_relative "x_twitter_scraper/resources/support/attachments"
 require_relative "x_twitter_scraper/resources/support/tickets"
 require_relative "x_twitter_scraper/resources/trends"
 require_relative "x_twitter_scraper/resources/webhooks"

data/rbi/x_twitter_scraper/models/credit_topup_balance_response.rbi

@@ -15,12 +15,12 @@ module XTwitterScraper
           )
         end
 
-      # Stable first-party Xquik redirect URL for the active Stripe Checkout session.
+      # Stable Xquik redirect URL for the active checkout.
       sig { returns(String) }
       attr_accessor :redirect_url
 
-      # Same stable first-party Xquik redirect URL as redirect_url. The response never
-      # exposes a raw Stripe Checkout URL.
+      # Same stable Xquik redirect URL as redirect_url. The response never exposes the
+      # hosted checkout URL.
       sig { returns(String) }
       attr_accessor :url
 
@@ -28,10 +28,10 @@ module XTwitterScraper
         params(redirect_url: String, url: String).returns(T.attached_class)
       end
       def self.new(
-        # Stable first-party Xquik redirect URL for the active Stripe Checkout session.
+        # Stable Xquik redirect URL for the active checkout.
         redirect_url:,
-        # Same stable first-party Xquik redirect URL as redirect_url. The response never
-        # exposes a raw Stripe Checkout URL.
+        # Same stable Xquik redirect URL as redirect_url. The response never exposes the
+        # hosted checkout URL.
         url:
       )
       end

data/rbi/x_twitter_scraper/models/draw_export_params.rbi

@@ -21,7 +21,8 @@ module XTwitterScraper
       sig { returns(String) }
       attr_accessor :id
 
-      # Export output format
+      # Export output format. PDF entry exports include up to 10,000 rows. Other entry
+      # formats include up to 100,000 rows.
       sig { returns(XTwitterScraper::DrawExportParams::Format::OrSymbol) }
       attr_accessor :format_
 
@@ -46,7 +47,8 @@ module XTwitterScraper
       end
       def self.new(
         id:,
-        # Export output format
+        # Export output format. PDF entry exports include up to 10,000 rows. Other entry
+        # formats include up to 100,000 rows.
         format_:,
         # Export winners or all entries
         type: nil,
@@ -67,7 +69,8 @@ module XTwitterScraper
       def to_hash
       end
 
-      # Export output format
+      # Export output format. PDF entry exports include up to 10,000 rows. Other entry
+      # formats include up to 100,000 rows.
       module Format
         extend XTwitterScraper::Internal::Type::Enum
 

data/rbi/x_twitter_scraper/models/draw_list_params.rbi

@@ -18,7 +18,7 @@ module XTwitterScraper
           )
         end
 
-      # Cursor for keyset pagination from prior response next_cursor
+      # Previous nextCursor.
       sig { returns(T.nilable(String)) }
       attr_reader :cursor
 
@@ -43,7 +43,7 @@ module XTwitterScraper
         ).returns(T.attached_class)
       end
       def self.new(
-        # Cursor for keyset pagination from prior response next_cursor
+        # Previous nextCursor.
         cursor: nil,
         # Maximum number of items to return (1-100, default 50). For paid per-result
         # endpoints, the returned count may be lower when remaining credits cannot cover

data/rbi/x_twitter_scraper/models/error.rbi

@@ -252,6 +252,11 @@ module XTwitterScraper
               :monitor_already_exists,
               XTwitterScraper::Error::Error::LegacyErrorCode::TaggedSymbol
             )
+          MONITOR_PROFILE_UNAVAILABLE =
+            T.let(
+              :monitor_profile_unavailable,
+              XTwitterScraper::Error::Error::LegacyErrorCode::TaggedSymbol
+            )
           NO_MEDIA =
             T.let(
               :no_media,
@@ -337,6 +342,16 @@ module XTwitterScraper
               :connection_challenge_inactive,
               XTwitterScraper::Error::Error::LegacyErrorCode::TaggedSymbol
             )
+          COVERAGE_CURSOR_GONE =
+            T.let(
+              :coverage_cursor_gone,
+              XTwitterScraper::Error::Error::LegacyErrorCode::TaggedSymbol
+            )
+          COVERAGE_CURSOR_UNAVAILABLE =
+            T.let(
+              :coverage_cursor_unavailable,
+              XTwitterScraper::Error::Error::LegacyErrorCode::TaggedSymbol
+            )
           DRAFT_NOT_FOUND =
             T.let(
               :draft_not_found,
@@ -382,6 +397,11 @@ module XTwitterScraper
               :invalid_community_id,
               XTwitterScraper::Error::Error::LegacyErrorCode::TaggedSymbol
             )
+          INVALID_COVERAGE_CURSOR =
+            T.let(
+              :invalid_coverage_cursor,
+              XTwitterScraper::Error::Error::LegacyErrorCode::TaggedSymbol
+            )
           INVALID_IDEMPOTENCY_KEY =
             T.let(
               :invalid_idempotency_key,
@@ -823,6 +843,11 @@ module XTwitterScraper
                 :monitor_already_exists,
                 XTwitterScraper::Error::Error::StructuredError::Code::TaggedSymbol
               )
+            MONITOR_PROFILE_UNAVAILABLE =
+              T.let(
+                :monitor_profile_unavailable,
+                XTwitterScraper::Error::Error::StructuredError::Code::TaggedSymbol
+              )
             NO_MEDIA =
               T.let(
                 :no_media,
@@ -908,6 +933,16 @@ module XTwitterScraper
                 :connection_challenge_inactive,
                 XTwitterScraper::Error::Error::StructuredError::Code::TaggedSymbol
               )
+            COVERAGE_CURSOR_GONE =
+              T.let(
+                :coverage_cursor_gone,
+                XTwitterScraper::Error::Error::StructuredError::Code::TaggedSymbol
+              )
+            COVERAGE_CURSOR_UNAVAILABLE =
+              T.let(
+                :coverage_cursor_unavailable,
+                XTwitterScraper::Error::Error::StructuredError::Code::TaggedSymbol
+              )
             DRAFT_NOT_FOUND =
               T.let(
                 :draft_not_found,
@@ -953,6 +988,11 @@ module XTwitterScraper
                 :invalid_community_id,
                 XTwitterScraper::Error::Error::StructuredError::Code::TaggedSymbol
               )
+            INVALID_COVERAGE_CURSOR =
+              T.let(
+                :invalid_coverage_cursor,
+                XTwitterScraper::Error::Error::StructuredError::Code::TaggedSymbol
+              )
             INVALID_IDEMPOTENCY_KEY =
               T.let(
                 :invalid_idempotency_key,

data/rbi/x_twitter_scraper/models/event_list_params.rbi

@@ -18,7 +18,7 @@ module XTwitterScraper
           )
         end
 
-      # Cursor for keyset pagination from prior response next_cursor
+      # Previous nextCursor.
       sig { returns(T.nilable(String)) }
       attr_reader :cursor
 
@@ -32,6 +32,13 @@ module XTwitterScraper
       sig { params(event_type: XTwitterScraper::EventType::OrSymbol).void }
       attr_writer :event_type
 
+      # Keyword monitor ID.
+      sig { returns(T.nilable(String)) }
+      attr_reader :keyword_monitor_id
+
+      sig { params(keyword_monitor_id: String).void }
+      attr_writer :keyword_monitor_id
+
       # Maximum number of items to return (1-100, default 50). For paid per-result
       # endpoints, the returned count may be lower when remaining credits cannot cover
       # the requested page. If zero paid results are affordable, the endpoint returns
@@ -42,7 +49,7 @@ module XTwitterScraper
       sig { params(limit: Integer).void }
       attr_writer :limit
 
-      # Filter events by monitor ID
+      # Account monitor ID.
       sig { returns(T.nilable(String)) }
       attr_reader :monitor_id
 
@@ -53,22 +60,25 @@ module XTwitterScraper
         params(
           cursor: String,
           event_type: XTwitterScraper::EventType::OrSymbol,
+          keyword_monitor_id: String,
           limit: Integer,
           monitor_id: String,
           request_options: XTwitterScraper::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
-        # Cursor for keyset pagination from prior response next_cursor
+        # Previous nextCursor.
         cursor: nil,
         # Filter events by type
         event_type: nil,
+        # Keyword monitor ID.
+        keyword_monitor_id: nil,
         # Maximum number of items to return (1-100, default 50). For paid per-result
         # endpoints, the returned count may be lower when remaining credits cannot cover
         # the requested page. If zero paid results are affordable, the endpoint returns
         # 402 insufficient_credits.
         limit: nil,
-        # Filter events by monitor ID
+        # Account monitor ID.
         monitor_id: nil,
         request_options: {}
       )
@@ -79,6 +89,7 @@ module XTwitterScraper
           {
             cursor: String,
             event_type: XTwitterScraper::EventType::OrSymbol,
+            keyword_monitor_id: String,
             limit: Integer,
             monitor_id: String,
             request_options: XTwitterScraper::RequestOptions