x-twitter-scraper 0.4.2 → 0.4.4

data/lib/x_twitter_scraper/models/account_retrieve_response.rb

@@ -4,7 +4,18 @@ module XTwitterScraper
   module Models
     # @see XTwitterScraper::Resources::Account#retrieve
     class AccountRetrieveResponse < XTwitterScraper::Internal::Type::BaseModel
+      # @!attribute monitor_billing
+      #
+      #   @return [XTwitterScraper::Models::AccountRetrieveResponse::MonitorBilling]
+      required :monitor_billing,
+               -> { XTwitterScraper::Models::AccountRetrieveResponse::MonitorBilling },
+               api_name: :monitorBilling
+
       # @!attribute monitors_allowed
+      #   @deprecated Monitor slots are unlimited. Use monitorBilling.unlimitedSlots instead.
+      #
+      #   Deprecated. Monitor slots are unlimited, so this is always
+      #   Number.MAX_SAFE_INTEGER.
       #
       #   @return [Integer]
       required :monitors_allowed, Integer, api_name: :monitorsAllowed
@@ -19,18 +30,94 @@ module XTwitterScraper
       #   @return [Symbol, XTwitterScraper::Models::AccountRetrieveResponse::Plan]
       required :plan, enum: -> { XTwitterScraper::Models::AccountRetrieveResponse::Plan }
 
-      # @!attribute current_period
+      # @!attribute credit_info
       #
-      #   @return [XTwitterScraper::Models::AccountRetrieveResponse::CurrentPeriod, nil]
-      optional :current_period,
-               -> { XTwitterScraper::Models::AccountRetrieveResponse::CurrentPeriod },
-               api_name: :currentPeriod
+      #   @return [XTwitterScraper::Models::AccountRetrieveResponse::CreditInfo, nil]
+      optional :credit_info,
+               -> { XTwitterScraper::Models::AccountRetrieveResponse::CreditInfo },
+               api_name: :creditInfo
 
-      # @!method initialize(monitors_allowed:, monitors_used:, plan:, current_period: nil)
-      #   @param monitors_allowed [Integer]
+      # @!attribute x_username
+      #   Linked X username, omitted when no X account is connected.
+      #
+      #   @return [String, nil]
+      optional :x_username, String, api_name: :xUsername
+
+      # @!method initialize(monitor_billing:, monitors_allowed:, monitors_used:, plan:, credit_info: nil, x_username: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {XTwitterScraper::Models::AccountRetrieveResponse} for more details.
+      #
+      #   @param monitor_billing [XTwitterScraper::Models::AccountRetrieveResponse::MonitorBilling]
+      #
+      #   @param monitors_allowed [Integer] Deprecated. Monitor slots are unlimited, so this is always Number.MAX_SAFE_INTEG
+      #
       #   @param monitors_used [Integer]
+      #
       #   @param plan [Symbol, XTwitterScraper::Models::AccountRetrieveResponse::Plan]
