x-twitter-scraper 0.4.2 → 0.4.4

data/rbi/x_twitter_scraper/models/x/list_retrieve_followers_params.rbi

@@ -25,10 +25,21 @@ module XTwitterScraper
         sig { params(cursor: String).void }
         attr_writer :cursor
 
+        # Maximum user profiles requested from this page (20-200, default 200). The
+        # response can contain fewer profiles because the source returned fewer or
+        # remaining credits cover fewer results. Keep requesting next_cursor while
+        # has_next_page is true. The deprecated limit and count aliases remain accepted.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :page_size
+
+        sig { params(page_size: Integer).void }
+        attr_writer :page_size
+
         sig do
           params(
             id: String,
             cursor: String,
+            page_size: Integer,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -36,6 +47,11 @@ module XTwitterScraper
           id:,
           # Pagination cursor for list followers
           cursor: nil,
+          # Maximum user profiles requested from this page (20-200, default 200). The
+          # response can contain fewer profiles because the source returned fewer or
+          # remaining credits cover fewer results. Keep requesting next_cursor while
+          # has_next_page is true. The deprecated limit and count aliases remain accepted.
+          page_size: nil,
           request_options: {}
         )
         end
@@ -45,6 +61,7 @@ module XTwitterScraper
             {
               id: String,
               cursor: String,
+              page_size: Integer,
               request_options: XTwitterScraper::RequestOptions
             }
           )

data/rbi/x_twitter_scraper/models/x/list_retrieve_members_params.rbi

@@ -25,10 +25,18 @@ module XTwitterScraper
         sig { params(cursor: String).void }
         attr_writer :cursor
 
+        # Members per page (20-200, default 20)
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :page_size
+
+        sig { params(page_size: Integer).void }
+        attr_writer :page_size
+
         sig do
           params(
             id: String,
             cursor: String,
+            page_size: Integer,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
@@ -36,6 +44,8 @@ module XTwitterScraper
           id:,
           # Pagination cursor for list members
           cursor: nil,
+          # Members per page (20-200, default 20)
+          page_size: nil,
           request_options: {}
         )
         end
@@ -45,6 +55,7 @@ module XTwitterScraper
             {
               id: String,
               cursor: String,
+              page_size: Integer,
               request_options: XTwitterScraper::RequestOptions
             }
           )

data/rbi/x_twitter_scraper/models/x/list_retrieve_tweets_params.rbi

@@ -32,6 +32,17 @@ module XTwitterScraper
         sig { params(include_replies: T::Boolean).void }
         attr_writer :include_replies
 
+        # 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
+        # aliases remain accepted.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :page_size
+
+        sig { params(page_size: Integer).void }
+        attr_writer :page_size
+
         # Unix timestamp - filter after
         sig { returns(T.nilable(String)) }
         attr_reader :since_time
@@ -51,6 +62,7 @@ module XTwitterScraper
             id: String,
             cursor: String,
             include_replies: T::Boolean,
+            page_size: Integer,
             since_time: String,
             until_time: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
@@ -62,6 +74,12 @@ 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
+          # aliases remain accepted.
+          page_size: nil,
           # Unix timestamp - filter after
           since_time: nil,
           # Unix timestamp - filter before
@@ -76,6 +94,7 @@ module XTwitterScraper
               id: String,
               cursor: String,
               include_replies: T::Boolean,
+              page_size: Integer,
               since_time: String,
               until_time: String,
               request_options: XTwitterScraper::RequestOptions

data/rbi/x_twitter_scraper/models/x/media_download_params.rbi

@@ -15,7 +15,14 @@ module XTwitterScraper
             )
           end
 
-        # Array of tweet URLs or IDs (bulk, max 50)
+        # Numeric tweet ID alias for tweetInput
+        sig { returns(T.nilable(String)) }
+        attr_reader :tweet_id
+
+        sig { params(tweet_id: String).void }
+        attr_writer :tweet_id
+
+        # Array of tweet URLs or IDs (bulk, max 50 string items)
         sig { returns(T.nilable(T::Array[String])) }
         attr_reader :tweet_ids
 
