x-twitter-scraper 0.4.2 → 0.4.4

data/lib/x_twitter_scraper/models/event_list_params.rb

@@ -7,11 +7,11 @@ 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 event_type
       #   Filter events by type
@@ -20,7 +20,10 @@ module XTwitterScraper
       optional :event_type, enum: -> { XTwitterScraper::EventType }
 
       # @!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
@@ -31,12 +34,15 @@ module XTwitterScraper
       #   @return [String, nil]
       optional :monitor_id, String
 
-      # @!method initialize(after: nil, event_type: nil, limit: nil, monitor_id: nil, request_options: {})
-      #   @param after [String] Cursor for keyset pagination
+      # @!method initialize(cursor: nil, event_type: nil, limit: nil, monitor_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {XTwitterScraper::Models::EventListParams} for more details.
+      #
+      #   @param cursor [String] Cursor for keyset pagination from prior response next_cursor
       #
       #   @param event_type [Symbol, XTwitterScraper::Models::EventType] Filter events by type
       #
-      #   @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 monitor_id [String] Filter events by monitor ID
       #

data/lib/x_twitter_scraper/models/event_type.rb

@@ -10,8 +10,23 @@ module XTwitterScraper
       TWEET_REPLY = :"tweet.reply"
       TWEET_RETWEET = :"tweet.retweet"
       TWEET_QUOTE = :"tweet.quote"
-      FOLLOWER_GAINED = :"follower.gained"
-      FOLLOWER_LOST = :"follower.lost"
+      TWEET_MEDIA = :"tweet.media"
+      TWEET_LINK = :"tweet.link"
+      TWEET_POLL = :"tweet.poll"
+      TWEET_MENTION = :"tweet.mention"
+      TWEET_HASHTAG = :"tweet.hashtag"
+      TWEET_LONGFORM = :"tweet.longform"
+      PROFILE_AVATAR_CHANGED = :"profile.avatar.changed"
+      PROFILE_BANNER_CHANGED = :"profile.banner.changed"
+      PROFILE_NAME_CHANGED = :"profile.name.changed"
+      PROFILE_USERNAME_CHANGED = :"profile.username.changed"
+      PROFILE_BIO_CHANGED = :"profile.bio.changed"
+      PROFILE_LOCATION_CHANGED = :"profile.location.changed"
+      PROFILE_URL_CHANGED = :"profile.url.changed"
+      PROFILE_VERIFIED_CHANGED = :"profile.verified.changed"
+      PROFILE_PROTECTED_CHANGED = :"profile.protected.changed"
+      PROFILE_PINNED_TWEET_CHANGED = :"profile.pinned_tweet.changed"
+      PROFILE_UNAVAILABLE_CHANGED = :"profile.unavailable.changed"
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/x_twitter_scraper/models/extraction_estimate_cost_params.rb

@@ -21,6 +21,32 @@ module XTwitterScraper
       #   @return [String, nil]
       optional :advanced_query, String, api_name: :advancedQuery
 
+      # @!attribute any_words
+      #   Alternative words or quoted phrases for estimated results. Separate with spaces,
+      #   commas, or lines.
+      #
+      #   @return [String, nil]
+      optional :any_words, String, api_name: :anyWords
+
+      # @!attribute bounding_box
+      #   Geo bounding box used for estimation, e.g. -74.1 40.6 -73.9 40.8
+      #   (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :bounding_box, String, api_name: :boundingBox
+
+      # @!attribute cashtags
+      #   Cashtags applied to the estimate, separated by spaces, commas, or lines.
+      #
+      #   @return [String, nil]
+      optional :cashtags, String
+
+      # @!attribute conversation_id
+      #   Conversation ID filter used for estimation (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :conversation_id, String, api_name: :conversationId
+
       # @!attribute exact_phrase
       #   Exact phrase filter for search estimation
       #
@@ -28,27 +54,163 @@ module XTwitterScraper
       optional :exact_phrase, String, api_name: :exactPhrase
 
       # @!attribute exclude_words
-      #   Words excluded from estimated search results
+      #   Words or quoted phrases excluded from estimated results. Separate with spaces,
+      #   commas, or lines.
       #
       #   @return [String, nil]
       optional :exclude_words, String, api_name: :excludeWords
 