-      #   @param current_period [XTwitterScraper::Models::AccountRetrieveResponse::CurrentPeriod]
+      #
+      #   @param credit_info [XTwitterScraper::Models::AccountRetrieveResponse::CreditInfo]
+      #
+      #   @param x_username [String] Linked X username, omitted when no X account is connected.
+
+      # @see XTwitterScraper::Models::AccountRetrieveResponse#monitor_billing
+      class MonitorBilling < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute active_daily_estimate
+        #   Estimated daily credits for currently active monitors.
+        #
+        #   @return [String]
+        required :active_daily_estimate, String, api_name: :activeDailyEstimate
+
+        # @!attribute active_hourly_burn
+        #   Credits charged each hour for currently active monitors.
+        #
+        #   @return [String]
+        required :active_hourly_burn, String, api_name: :activeHourlyBurn
+
+        # @!attribute credits_per_active_monitor_day
+        #   Estimated daily credits for 1 active instant monitor.
+        #
+        #   @return [String]
+        required :credits_per_active_monitor_day, String, api_name: :creditsPerActiveMonitorDay
+
+        # @!attribute credits_per_active_monitor_hour
+        #   Hourly credits charged for 1 active instant monitor.
+        #
+        #   @return [String]
+        required :credits_per_active_monitor_hour, String, api_name: :creditsPerActiveMonitorHour
+
+        # @!attribute events_included
+        #   Webhook and event deliveries are included in monitor billing.
+        #
+        #   @return [Boolean]
+        required :events_included, XTwitterScraper::Internal::Type::Boolean, api_name: :eventsIncluded
+
+        # @!attribute instant_check_interval_seconds
+        #   Active monitors check every 1 second.
+        #
+        #   @return [Integer]
+        required :instant_check_interval_seconds, Integer, api_name: :instantCheckIntervalSeconds
+
+        # @!attribute unlimited_slots
+        #   Monitor slot count is unlimited.
+        #
+        #   @return [Boolean]
+        required :unlimited_slots, XTwitterScraper::Internal::Type::Boolean, api_name: :unlimitedSlots
+
+        # @!method initialize(active_daily_estimate:, active_hourly_burn:, credits_per_active_monitor_day:, credits_per_active_monitor_hour:, events_included:, instant_check_interval_seconds:, unlimited_slots:)
+        #   @param active_daily_estimate [String] Estimated daily credits for currently active monitors.
+        #
+        #   @param active_hourly_burn [String] Credits charged each hour for currently active monitors.
+        #
+        #   @param credits_per_active_monitor_day [String] Estimated daily credits for 1 active instant monitor.
+        #
+        #   @param credits_per_active_monitor_hour [String] Hourly credits charged for 1 active instant monitor.
+        #
+        #   @param events_included [Boolean] Webhook and event deliveries are included in monitor billing.
+        #
+        #   @param instant_check_interval_seconds [Integer] Active monitors check every 1 second.
+        #
+        #   @param unlimited_slots [Boolean] Monitor slot count is unlimited.
+      end
 
       # @see XTwitterScraper::Models::AccountRetrieveResponse#plan
       module Plan
@@ -43,27 +130,55 @@ module XTwitterScraper
         #   @return [Array<Symbol>]
       end
 
-      # @see XTwitterScraper::Models::AccountRetrieveResponse#current_period
-      class CurrentPeriod < XTwitterScraper::Internal::Type::BaseModel
-        # @!attribute end_
+      # @see XTwitterScraper::Models::AccountRetrieveResponse#credit_info
+      class CreditInfo < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute auto_topup_amount_dollars
+        #   Dollar amount charged when automatic top-up runs.
         #
-        #   @return [Time]
-        required :end_, Time, api_name: :end
+        #   @return [Float]
+        required :auto_topup_amount_dollars, Float, api_name: :autoTopupAmountDollars
 
-        # @!attribute start
+        # @!attribute auto_topup_enabled
         #
-        #   @return [Time]
-        required :start, Time
+        #   @return [Boolean]
+        required :auto_topup_enabled, XTwitterScraper::Internal::Type::Boolean, api_name: :autoTopupEnabled
 
-        # @!attribute usage_percent
+        # @!attribute auto_topup_threshold
+        #   Bigint string threshold that triggers automatic top-up when enabled.
         #
-        #   @return [Float]
-        required :usage_percent, Float, api_name: :usagePercent
+        #   @return [String]
+        required :auto_topup_threshold, String, api_name: :autoTopupThreshold
 
-        # @!method initialize(end_:, start:, usage_percent:)
-        #   @param end_ [Time]
-        #   @param start [Time]
-        #   @param usage_percent [Float]
+        # @!attribute balance
+        #   Bigint string to preserve precision above Number.MAX_SAFE_INTEGER.
+        #
+        #   @return [String]
+        required :balance, String
+
+        # @!attribute lifetime_purchased
+        #   Total purchased credits as a bigint string.
+        #
+        #   @return [String]
+        required :lifetime_purchased, String, api_name: :lifetimePurchased
+
+        # @!attribute lifetime_used
+        #   Total consumed credits as a bigint string.
+        #
+        #   @return [String]
+        required :lifetime_used, String, api_name: :lifetimeUsed
+
+        # @!method initialize(auto_topup_amount_dollars:, auto_topup_enabled:, auto_topup_threshold:, balance:, lifetime_purchased:, lifetime_used:)
+        #   @param auto_topup_amount_dollars [Float] Dollar amount charged when automatic top-up runs.
+        #
+        #   @param auto_topup_enabled [Boolean]
+        #
+        #   @param auto_topup_threshold [String] Bigint string threshold that triggers automatic top-up when enabled.
+        #
+        #   @param balance [String] Bigint string to preserve precision above Number.MAX_SAFE_INTEGER.
+        #
+        #   @param lifetime_purchased [String] Total purchased credits as a bigint string.
+        #
+        #   @param lifetime_used [String] Total consumed credits as a bigint string.
       end
     end
   end