@@ -29,18 +36,31 @@ module XTwitterScraper
         sig { params(tweet_input: String).void }
         attr_writer :tweet_input
 
+        # Tweet URL alias for tweetInput
+        sig { returns(T.nilable(String)) }
+        attr_reader :tweet_url
+
+        sig { params(tweet_url: String).void }
+        attr_writer :tweet_url
+
         sig do
           params(
+            tweet_id: String,
             tweet_ids: T::Array[String],
             tweet_input: String,
+            tweet_url: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
-          # Array of tweet URLs or IDs (bulk, max 50)
+          # Numeric tweet ID alias for tweetInput
+          tweet_id: nil,
+          # Array of tweet URLs or IDs (bulk, max 50 string items)
           tweet_ids: nil,
           # Tweet URL or ID (single tweet)
           tweet_input: nil,
+          # Tweet URL alias for tweetInput
+          tweet_url: nil,
           request_options: {}
         )
         end
@@ -48,8 +68,10 @@ module XTwitterScraper
         sig do
           override.returns(
             {
+              tweet_id: String,
               tweet_ids: T::Array[String],
               tweet_input: String,
+              tweet_url: String,
               request_options: XTwitterScraper::RequestOptions
             }
           )

data/rbi/x_twitter_scraper/models/x/media_upload_params.rbi

@@ -15,34 +15,26 @@ module XTwitterScraper
             )
           end
 
-        # X account (@username or ID) uploading media
+        # X account (@username or ID) uploading media from URL
         sig { returns(String) }
         attr_accessor :account
 
-        # Media file to upload
-        sig { returns(XTwitterScraper::Internal::FileInput) }
-        attr_accessor :file
-
-        sig { returns(T.nilable(T::Boolean)) }
-        attr_reader :is_long_video
-
-        sig { params(is_long_video: T::Boolean).void }
-        attr_writer :is_long_video
+        # HTTPS URL to download and upload as media
+        sig { returns(String) }
+        attr_accessor :url
 
         sig do
           params(
             account: String,
-            file: XTwitterScraper::Internal::FileInput,
-            is_long_video: T::Boolean,
+            url: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
-          # X account (@username or ID) uploading media
+          # X account (@username or ID) uploading media from URL
           account:,
-          # Media file to upload
-          file:,
-          is_long_video: nil,
+          # HTTPS URL to download and upload as media
+          url:,
           request_options: {}
         )
         end
@@ -51,8 +43,7 @@ module XTwitterScraper
           override.returns(
             {
               account: String,
-              file: XTwitterScraper::Internal::FileInput,
-              is_long_video: T::Boolean,
+              url: String,
               request_options: XTwitterScraper::RequestOptions
             }
           )

data/rbi/x_twitter_scraper/models/x/media_upload_response.rbi

@@ -15,18 +15,33 @@ module XTwitterScraper
         sig { returns(String) }
         attr_accessor :media_id
 
+        # Public media URL for tweet `media` arrays.
+        sig { returns(String) }
+        attr_accessor :media_url
+
         sig { returns(T::Boolean) }
         attr_accessor :success
 
         sig do
-          params(media_id: String, success: T::Boolean).returns(
-            T.attached_class
-          )
+          params(
+            media_id: String,
+            media_url: String,
+            success: T::Boolean
+          ).returns(T.attached_class)
         end
-        def self.new(media_id:, success: true)
+        def self.new(
+          media_id:,
+          # Public media URL for tweet `media` arrays.
+          media_url:,
+          success: true
+        )
         end
 
-        sig { override.returns({ media_id: String, success: T::Boolean }) }
+        sig do
+          override.returns(
+            { media_id: String, media_url: String, success: T::Boolean }
+          )
+        end
         def to_hash
         end
       end

data/rbi/x_twitter_scraper/models/x/profile_update_avatar_params.rbi

@@ -15,26 +15,26 @@ module XTwitterScraper
             )
           end
 
-        # X account (@username or ID) for avatar update
+        # X account (@username or ID) receiving avatar from URL
         sig { returns(String) }
         attr_accessor :account
 