+      # @!attribute from_user
+      #   Estimate only tweets from this author username (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :from_user, String, api_name: :fromUser
+
+      # @!attribute hashtags
+      #   Hashtags applied to the estimate, separated by spaces, commas, or lines.
+      #
+      #   @return [String, nil]
+      optional :hashtags, String
+
+      # @!attribute in_reply_to_tweet_id
+      #   Estimate only replies to this tweet ID (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :in_reply_to_tweet_id, String, api_name: :inReplyToTweetId
+
+      # @!attribute language
+      #   Language code used for estimate filtering (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :language, String
+
+      # @!attribute list_id
+      #   Estimate search results within this list ID (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :list_id, String, api_name: :listId
+
+      # @!attribute media_type
+      #   Media type used for estimate filtering (tweet_search_extractor)
+      #
+      #   @return [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::MediaType, nil]
+      optional :media_type,
+               enum: -> { XTwitterScraper::ExtractionEstimateCostParams::MediaType },
+               api_name: :mediaType
+
+      # @!attribute mentioning
+      #   Estimate tweets mentioning this username (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :mentioning, String
+
+      # @!attribute min_faves
+      #   Minimum likes threshold for estimated results (tweet_search_extractor)
+      #
+      #   @return [Integer, nil]
+      optional :min_faves, Integer, api_name: :minFaves
+
+      # @!attribute min_quotes
+      #   Minimum quote count threshold for estimated results (tweet_search_extractor)
+      #
+      #   @return [Integer, nil]
+      optional :min_quotes, Integer, api_name: :minQuotes
+
+      # @!attribute min_replies
+      #   Minimum replies threshold for estimated results (tweet_search_extractor)
+      #
+      #   @return [Integer, nil]
+      optional :min_replies, Integer, api_name: :minReplies
+
+      # @!attribute min_retweets
+      #   Minimum retweets threshold for estimated results (tweet_search_extractor)
+      #
+      #   @return [Integer, nil]
+      optional :min_retweets, Integer, api_name: :minRetweets
+
+      # @!attribute place
+      #   Estimate search results within this place ID (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :place, String
+
+      # @!attribute place_country
+      #   Estimate search results within this country code (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :place_country, String, api_name: :placeCountry
+
+      # @!attribute point_radius
+      #   Geo point radius used for estimation, e.g. -73.99 40.73 25mi
+      #   (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :point_radius, String, api_name: :pointRadius
+
+      # @!attribute quotes
+      #   Quote mode used for estimation (tweet_search_extractor)
+      #
+      #   @return [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::Quotes, nil]
+      optional :quotes, enum: -> { XTwitterScraper::ExtractionEstimateCostParams::Quotes }
+
+      # @!attribute quotes_of_tweet_id
+      #   Estimate only quotes of this tweet ID (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :quotes_of_tweet_id, String, api_name: :quotesOfTweetId
+
+      # @!attribute replies
+      #   Reply mode used for estimation (tweet_search_extractor)
+      #
+      #   @return [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::Replies, nil]
+      optional :replies, enum: -> { XTwitterScraper::ExtractionEstimateCostParams::Replies }
+
+      # @!attribute results_limit
+      #   Maximum number of results to estimate. When set, the estimate caps projected
+      #   results to this value.
+      #
+      #   @return [Integer, nil]
+      optional :results_limit, Integer, api_name: :resultsLimit
+
+      # @!attribute retweets
+      #   Retweet mode used for estimation (tweet_search_extractor)
+      #
+      #   @return [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::Retweets, nil]
+      optional :retweets, enum: -> { XTwitterScraper::ExtractionEstimateCostParams::Retweets }
+
+      # @!attribute retweets_of_tweet_id
+      #   Estimate only retweets of this tweet ID (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :retweets_of_tweet_id, String, api_name: :retweetsOfTweetId
+
       # @!attribute search_query
+      #   Required for tweet_search_extractor & community_search.
       #
       #   @return [String, nil]
       optional :search_query, String, api_name: :searchQuery
 
+      # @!attribute since_date
+      #   Estimate start date in YYYY-MM-DD format (tweet_search_extractor)
+      #
+      #   @return [Date, nil]
+      optional :since_date, Date, api_name: :sinceDate
+
       # @!attribute target_community_id