data/lib/x_twitter_scraper/models/content_disclosure.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module XTwitterScraper
+  module Models
+    class ContentDisclosure < XTwitterScraper::Internal::Type::BaseModel
+      # @!attribute advertising
+      #
+      #   @return [XTwitterScraper::Models::ContentDisclosure::Advertising, nil]
+      optional :advertising, -> { XTwitterScraper::ContentDisclosure::Advertising }
+
+      # @!attribute ai_generated
+      #
+      #   @return [XTwitterScraper::Models::ContentDisclosure::AIGenerated, nil]
+      optional :ai_generated, -> { XTwitterScraper::ContentDisclosure::AIGenerated }, api_name: :aiGenerated
+
+      # @!method initialize(advertising: nil, ai_generated: nil)
+      #   Content disclosure metadata shown by X when a tweet is labeled as paid
+      #   partnership content or AI-generated media.
+      #
+      #   @param advertising [XTwitterScraper::Models::ContentDisclosure::Advertising]
+      #   @param ai_generated [XTwitterScraper::Models::ContentDisclosure::AIGenerated]
+
+      # @see XTwitterScraper::Models::ContentDisclosure#advertising
+      class Advertising < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute is_paid_promotion
+        #   True when X labels the tweet as paid promotion content.
+        #
+        #   @return [Boolean, nil]
+        optional :is_paid_promotion, XTwitterScraper::Internal::Type::Boolean, api_name: :isPaidPromotion
+
+        # @!method initialize(is_paid_promotion: nil)
+        #   @param is_paid_promotion [Boolean] True when X labels the tweet as paid promotion content.
+      end
+
+      # @see XTwitterScraper::Models::ContentDisclosure#ai_generated
+      class AIGenerated < XTwitterScraper::Internal::Type::BaseModel
+        # @!attribute can_edit
+        #   Whether the disclosure can be edited on X.
+        #
+        #   @return [Boolean, nil]
+        optional :can_edit, XTwitterScraper::Internal::Type::Boolean, api_name: :canEdit
+
+        # @!attribute detection_source
+        #   Source of the AI-generated media disclosure.
+        #
+        #   @return [String, nil]
+        optional :detection_source, String, api_name: :detectionSource
+
+        # @!attribute has_ai_generated_media
+        #   True when X labels the tweet as containing AI-generated media.
+        #
+        #   @return [Boolean, nil]
+        optional :has_ai_generated_media,
+                 XTwitterScraper::Internal::Type::Boolean,
+                 api_name: :hasAiGeneratedMedia
+
+        # @!method initialize(can_edit: nil, detection_source: nil, has_ai_generated_media: nil)
+        #   @param can_edit [Boolean] Whether the disclosure can be edited on X.
+        #
+        #   @param detection_source [String] Source of the AI-generated media disclosure.
+        #
+        #   @param has_ai_generated_media [Boolean] True when X labels the tweet as containing AI-generated media.
+      end
+    end
+  end
+end

data/lib/x_twitter_scraper/models/credit_redirect_topup_checkout_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module XTwitterScraper
+  module Models
+    # @see XTwitterScraper::Resources::Credits#redirect_topup_checkout
+    class CreditRedirectTopupCheckoutParams < XTwitterScraper::Internal::Type::BaseModel
+      extend XTwitterScraper::Internal::Type::RequestParameters::Converter
+      include XTwitterScraper::Internal::Type::RequestParameters
+
+      # @!attribute session_id
+      #   Billing session ID returned by the top-up billing flow.
+      #
+      #   @return [String]
+      required :session_id, String
+
+      # @!method initialize(session_id:, request_options: {})
+      #   @param session_id [String] Billing session ID returned by the top-up billing flow.
+      #
+      #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/x_twitter_scraper/models/credit_retrieve_balance_response.rb