-        # Avatar image (max 716KB)
-        sig { returns(XTwitterScraper::Internal::FileInput) }
-        attr_accessor :file
+        # HTTPS URL to the avatar image to download
+        sig { returns(String) }
+        attr_accessor :url
 
         sig do
           params(
             account: String,
-            file: XTwitterScraper::Internal::FileInput,
+            url: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
-          # X account (@username or ID) for avatar update
+          # X account (@username or ID) receiving avatar from URL
           account:,
-          # Avatar image (max 716KB)
-          file:,
+          # HTTPS URL to the avatar image to download
+          url:,
           request_options: {}
         )
         end
@@ -43,7 +43,7 @@ module XTwitterScraper
           override.returns(
             {
               account: String,
-              file: XTwitterScraper::Internal::FileInput,
+              url: String,
               request_options: XTwitterScraper::RequestOptions
             }
           )

data/rbi/x_twitter_scraper/models/x/profile_update_banner_params.rbi

@@ -15,26 +15,26 @@ module XTwitterScraper
             )
           end
 
-        # X account (@username or ID) for banner update
+        # X account (@username or ID) receiving banner from URL
         sig { returns(String) }
         attr_accessor :account
 
-        # Banner image (max 2MB)
-        sig { returns(XTwitterScraper::Internal::FileInput) }
-        attr_accessor :file
+        # HTTPS URL to the banner image to download
+        sig { returns(String) }
+        attr_accessor :url
 
         sig do
           params(
             account: String,
-            file: XTwitterScraper::Internal::FileInput,
+            url: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
-          # X account (@username or ID) for banner update
+          # X account (@username or ID) receiving banner from URL
           account:,
-          # Banner image (max 2MB)
-          file:,
+          # HTTPS URL to the banner image to download
+          url:,
           request_options: {}
         )
         end
@@ -43,7 +43,7 @@ module XTwitterScraper
           override.returns(
             {
               account: String,
-              file: XTwitterScraper::Internal::FileInput,
+              url: String,
               request_options: XTwitterScraper::RequestOptions
             }
           )

data/rbi/x_twitter_scraper/models/x/tweet_author.rbi

@@ -3,7 +3,7 @@
 module XTwitterScraper
   module Models
     module X
-      class TweetAuthor < XTwitterScraper::Internal::Type::BaseModel
+      class TweetAuthor < XTwitterScraper::Models::UserProfile
         OrHash =
           T.type_alias do
             T.any(
@@ -12,54 +12,23 @@ module XTwitterScraper
             )
           end
 
-        sig { returns(String) }
-        attr_accessor :id
-
         sig { returns(Integer) }
         attr_accessor :followers
 
-        sig { returns(String) }
-        attr_accessor :username
-
         sig { returns(T::Boolean) }
         attr_accessor :verified
 
-        sig { returns(T.nilable(String)) }
-        attr_reader :profile_picture
-
-        sig { params(profile_picture: String).void }
-        attr_writer :profile_picture
-
-        # Author of a tweet with follower count and verification status.
+        # Tweet author profile. The lookup route always includes follower count and
+        # verification state. Other profile fields appear when available.
         sig do
-          params(
-            id: String,
-            followers: Integer,
-            username: String,
-            verified: T::Boolean,
-            profile_picture: String
-          ).returns(T.attached_class)
+          params(followers: Integer, verified: T::Boolean).returns(
+            T.attached_class
+          )
         end
-        def self.new(
-          id:,
-          followers:,
-          username:,
-          verified:,
-          profile_picture: nil
-        )
+        def self.new(followers:, verified:)
         end
 
-        sig do
-          override.returns(
-            {
-              id: String,
-              followers: Integer,
-              username: String,
-              verified: T::Boolean,
-              profile_picture: String
-            }
-          )
-        end
+        sig { override.returns({ followers: Integer, verified: T::Boolean }) }
         def to_hash
         end
       end

data/rbi/x_twitter_scraper/models/x/tweet_create_params.rbi

@@ -19,9 +19,6 @@ module XTwitterScraper
         sig { returns(String) }
         attr_accessor :account
 
-        sig { returns(String) }
-        attr_accessor :text
-
         sig { returns(T.nilable(String)) }
         attr_reader :attachment_url
 