+      #   Required for community_post_extractor & community_search.
       #
       #   @return [String, nil]
       optional :target_community_id, String, api_name: :targetCommunityId
 
       # @!attribute target_list_id
+      #   Required for list_follower_explorer, list_member_extractor &
+      #   list_post_extractor.
       #
       #   @return [String, nil]
       optional :target_list_id, String, api_name: :targetListId
 
       # @!attribute target_space_id
+      #   Required for space_explorer.
       #
       #   @return [String, nil]
       optional :target_space_id, String, api_name: :targetSpaceId
@@ -63,27 +225,112 @@ module XTwitterScraper
       #   @return [String, nil]
       optional :target_username, String, api_name: :targetUsername
 
-      # @!method initialize(tool_type:, advanced_query: nil, exact_phrase: nil, exclude_words: nil, search_query: nil, target_community_id: nil, target_list_id: nil, target_space_id: nil, target_tweet_id: nil, target_username: nil, request_options: {})
+      # @!attribute to_user
+      #   Estimate replies sent to this username (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :to_user, String, api_name: :toUser
+
+      # @!attribute until_date
+      #   Estimate end date in YYYY-MM-DD format (tweet_search_extractor)
+      #
+      #   @return [Date, nil]
+      optional :until_date, Date, api_name: :untilDate
+
+      # @!attribute url
+      #   URL substring or domain filter used for estimation (tweet_search_extractor)
+      #
+      #   @return [String, nil]
+      optional :url, String
+
+      # @!attribute verified_only
+      #   Estimate only verified authors (tweet_search_extractor)
+      #
+      #   @return [Boolean, nil]
+      optional :verified_only, XTwitterScraper::Internal::Type::Boolean, api_name: :verifiedOnly
+
+      # @!method initialize(tool_type:, advanced_query: nil, any_words: nil, bounding_box: nil, cashtags: nil, conversation_id: nil, exact_phrase: nil, exclude_words: nil, from_user: nil, hashtags: nil, in_reply_to_tweet_id: nil, language: nil, list_id: nil, media_type: nil, mentioning: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, place: nil, place_country: nil, point_radius: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, results_limit: nil, retweets: nil, retweets_of_tweet_id: nil, search_query: nil, since_date: nil, target_community_id: nil, target_list_id: nil, target_space_id: nil, target_tweet_id: nil, target_username: nil, to_user: nil, until_date: nil, url: nil, verified_only: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {XTwitterScraper::Models::ExtractionEstimateCostParams} for more details.
+      #
       #   @param tool_type [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::ToolType] Identifier for the extraction tool used to run a job.
       #
       #   @param advanced_query [String] Raw advanced query string appended to the estimate (tweet_search_extractor)
       #
+      #   @param any_words [String] Alternative words or quoted phrases for estimated results. Separate with spaces,
+      #
+      #   @param bounding_box [String] Geo bounding box used for estimation, e.g. -74.1 40.6 -73.9 40.8 (tweet_search_e
+      #
+      #   @param cashtags [String] Cashtags applied to the estimate, separated by spaces, commas, or lines.
+      #
+      #   @param conversation_id [String] Conversation ID filter used for estimation (tweet_search_extractor)
+      #
       #   @param exact_phrase [String] Exact phrase filter for search estimation
       #