@@ -4,31 +4,58 @@ module XTwitterScraper
   module Models
     # @see XTwitterScraper::Resources::Credits#retrieve_balance
     class CreditRetrieveBalanceResponse < XTwitterScraper::Internal::Type::BaseModel
+      # @!attribute auto_topup_amount_dollars
+      #   Configured dollar amount for each automatic top-up.
+      #
+      #   @return [Float]
+      required :auto_topup_amount_dollars, Float
+
       # @!attribute auto_topup_enabled
       #
       #   @return [Boolean]
       required :auto_topup_enabled, XTwitterScraper::Internal::Type::Boolean
 
+      # @!attribute auto_topup_threshold
+      #   Credit balance threshold that triggers automatic top-up when enabled,
+      #   represented as a bigint string.
+      #
+      #   @return [String]
+      required :auto_topup_threshold, String
+
       # @!attribute balance
+      #   Current credit balance as a bigint string to preserve precision above
+      #   Number.MAX_SAFE_INTEGER.
       #
-      #   @return [Integer]
-      required :balance, Integer
+      #   @return [String]
+      required :balance, String
 
       # @!attribute lifetime_purchased
+      #   Lifetime purchased credits as a bigint string.
       #
-      #   @return [Integer]
-      required :lifetime_purchased, Integer
+      #   @return [String]
+      required :lifetime_purchased, String
 
       # @!attribute lifetime_used
+      #   Lifetime consumed credits as a bigint string.
       #
-      #   @return [Integer]
-      required :lifetime_used, Integer
+      #   @return [String]
+      required :lifetime_used, String
 
-      # @!method initialize(auto_topup_enabled:, balance:, lifetime_purchased:, lifetime_used:)
+      # @!method initialize(auto_topup_amount_dollars:, auto_topup_enabled:, auto_topup_threshold:, balance:, lifetime_purchased:, lifetime_used:)
+      #   Some parameter documentations has been truncated, see
+      #   {XTwitterScraper::Models::CreditRetrieveBalanceResponse} for more details.
+      #
+      #   @param auto_topup_amount_dollars [Float] Configured dollar amount for each automatic top-up.
+      #
       #   @param auto_topup_enabled [Boolean]
-      #   @param balance [Integer]
-      #   @param lifetime_purchased [Integer]
-      #   @param lifetime_used [Integer]
+      #
+      #   @param auto_topup_threshold [String] Credit balance threshold that triggers automatic top-up when enabled, represente
+      #
+      #   @param balance [String] Current credit balance as a bigint string to preserve precision above Number.MAX
+      #
+      #   @param lifetime_purchased [String] Lifetime purchased credits as a bigint string.
+      #
+      #   @param lifetime_used [String] Lifetime consumed credits as a bigint string.
     end
   end
 end

data/lib/x_twitter_scraper/models/credit_retrieve_topup_status_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module XTwitterScraper
+  module Models
+    # @see XTwitterScraper::Resources::Credits#retrieve_topup_status
+    class CreditRetrieveTopupStatusParams < XTwitterScraper::Internal::Type::BaseModel
+      extend XTwitterScraper::Internal::Type::RequestParameters::Converter
+      include XTwitterScraper::Internal::Type::RequestParameters
+
+      # @!attribute session_id
+      #   Billing session ID returned by the top-up billing flow.
+      #
+      #   @return [String]
+      required :session_id, String
+
+      # @!method initialize(session_id:, request_options: {})
+      #   @param session_id [String] Billing session ID returned by the top-up billing flow.
+      #
+      #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/x_twitter_scraper/models/credit_retrieve_topup_status_response.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module XTwitterScraper
+  module Models
+    # @see XTwitterScraper::Resources::Credits#retrieve_topup_status
+    class CreditRetrieveTopupStatusResponse < XTwitterScraper::Internal::Type::BaseModel
+      # @!attribute status
+      #
+      #   @return [Symbol, XTwitterScraper::Models::CreditRetrieveTopupStatusResponse::Status]
+      required :status, enum: -> { XTwitterScraper::Models::CreditRetrieveTopupStatusResponse::Status }
+
+      # @!attribute amount_dollars
+      #   Dollar amount requested for the top-up.
+      #
+      #   @return [Integer, nil]
+      optional :amount_dollars, Integer, nil?: true
+
+      # @!attribute credits
+      #   Bigint string credit amount granted or pending.
+      #
+      #   @return [String, nil]
+      optional :credits, String
+
+      # @!method initialize(status:, amount_dollars: nil, credits: nil)
+      #   @param status [Symbol, XTwitterScraper::Models::CreditRetrieveTopupStatusResponse::Status]
+      #
+      #   @param amount_dollars [Integer, nil] Dollar amount requested for the top-up.
+      #
+      #   @param credits [String] Bigint string credit amount granted or pending.
+
+      # @see XTwitterScraper::Models::CreditRetrieveTopupStatusResponse#status
+      module Status
+        extend XTwitterScraper::Internal::Type::Enum
+
+        PAID = :paid
+        PROCESSING = :processing
+        FAILED = :failed
+        EXPIRED = :expired
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/x_twitter_scraper/models/credit_topup_balance_params.rb