@@ -40,11 +37,14 @@ module XTwitterScraper
         sig { params(is_note_tweet: T::Boolean).void }
         attr_writer :is_note_tweet
 
+        # Array of public media URLs to attach. Supports up to 4 images or exactly 1 MP4
+        # video up to 100 MB. Each URL must be publicly reachable. Attached media adds 2
+        # credits per started MB across all files.
         sig { returns(T.nilable(T::Array[String])) }
-        attr_reader :media_ids
+        attr_reader :media
 
-        sig { params(media_ids: T::Array[String]).void }
-        attr_writer :media_ids
+        sig { params(media: T::Array[String]).void }
+        attr_writer :media
 
         sig { returns(T.nilable(String)) }
         attr_reader :reply_to_tweet_id
@@ -52,27 +52,38 @@ module XTwitterScraper
         sig { params(reply_to_tweet_id: String).void }
         attr_writer :reply_to_tweet_id
 
+        # Tweet text (optional when media is provided)
+        sig { returns(T.nilable(String)) }
+        attr_reader :text
+
+        sig { params(text: String).void }
+        attr_writer :text
+
         sig do
           params(
             account: String,
-            text: String,
             attachment_url: String,
             community_id: String,
             is_note_tweet: T::Boolean,
-            media_ids: T::Array[String],
+            media: T::Array[String],
             reply_to_tweet_id: String,
+            text: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
           # X account (@username or account ID)
           account:,
-          text:,
           attachment_url: nil,
           community_id: nil,
           is_note_tweet: nil,
-          media_ids: nil,
+          # Array of public media URLs to attach. Supports up to 4 images or exactly 1 MP4
+          # video up to 100 MB. Each URL must be publicly reachable. Attached media adds 2
+          # credits per started MB across all files.
+          media: nil,
           reply_to_tweet_id: nil,
+          # Tweet text (optional when media is provided)
+          text: nil,
           request_options: {}
         )
         end
@@ -81,12 +92,12 @@ module XTwitterScraper
           override.returns(
             {
               account: String,
-              text: String,
               attachment_url: String,
               community_id: String,
               is_note_tweet: T::Boolean,
-              media_ids: T::Array[String],
+              media: T::Array[String],
               reply_to_tweet_id: String,
+              text: String,
               request_options: XTwitterScraper::RequestOptions
             }
           )

data/rbi/x_twitter_scraper/models/x/tweet_create_response.rbi

@@ -12,21 +12,57 @@ module XTwitterScraper
             )
           end
 
+        sig { returns(T::Boolean) }
+        attr_accessor :charged
+
+        # Credits charged for this tweet. Text-only tweets and replies cost 30 credits;
+        # attached media adds 2 credits per started MB.
+        sig { returns(String) }
+        attr_accessor :charged_credits
+
         sig { returns(T::Boolean) }
         attr_accessor :success
 
         sig { returns(String) }
         attr_accessor :tweet_id
 
+        sig { returns(T.nilable(String)) }
+        attr_reader :write_action_id
+
+        sig { params(write_action_id: String).void }
+        attr_writer :write_action_id
+
         sig do
-          params(tweet_id: String, success: T::Boolean).returns(
-            T.attached_class
-          )
+          params(
+            charged: T::Boolean,
+            charged_credits: String,
+            tweet_id: String,
+            write_action_id: String,
+            success: T::Boolean
+          ).returns(T.attached_class)
         end
-        def self.new(tweet_id:, success: true)
+        def self.new(
+          charged:,
+          # Credits charged for this tweet. Text-only tweets and replies cost 30 credits;
+          # attached media adds 2 credits per started MB.
+          charged_credits:,
+          tweet_id:,
+          write_action_id: nil,
+          success: true
+        )
         end
 
-        sig { override.returns({ success: T::Boolean, tweet_id: String }) }
+        sig do
+          override.returns(
+            {
+              charged: T::Boolean,
+              charged_credits: String,
+              success: T::Boolean,
+              tweet_id: String,
+              write_action_id: String
+            }
+          )
+        end
         def to_hash
         end
       end