-      #   @param exclude_words [String] Words excluded from estimated search results
+      #   @param exclude_words [String] Words or quoted phrases excluded from estimated results. Separate with spaces, c
+      #
+      #   @param from_user [String] Estimate only tweets from this author username (tweet_search_extractor)
+      #
+      #   @param hashtags [String] Hashtags applied to the estimate, separated by spaces, commas, or lines.
+      #
+      #   @param in_reply_to_tweet_id [String] Estimate only replies to this tweet ID (tweet_search_extractor)
+      #
+      #   @param language [String] Language code used for estimate filtering (tweet_search_extractor)
+      #
+      #   @param list_id [String] Estimate search results within this list ID (tweet_search_extractor)
+      #
+      #   @param media_type [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::MediaType] Media type used for estimate filtering (tweet_search_extractor)
+      #
+      #   @param mentioning [String] Estimate tweets mentioning this username (tweet_search_extractor)
+      #
+      #   @param min_faves [Integer] Minimum likes threshold for estimated results (tweet_search_extractor)
+      #
+      #   @param min_quotes [Integer] Minimum quote count threshold for estimated results (tweet_search_extractor)
+      #
+      #   @param min_replies [Integer] Minimum replies threshold for estimated results (tweet_search_extractor)
+      #
+      #   @param min_retweets [Integer] Minimum retweets threshold for estimated results (tweet_search_extractor)
+      #
+      #   @param place [String] Estimate search results within this place ID (tweet_search_extractor)
+      #
+      #   @param place_country [String] Estimate search results within this country code (tweet_search_extractor)
+      #
+      #   @param point_radius [String] Geo point radius used for estimation, e.g. -73.99 40.73 25mi (tweet_search_extra
+      #
+      #   @param quotes [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::Quotes] Quote mode used for estimation (tweet_search_extractor)
+      #
+      #   @param quotes_of_tweet_id [String] Estimate only quotes of this tweet ID (tweet_search_extractor)
+      #
+      #   @param replies [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::Replies] Reply mode used for estimation (tweet_search_extractor)
+      #
+      #   @param results_limit [Integer] Maximum number of results to estimate. When set, the estimate caps projected res
+      #
+      #   @param retweets [Symbol, XTwitterScraper::Models::ExtractionEstimateCostParams::Retweets] Retweet mode used for estimation (tweet_search_extractor)
+      #
+      #   @param retweets_of_tweet_id [String] Estimate only retweets of this tweet ID (tweet_search_extractor)
       #
-      #   @param search_query [String]
+      #   @param search_query [String] Required for tweet_search_extractor & community_search.
       #
-      #   @param target_community_id [String]
+      #   @param since_date [Date] Estimate start date in YYYY-MM-DD format (tweet_search_extractor)
       #
-      #   @param target_list_id [String]
+      #   @param target_community_id [String] Required for community_post_extractor & community_search.
       #
-      #   @param target_space_id [String]
+      #   @param target_list_id [String] Required for list_follower_explorer, list_member_extractor & list_post_extractor
+      #
+      #   @param target_space_id [String] Required for space_explorer.
       #
       #   @param target_tweet_id [String]
       #
       #   @param target_username [String]
       #
+      #   @param to_user [String] Estimate replies sent to this username (tweet_search_extractor)
+      #
+      #   @param until_date [Date] Estimate end date in YYYY-MM-DD format (tweet_search_extractor)
+      #
+      #   @param url [String] URL substring or domain filter used for estimation (tweet_search_extractor)
+      #
+      #   @param verified_only [Boolean] Estimate only verified authors (tweet_search_extractor)
+      #
       #   @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}]
 
       # Identifier for the extraction tool used to run a job.
@@ -95,6 +342,7 @@ module XTwitterScraper
         COMMUNITY_MODERATOR_EXPLORER = :community_moderator_explorer
         COMMUNITY_POST_EXTRACTOR = :community_post_extractor
         COMMUNITY_SEARCH = :community_search
+        FAVORITERS = :favoriters
         FOLLOWER_EXPLORER = :follower_explorer
         FOLLOWING_EXPLORER = :following_explorer
         LIST_FOLLOWER_EXPLORER = :list_follower_explorer
@@ -109,11 +357,64 @@ module XTwitterScraper
         SPACE_EXPLORER = :space_explorer
         THREAD_EXTRACTOR = :thread_extractor
         TWEET_SEARCH_EXTRACTOR = :tweet_search_extractor
+        USER_LIKES = :user_likes
+        USER_MEDIA = :user_media
         VERIFIED_FOLLOWER_EXPLORER = :verified_follower_explorer
 
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      # Media type used for estimate filtering (tweet_search_extractor)
+      module MediaType
+        extend XTwitterScraper::Internal::Type::Enum
+
+        IMAGES = :images
+        VIDEOS = :videos
+        GIFS = :gifs
+        MEDIA = :media
+        LINKS = :links
+        NONE = :none
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Quote mode used for estimation (tweet_search_extractor)
+      module Quotes
+        extend XTwitterScraper::Internal::Type::Enum
+
+        INCLUDE = :include
+        EXCLUDE = :exclude
+        ONLY = :only
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Reply mode used for estimation (tweet_search_extractor)
+      module Replies
+        extend XTwitterScraper::Internal::Type::Enum
+
+        INCLUDE = :include
+        EXCLUDE = :exclude
+        ONLY = :only
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Retweet mode used for estimation (tweet_search_extractor)
+      module Retweets
+        extend XTwitterScraper::Internal::Type::Enum
+
+        INCLUDE = :include
+        EXCLUDE = :exclude
+        ONLY = :only
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/x_twitter_scraper/models/extraction_estimate_cost_response.rb