@@ -7,14 +7,22 @@ module XTwitterScraper
       extend XTwitterScraper::Internal::Type::RequestParameters::Converter
       include XTwitterScraper::Internal::Type::RequestParameters
 
-      # @!attribute amount
-      #   Amount to top up in credits
+      # @!attribute dollars
+      #   Amount to top up in US dollars. Minimum 10.
       #
       #   @return [Integer]
-      required :amount, Integer
+      required :dollars, Integer
 
-      # @!method initialize(amount:, request_options: {})
-      #   @param amount [Integer] Amount to top up in credits
+      # @!attribute locale
+      #   Optional checkout locale. Defaults to en.
+      #
+      #   @return [String, nil]
+      optional :locale, String
+
+      # @!method initialize(dollars:, locale: nil, request_options: {})
+      #   @param dollars [Integer] Amount to top up in US dollars. Minimum 10.
+      #
+      #   @param locale [String] Optional checkout locale. Defaults to en.
       #
       #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/x_twitter_scraper/models/credit_topup_balance_response.rb

@@ -4,13 +4,26 @@ module XTwitterScraper
   module Models
     # @see XTwitterScraper::Resources::Credits#topup_balance
     class CreditTopupBalanceResponse < XTwitterScraper::Internal::Type::BaseModel
-      # @!attribute success
+      # @!attribute redirect_url
+      #   Stable first-party Xquik redirect URL for the active Stripe Checkout session.
       #
-      #   @return [Boolean, true]
-      required :success, const: true
+      #   @return [String]
+      required :redirect_url, String
 
-      # @!method initialize(success: true)
-      #   @param success [Boolean, true]
+      # @!attribute url
+      #   Same stable first-party Xquik redirect URL as redirect_url. The response never
+      #   exposes a raw Stripe Checkout URL.
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(redirect_url:, url:)
+      #   Some parameter documentations has been truncated, see
+      #   {XTwitterScraper::Models::CreditTopupBalanceResponse} for more details.
+      #
+      #   @param redirect_url [String] Stable first-party Xquik redirect URL for the active Stripe Checkout session.
+      #
+      #   @param url [String] Same stable first-party Xquik redirect URL as redirect_url. The response never e
     end
   end
 end

data/lib/x_twitter_scraper/models/draft_list_params.rb

@@ -14,15 +14,21 @@ module XTwitterScraper
       optional :after_cursor, String
 
       # @!attribute limit
-      #   Maximum number of items to return (1-100, default 50)
+      #   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.
       #
       #   @return [Integer, nil]
       optional :limit, Integer
 
       # @!method initialize(after_cursor: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {XTwitterScraper::Models::DraftListParams} for more details.
+      #
       #   @param after_cursor [String] Cursor for pagination
       #
-      #   @param limit [Integer] Maximum number of items to return (1-100, default 50)
+      #   @param limit [Integer] Maximum number of items to return (1-100, default 50). For paid per-result endpo
       #
       #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/x_twitter_scraper/models/draw_detail.rb

@@ -4,6 +4,7 @@ module XTwitterScraper
   module Models
     class DrawDetail < XTwitterScraper::Internal::Type::BaseModel
       # @!attribute id
+      #   Draw public ID.
       #
       #   @return [String]
       required :id, String
@@ -76,19 +77,32 @@ module XTwitterScraper
       # @!method initialize(id:, created_at:, status:, total_entries:, tweet_author_username:, tweet_id:, tweet_like_count:, tweet_quote_count:, tweet_reply_count:, tweet_retweet_count:, tweet_text:, tweet_url:, valid_entries:, drawn_at: nil)
       #   Full giveaway draw with tweet metrics, entries, and timing.
       #
-      #   @param id [String]
+      #   @param id [String] Draw public ID.
+      #
       #   @param created_at [Time]
+      #
       #   @param status [String]
+      #
       #   @param total_entries [Integer]
+      #
       #   @param tweet_author_username [String]
+      #
       #   @param tweet_id [String]
+      #
       #   @param tweet_like_count [Integer]
+      #
       #   @param tweet_quote_count [Integer]
+      #
       #   @param tweet_reply_count [Integer]
+      #
       #   @param tweet_retweet_count [Integer]
+      #
       #   @param tweet_text [String]
+      #
       #   @param tweet_url [String]
+      #
       #   @param valid_entries [Integer]
+      #
       #   @param drawn_at [Time]
     end
   end

data/lib/x_twitter_scraper/models/draw_export_params.rb

@@ -15,8 +15,8 @@ module XTwitterScraper
       # @!attribute format_
       #   Export output format
       #
-      #   @return [Symbol, XTwitterScraper::Models::DrawExportParams::Format, nil]
-      optional :format_, enum: -> { XTwitterScraper::DrawExportParams::Format }
+      #   @return [Symbol, XTwitterScraper::Models::DrawExportParams::Format]
+      required :format_, enum: -> { XTwitterScraper::DrawExportParams::Format }
 
       # @!attribute type
       #   Export winners or all entries
@@ -24,7 +24,7 @@ module XTwitterScraper
       #   @return [Symbol, XTwitterScraper::Models::DrawExportParams::Type, nil]
       optional :type, enum: -> { XTwitterScraper::DrawExportParams::Type }
 
-      # @!method initialize(id:, format_: nil, type: nil, request_options: {})
+      # @!method initialize(id:, format_:, type: nil, request_options: {})
       #   @param id [String]
       #
       #   @param format_ [Symbol, XTwitterScraper::Models::DrawExportParams::Format] Export output format

data/lib/x_twitter_scraper/models/draw_list_item.rb

@@ -4,6 +4,7 @@ module XTwitterScraper
   module Models
     class DrawListItem < XTwitterScraper::Internal::Type::BaseModel
       # @!attribute id
+      #   Draw public ID for detail responses.
       #
       #   @return [String]
       required :id, String
@@ -41,12 +42,18 @@ module XTwitterScraper
       # @!method initialize(id:, created_at:, status:, total_entries:, tweet_url:, valid_entries:, drawn_at: nil)
       #   Giveaway draw summary with entry counts and status.
       #
-      #   @param id [String]
+      #   @param id [String] Draw public ID for detail responses.
+      #
       #   @param created_at [Time]
+      #
       #   @param status [String]
+      #
       #   @param total_entries [Integer]
+      #
       #   @param tweet_url [String]
+      #
       #   @param valid_entries [Integer]
+      #
       #   @param drawn_at [Time]
     end
   end

data/lib/x_twitter_scraper/models/draw_list_params.rb

@@ -7,22 +7,28 @@ module XTwitterScraper
       extend XTwitterScraper::Internal::Type::RequestParameters::Converter
       include XTwitterScraper::Internal::Type::RequestParameters
 
-      # @!attribute after
-      #   Cursor for keyset pagination
+      # @!attribute cursor
+      #   Cursor for keyset pagination from prior response next_cursor
       #
       #   @return [String, nil]
-      optional :after, String
+      optional :cursor, String
 
       # @!attribute limit
-      #   Maximum number of items to return (1-100, default 50)
+      #   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.
       #
       #   @return [Integer, nil]
       optional :limit, Integer
 
-      # @!method initialize(after: nil, limit: nil, request_options: {})
-      #   @param after [String] Cursor for keyset pagination
+      # @!method initialize(cursor: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {XTwitterScraper::Models::DrawListParams} for more details.
       #
-      #   @param limit [Integer] Maximum number of items to return (1-100, default 50)
+      #   @param cursor [String] Cursor for keyset pagination from prior response next_cursor
+      #
+      #   @param limit [Integer] Maximum number of items to return (1-100, default 50). For paid per-result endpo
       #
       #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
     end