@@ -9,32 +9,56 @@ module XTwitterScraper
       #   @return [Boolean]
       required :allowed, XTwitterScraper::Internal::Type::Boolean
 
+      # @!attribute credits_available
+      #
+      #   @return [String]
+      required :credits_available, String, api_name: :creditsAvailable
+
+      # @!attribute credits_required
+      #
+      #   @return [String]
+      required :credits_required, String, api_name: :creditsRequired
+
       # @!attribute estimated_results
       #
       #   @return [Integer]
       required :estimated_results, Integer, api_name: :estimatedResults
 
-      # @!attribute projected_percent
-      #
-      #   @return [Float]
-      required :projected_percent, Float, api_name: :projectedPercent
-
       # @!attribute source
       #
-      #   @return [String]
-      required :source, String
+      #   @return [Symbol, XTwitterScraper::Models::ExtractionEstimateCostResponse::Source]
+      required :source, enum: -> { XTwitterScraper::Models::ExtractionEstimateCostResponse::Source }
 
-      # @!attribute usage_percent
+      # @!attribute resolved_x_user_id
       #
-      #   @return [Float]
-      required :usage_percent, Float, api_name: :usagePercent
+      #   @return [String, nil]
+      optional :resolved_x_user_id, String, api_name: :resolvedXUserId
 
-      # @!method initialize(allowed:, estimated_results:, projected_percent:, source:, usage_percent:)
+      # @!method initialize(allowed:, credits_available:, credits_required:, estimated_results:, source:, resolved_x_user_id: nil)
       #   @param allowed [Boolean]
+      #   @param credits_available [String]
+      #   @param credits_required [String]
       #   @param estimated_results [Integer]
-      #   @param projected_percent [Float]
-      #   @param source [String]
-      #   @param usage_percent [Float]
+      #   @param source [Symbol, XTwitterScraper::Models::ExtractionEstimateCostResponse::Source]
+      #   @param resolved_x_user_id [String]
+
+      # @see XTwitterScraper::Models::ExtractionEstimateCostResponse#source
+      module Source
+        extend XTwitterScraper::Internal::Type::Enum
+
+        FOLLOWERS = :followers
+        FOLLOWING = :following
+        PAGINATION_CAP = :paginationCap
+        POSTS = :posts
+        QUOTE_COUNT = :quoteCount
+        REPLY_COUNT = :replyCount
+        RESULTS_LIMIT = :resultsLimit
+        RETWEET_COUNT = :retweetCount
+        UNKNOWN = :unknown
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/x_twitter_scraper/models/extraction_export_results_params.rb

@@ -15,10 +15,10 @@ module XTwitterScraper
       # @!attribute format_
       #   Export file format
       #
-      #   @return [Symbol, XTwitterScraper::Models::ExtractionExportResultsParams::Format, nil]
-      optional :format_, enum: -> { XTwitterScraper::ExtractionExportResultsParams::Format }
+      #   @return [Symbol, XTwitterScraper::Models::ExtractionExportResultsParams::Format]
+      required :format_, enum: -> { XTwitterScraper::ExtractionExportResultsParams::Format }
 
-      # @!method initialize(id:, format_: nil, request_options: {})
+      # @!method initialize(id:, format_:, request_options: {})
       #   @param id [String]
       #
       #   @param format_ [Symbol, XTwitterScraper::Models::ExtractionExportResultsParams::Format] Export file format

data/lib/x_twitter_scraper/models/extraction_job.rb

@@ -72,6 +72,7 @@ module XTwitterScraper
         COMMUNITY_MODERATOR_EXPLORER = :community_moderator_explorer
         COMMUNITY_POST_EXTRACTOR = :community_post_extractor
         COMMUNITY_SEARCH = :community_search
+        FAVORITERS = :favoriters
         FOLLOWER_EXPLORER = :follower_explorer
         FOLLOWING_EXPLORER = :following_explorer
         LIST_FOLLOWER_EXPLORER = :list_follower_explorer
@@ -86,6 +87,8 @@ module XTwitterScraper
         SPACE_EXPLORER = :space_explorer
         THREAD_EXTRACTOR = :thread_extractor
         TWEET_SEARCH_EXTRACTOR = :tweet_search_extractor
+        USER_LIKES = :user_likes
+        USER_MEDIA = :user_media
         VERIFIED_FOLLOWER_EXPLORER = :verified_follower_explorer
 
         # @!method self.values

data/lib/x_twitter_scraper/models/extraction_list_params.rb

@@ -7,14 +7,17 @@ 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
@@ -31,10 +34,13 @@ module XTwitterScraper
       #   @return [Symbol, XTwitterScraper::Models::ExtractionListParams::ToolType, nil]
       optional :tool_type, enum: -> { XTwitterScraper::ExtractionListParams::ToolType }
 
-      # @!method initialize(after: nil, limit: nil, status: nil, tool_type: nil, request_options: {})
-      #   @param after [String] Cursor for keyset pagination
+      # @!method initialize(cursor: nil, limit: nil, status: nil, tool_type: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {XTwitterScraper::Models::ExtractionListParams} 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 status [Symbol, XTwitterScraper::Models::ExtractionListParams::Status] Filter by job status
       #
@@ -63,6 +69,7 @@ module XTwitterScraper
         COMMUNITY_MODERATOR_EXPLORER = :community_moderator_explorer
         COMMUNITY_POST_EXTRACTOR = :community_post_extractor
         COMMUNITY_SEARCH = :community_search
+        FAVORITERS = :favoriters
         FOLLOWER_EXPLORER = :follower_explorer
         FOLLOWING_EXPLORER = :following_explorer
         LIST_FOLLOWER_EXPLORER = :list_follower_explorer
@@ -77,6 +84,8 @@ module XTwitterScraper
         SPACE_EXPLORER = :space_explorer
         THREAD_EXTRACTOR = :thread_extractor
         TWEET_SEARCH_EXTRACTOR = :tweet_search_extractor
+        USER_LIKES = :user_likes
+        USER_MEDIA = :user_media
         VERIFIED_FOLLOWER_EXPLORER = :verified_follower_explorer
 
         # @!method self.values

data/lib/x_twitter_scraper/models/extraction_retrieve_params.rb

@@ -12,11 +12,11 @@ module XTwitterScraper
       #   @return [String]
       required :id, String
 
-      # @!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 results to return (1-1000, default 100)
@@ -24,10 +24,10 @@ module XTwitterScraper
       #   @return [Integer, nil]
       optional :limit, Integer
 
-      # @!method initialize(id:, after: nil, limit: nil, request_options: {})
+      # @!method initialize(id:, cursor: nil, limit: nil, request_options: {})
       #   @param id [String]
       #
-      #   @param after [String] Cursor for keyset pagination
+      #   @param cursor [String] Cursor for keyset pagination from prior response next_cursor
       #
       #   @param limit [Integer] Maximum number of results to return (1-1000, default 100)
       #

data/lib/x_twitter_scraper/models/extraction_retrieve_response.rb

@@ -10,7 +10,7 @@ module XTwitterScraper
       required :has_more, XTwitterScraper::Internal::Type::Boolean, api_name: :hasMore
 
       # @!attribute job
-      #   Extraction job metadata — shape varies by tool type (JSON)
+      #   Extraction job metadata - shape varies by tool type (JSON)
       #
       #   @return [Hash{Symbol=>Object}]
       required :job, XTwitterScraper::Internal::Type::HashOf[XTwitterScraper::Internal::Type::Unknown]
@@ -29,7 +29,7 @@ module XTwitterScraper
       # @!method initialize(has_more:, job:, results:, next_cursor: nil)
       #   @param has_more [Boolean]
       #
-      #   @param job [Hash{Symbol=>Object}] Extraction job metadata — shape varies by tool type (JSON)
+      #   @param job [Hash{Symbol=>Object}] Extraction job metadata - shape varies by tool type (JSON)
       #
       #   @param results [Array<Hash{Symbol=>Object}>]
       #