x-twitter-scraper 0.7.2 → 0.9.0

data/lib/x_twitter_scraper/resources/x/users.rb

@@ -94,21 +94,51 @@ module XTwitterScraper
         #
         # List followers of a user
         #
-        # @overload retrieve_followers(id, after: nil, cursor: nil, limit: nil, page_size: nil, request_options: {})
+        # @overload retrieve_followers(id, after: nil, bio_contains: nil, cursor: nil, has_location: nil, has_website: nil, limit: nil, location_contains: nil, max_followers: nil, max_following: nil, max_statuses: nil, min_account_age_days: nil, min_followers: nil, min_following: nil, min_statuses: nil, mode: nil, page_size: nil, username_contains: nil, verified_only: nil, verified_type: nil, request_options: {})
         #
         # @param id [String] Target user ID or username for follower lookup.
         #
         # @param after [String] Legacy cursor alias. Prefer cursor.
         #
-        # @param cursor [String] Pagination cursor for followers list
+        # @param bio_contains [String] Match any comma-separated or line-separated bio term, ignoring case.
         #
-        # @param limit [Integer] Legacy integer page size alias for following lists. Prefer pageSize.
+        # @param cursor [String] Cursor from the previous response. Xquik cursors resume automatic coverage. Exis
         #
-        # @param page_size [Integer] Maximum user profiles requested from this page (20-200, default 200). The respon
+        # @param has_location [Boolean] Only return profiles with a location.
+        #
+        # @param has_website [Boolean] Only return profiles with a website.
+        #
+        # @param limit [Integer] Legacy page-size alias outside explicit coverage mode. Coverage accepts 1-10000.
+        #
+        # @param location_contains [String] Match a location substring, ignoring case.
+        #
+        # @param max_followers [Integer] Maximum follower count. Missing counts pass this maximum.
+        #
+        # @param max_following [Integer] Maximum following count.
+        #
+        # @param max_statuses [Integer] Maximum post count. maxPosts is also accepted.
+        #
+        # @param min_account_age_days [Integer] Minimum account age in whole days.
+        #
+        # @param min_followers [Integer] Minimum follower count. Filtering happens before billing.
+        #
+        # @param min_following [Integer] Minimum following count.
+        #
+        # @param min_statuses [Integer] Minimum post count. minPosts is also accepted.
+        #
+        # @param mode [Symbol, XTwitterScraper::Models::X::UserRetrieveFollowersParams::Mode] Omit mode for resumable maximum coverage. Standard keeps legacy pagination. Cove
+        #
+        # @param page_size [Integer] Maximum user profiles: automatic 300; standard 200. Sources return fewer profile
+        #
+        # @param username_contains [String] Match a username substring, ignoring case.
+        #
+        # @param verified_only [Boolean] Only return verified profiles.
+        #
+        # @param verified_type [String] Match the verification type exactly, ignoring case.
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [XTwitterScraper::Models::PaginatedUsers]
+        # @return [XTwitterScraper::Models::PaginatedUsers, XTwitterScraper::Models::X::UserRetrieveFollowersResponse::UserListCoverageResponse]
         #
         # @see XTwitterScraper::Models::X::UserRetrieveFollowersParams
         def retrieve_followers(id, params = {})
@@ -117,8 +147,24 @@ module XTwitterScraper
           @client.request(
             method: :get,
             path: ["x/users/%1$s/followers", id],
-            query: query.transform_keys(page_size: "pageSize"),
-            model: XTwitterScraper::PaginatedUsers,
+            query: query.transform_keys(
+              bio_contains: "bioContains",
+              has_location: "hasLocation",
+              has_website: "hasWebsite",
+              location_contains: "locationContains",
+              max_followers: "maxFollowers",
+              max_following: "maxFollowing",
+              max_statuses: "maxStatuses",
+              min_account_age_days: "minAccountAgeDays",
+              min_followers: "minFollowers",
+              min_following: "minFollowing",
+              min_statuses: "minStatuses",
+              page_size: "pageSize",
+              username_contains: "usernameContains",
+              verified_only: "verifiedOnly",
+              verified_type: "verifiedType"
+            ),
+            model: XTwitterScraper::Models::X::UserRetrieveFollowersResponse,
             options: options
           )
         end
@@ -129,13 +175,41 @@ module XTwitterScraper
         #
         # List mutual followers between you and a user
         #
-        # @overload retrieve_followers_you_know(id, cursor: nil, page_size: nil, request_options: {})
+        # @overload retrieve_followers_you_know(id, bio_contains: nil, cursor: nil, has_location: nil, has_website: nil, location_contains: nil, max_followers: nil, max_following: nil, max_statuses: nil, min_account_age_days: nil, min_followers: nil, min_following: nil, min_statuses: nil, page_size: nil, username_contains: nil, verified_only: nil, verified_type: nil, request_options: {})
         #
         # @param id [String] User ID for followers-you-know lookup
         #
+        # @param bio_contains [String] Match any comma-separated or line-separated bio term, ignoring case.
+        #
         # @param cursor [String] Pagination cursor for followers-you-know
         #
-        # @param page_size [Integer] Maximum user profiles requested from this page (20-200, default 200). The respon
+        # @param has_location [Boolean] Only return profiles with a location.
+        #
+        # @param has_website [Boolean] Only return profiles with a website.
+        #
+        # @param location_contains [String] Match a location substring, ignoring case.
+        #
+        # @param max_followers [Integer] Maximum follower count. Missing counts pass this maximum.
+        #
+        # @param max_following [Integer] Maximum following count.
+        #
+        # @param max_statuses [Integer] Maximum post count. maxPosts is also accepted.
+        #
+        # @param min_account_age_days [Integer] Minimum account age in whole days.
+        #
+        # @param min_followers [Integer] Minimum follower count. Filtering happens before billing.
+        #
+        # @param min_following [Integer] Minimum following count.
+        #
+        # @param min_statuses [Integer] Minimum post count. minPosts is also accepted.
+        #
+        # @param page_size [Integer] Maximum user profiles requested from this page (20-200, default 200). Source, fi
+        #
+        # @param username_contains [String] Match a username substring, ignoring case.
+        #
+        # @param verified_only [Boolean] Only return verified profiles.
+        #
+        # @param verified_type [String] Match the verification type exactly, ignoring case.
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -148,7 +222,23 @@ module XTwitterScraper
           @client.request(
             method: :get,
             path: ["x/users/%1$s/followers-you-know", id],
-            query: query.transform_keys(page_size: "pageSize"),
+            query: query.transform_keys(
+              bio_contains: "bioContains",
+              has_location: "hasLocation",
+              has_website: "hasWebsite",
+              location_contains: "locationContains",
+              max_followers: "maxFollowers",
+              max_following: "maxFollowing",
+              max_statuses: "maxStatuses",
+              min_account_age_days: "minAccountAgeDays",
+              min_followers: "minFollowers",
+              min_following: "minFollowing",
+              min_statuses: "minStatuses",
+              page_size: "pageSize",
+              username_contains: "usernameContains",
+              verified_only: "verifiedOnly",
+              verified_type: "verifiedType"
+            ),
             model: XTwitterScraper::PaginatedUsers,
             options: options
           )
@@ -159,21 +249,51 @@ module XTwitterScraper
         #
         # List accounts a user follows
         #
-        # @overload retrieve_following(id, after: nil, cursor: nil, limit: nil, page_size: nil, request_options: {})
+        # @overload retrieve_following(id, after: nil, bio_contains: nil, cursor: nil, has_location: nil, has_website: nil, limit: nil, location_contains: nil, max_followers: nil, max_following: nil, max_statuses: nil, min_account_age_days: nil, min_followers: nil, min_following: nil, min_statuses: nil, mode: nil, page_size: nil, username_contains: nil, verified_only: nil, verified_type: nil, request_options: {})
         #
         # @param id [String] User ID or username for following lookup
         #
         # @param after [String] Deprecated following cursor alias. Prefer cursor.
         #
-        # @param cursor [String] Pagination cursor for following list
+        # @param bio_contains [String] Match any comma-separated or line-separated bio term, ignoring case.
+        #
+        # @param cursor [String] Cursor from the previous response. Xquik cursors resume automatic coverage. Exis
+        #
+        # @param has_location [Boolean] Only return profiles with a location.
+        #
+        # @param has_website [Boolean] Only return profiles with a website.
+        #
+        # @param limit [Integer] Legacy page-size alias outside explicit coverage mode. Coverage accepts 1-10000.
+        #
+        # @param location_contains [String] Match a location substring, ignoring case.
+        #
+        # @param max_followers [Integer] Maximum follower count. Missing counts pass this maximum.
+        #
+        # @param max_following [Integer] Maximum following count.
+        #
+        # @param max_statuses [Integer] Maximum post count. maxPosts is also accepted.
+        #
+        # @param min_account_age_days [Integer] Minimum account age in whole days.
+        #
+        # @param min_followers [Integer] Minimum follower count. Filtering happens before billing.
+        #
+        # @param min_following [Integer] Minimum following count.
+        #
+        # @param min_statuses [Integer] Minimum post count. minPosts is also accepted.
         #
-        # @param limit [Integer] Legacy page size alias. Prefer pageSize.
+        # @param mode [Symbol, XTwitterScraper::Models::X::UserRetrieveFollowingParams::Mode] Omit mode for resumable maximum coverage. Standard keeps legacy pagination. Cove
         #
-        # @param page_size [Integer] Maximum user profiles requested from this page (20-200, default 200). The respon
+        # @param page_size [Integer] Maximum user profiles: automatic 300; standard 200. Sources return fewer profile
+        #
+        # @param username_contains [String] Match a username substring, ignoring case.
+        #
+        # @param verified_only [Boolean] Only return verified profiles.
+        #
+        # @param verified_type [String] Match the verification type exactly, ignoring case.
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [XTwitterScraper::Models::PaginatedUsers]
+        # @return [XTwitterScraper::Models::PaginatedUsers, XTwitterScraper::Models::X::UserRetrieveFollowingResponse::UserListCoverageResponse]
         #
         # @see XTwitterScraper::Models::X::UserRetrieveFollowingParams
         def retrieve_following(id, params = {})
@@ -182,8 +302,24 @@ module XTwitterScraper
           @client.request(
             method: :get,
             path: ["x/users/%1$s/following", id],
-            query: query.transform_keys(page_size: "pageSize"),
-            model: XTwitterScraper::PaginatedUsers,
+            query: query.transform_keys(
+              bio_contains: "bioContains",
+              has_location: "hasLocation",
+              has_website: "hasWebsite",
+              location_contains: "locationContains",
+              max_followers: "maxFollowers",
+              max_following: "maxFollowing",
+              max_statuses: "maxStatuses",
+              min_account_age_days: "minAccountAgeDays",
+              min_followers: "minFollowers",
+              min_following: "minFollowing",
+              min_statuses: "minStatuses",
+              page_size: "pageSize",
+              username_contains: "usernameContains",
+              verified_only: "verifiedOnly",
+              verified_type: "verifiedType"
+            ),
+            model: XTwitterScraper::Models::X::UserRetrieveFollowingResponse,
             options: options
           )
         end
@@ -193,12 +329,16 @@ module XTwitterScraper
         #
         # List tweets liked by a user
         #
-        # @overload retrieve_likes(id, any_words: nil, cashtags: nil, conversation_id: nil, cursor: nil, exact_phrase: nil, exclude_words: nil, from_user: nil, hashtags: nil, in_reply_to_tweet_id: nil, language: nil, media_type: nil, mentioning: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, page_size: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, retweets: nil, retweets_of_tweet_id: nil, since_date: nil, to_user: nil, until_date: nil, url: nil, verified_only: nil, request_options: {})
+        # @overload retrieve_likes(id, any_words: nil, blue_verified_only: nil, card_name: nil, cashtags: nil, conversation_id: nil, cursor: nil, exact_phrase: nil, exclude_source: nil, exclude_words: nil, from_user: nil, geocode: nil, hashtags: nil, in_reply_to_tweet_id: nil, language: nil, max_faves: nil, max_id: nil, max_quotes: nil, max_replies: nil, max_retweets: nil, media_type: nil, mentioning: nil, min_bookmarks: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, min_views: nil, native_retweets: nil, near: nil, news: nil, page_size: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, retweets: nil, retweets_of_tweet_id: nil, safe: nil, since_date: nil, since_id: nil, source: nil, to_user: nil, until_date: nil, url: nil, verified_only: nil, within: nil, within_time: nil, request_options: {})
         #
         # @param id [String] User ID or username
         #
         # @param any_words [String] Words or quoted phrases where any one can match. Separate with spaces, commas, o
         #
+        # @param blue_verified_only [Boolean] Only return tweets from Blue-verified authors.
+        #
+        # @param card_name [String] Match the Tweet card name.
+        #
         # @param cashtags [String] Cashtags separated by spaces, commas, or lines.
         #
         # @param conversation_id [String] Conversation ID filter.
@@ -207,20 +347,36 @@ module XTwitterScraper
         #
         # @param exact_phrase [String] Exact phrase to match.
         #
+        # @param exclude_source [String] Exclude a source application.
+        #
         # @param exclude_words [String] Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
         #
         # @param from_user [String] Filter by author username.
         #
+        # @param geocode [String] Match latitude, longitude, and radius.
+        #
         # @param hashtags [String] Hashtags separated by spaces, commas, or lines.
         #
         # @param in_reply_to_tweet_id [String] Only replies to this tweet ID.
         #
         # @param language [String] Language code filter, e.g. en or tr.
         #
+        # @param max_faves [Integer] Maximum likes threshold. maxLikes is also accepted.
+        #
+        # @param max_id [String] Return Tweets older than this Tweet ID.
+        #
+        # @param max_quotes [Integer] Maximum quotes threshold.
+        #
+        # @param max_replies [Integer] Maximum replies threshold.
+        #
+        # @param max_retweets [Integer] Maximum retweets threshold.
+        #
         # @param media_type [Symbol, XTwitterScraper::Models::X::UserRetrieveLikesParams::MediaType] Filter by media type.
         #
         # @param mentioning [String] Filter tweets mentioning a username.
         #
+        # @param min_bookmarks [Integer] Minimum bookmark count threshold.
+        #
         # @param min_faves [Integer] Minimum likes threshold.
         #
         # @param min_quotes [Integer] Minimum quote count threshold.
@@ -229,6 +385,14 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
+        # @param min_views [Integer] Minimum view count threshold.
+        #
+        # @param native_retweets [Boolean] Only return native reposts.
+        #
+        # @param near [String] Match a place name.
+        #
+        # @param news [Boolean] Only return news results.
+        #
         # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
         #
         # @param quotes [Symbol, XTwitterScraper::Models::X::UserRetrieveLikesParams::Quotes] Quote mode.
@@ -241,8 +405,14 @@ module XTwitterScraper
         #
         # @param retweets_of_tweet_id [String] Only retweets of this tweet ID.
         #
+        # @param safe [Boolean] Enable the safe-search filter.
+        #
         # @param since_date [Date] Start date in YYYY-MM-DD format.
         #
+        # @param since_id [String] Return Tweets newer than this Tweet ID.
+        #
+        # @param source [String] Match the source application.
+        #
         # @param to_user [String] Filter replies sent to a username.
         #
         # @param until_date [Date] End date in YYYY-MM-DD format.
@@ -251,6 +421,10 @@ module XTwitterScraper
         #
         # @param verified_only [Boolean] Only return tweets from verified authors.
         #
+        # @param within [String] Set the radius for the near filter.
+        #
+        # @param within_time [String] Match Tweets inside a recent time window.
+        #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [XTwitterScraper::Models::PaginatedTweets]
@@ -264,23 +438,36 @@ module XTwitterScraper
             path: ["x/users/%1$s/likes", id],
             query: query.transform_keys(
               any_words: "anyWords",
+              blue_verified_only: "blueVerifiedOnly",
+              card_name: "cardName",
               conversation_id: "conversationId",
               exact_phrase: "exactPhrase",
+              exclude_source: "excludeSource",
               exclude_words: "excludeWords",
               from_user: "fromUser",
               in_reply_to_tweet_id: "inReplyToTweetId",
+              max_faves: "maxFaves",
+              max_id: "maxId",
+              max_quotes: "maxQuotes",
+              max_replies: "maxReplies",
+              max_retweets: "maxRetweets",
               media_type: "mediaType",
+              min_bookmarks: "minBookmarks",
               min_faves: "minFaves",
               min_quotes: "minQuotes",
               min_replies: "minReplies",
               min_retweets: "minRetweets",
+              min_views: "minViews",
+              native_retweets: "nativeRetweets",
               page_size: "pageSize",
               quotes_of_tweet_id: "quotesOfTweetId",
               retweets_of_tweet_id: "retweetsOfTweetId",
               since_date: "sinceDate",
+              since_id: "sinceId",
               to_user: "toUser",
               until_date: "untilDate",
-              verified_only: "verifiedOnly"
+              verified_only: "verifiedOnly",
+              within_time: "withinTime"
             ),
             model: XTwitterScraper::PaginatedTweets,
             options: options
@@ -292,12 +479,16 @@ module XTwitterScraper
         #
         # List media tweets posted by a user
         #
-        # @overload retrieve_media(id, any_words: nil, cashtags: nil, conversation_id: nil, cursor: nil, exact_phrase: nil, exclude_words: nil, from_user: nil, hashtags: nil, in_reply_to_tweet_id: nil, language: nil, media_type: nil, mentioning: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, page_size: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, retweets: nil, retweets_of_tweet_id: nil, since_date: nil, to_user: nil, until_date: nil, url: nil, verified_only: nil, request_options: {})
+        # @overload retrieve_media(id, any_words: nil, blue_verified_only: nil, card_name: nil, cashtags: nil, conversation_id: nil, cursor: nil, exact_phrase: nil, exclude_source: nil, exclude_words: nil, from_user: nil, geocode: nil, hashtags: nil, in_reply_to_tweet_id: nil, language: nil, max_faves: nil, max_id: nil, max_quotes: nil, max_replies: nil, max_retweets: nil, media_type: nil, mentioning: nil, min_bookmarks: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, min_views: nil, native_retweets: nil, near: nil, news: nil, page_size: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, retweets: nil, retweets_of_tweet_id: nil, safe: nil, since_date: nil, since_id: nil, source: nil, to_user: nil, until_date: nil, url: nil, verified_only: nil, within: nil, within_time: nil, request_options: {})
         #
         # @param id [String] User ID or username for media lookup
         #
         # @param any_words [String] Words or quoted phrases where any one can match. Separate with spaces, commas, o
         #
+        # @param blue_verified_only [Boolean] Only return tweets from Blue-verified authors.
+        #
+        # @param card_name [String] Match the Tweet card name.
+        #
         # @param cashtags [String] Cashtags separated by spaces, commas, or lines.
         #
         # @param conversation_id [String] Conversation ID filter.
@@ -306,20 +497,36 @@ module XTwitterScraper
         #
         # @param exact_phrase [String] Exact phrase to match.
         #
+        # @param exclude_source [String] Exclude a source application.
+        #
         # @param exclude_words [String] Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
         #
         # @param from_user [String] Filter by author username.
         #
+        # @param geocode [String] Match latitude, longitude, and radius.
+        #
         # @param hashtags [String] Hashtags separated by spaces, commas, or lines.
         #
         # @param in_reply_to_tweet_id [String] Only replies to this tweet ID.
         #
         # @param language [String] Language code filter, e.g. en or tr.
         #
+        # @param max_faves [Integer] Maximum likes threshold. maxLikes is also accepted.
+        #
+        # @param max_id [String] Return Tweets older than this Tweet ID.
+        #
+        # @param max_quotes [Integer] Maximum quotes threshold.
+        #
+        # @param max_replies [Integer] Maximum replies threshold.
+        #
+        # @param max_retweets [Integer] Maximum retweets threshold.
+        #
         # @param media_type [Symbol, XTwitterScraper::Models::X::UserRetrieveMediaParams::MediaType] Filter by media type.
         #
         # @param mentioning [String] Filter tweets mentioning a username.
         #
+        # @param min_bookmarks [Integer] Minimum bookmark count threshold.
+        #
         # @param min_faves [Integer] Minimum likes threshold.
         #
         # @param min_quotes [Integer] Minimum quote count threshold.
@@ -328,6 +535,14 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
+        # @param min_views [Integer] Minimum view count threshold.
+        #
+        # @param native_retweets [Boolean] Only return native reposts.
+        #
+        # @param near [String] Match a place name.
+        #
+        # @param news [Boolean] Only return news results.
+        #
         # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
         #
         # @param quotes [Symbol, XTwitterScraper::Models::X::UserRetrieveMediaParams::Quotes] Quote mode.
@@ -340,8 +555,14 @@ module XTwitterScraper
         #
         # @param retweets_of_tweet_id [String] Only retweets of this tweet ID.
         #
+        # @param safe [Boolean] Enable the safe-search filter.
+        #
         # @param since_date [Date] Start date in YYYY-MM-DD format.
         #
+        # @param since_id [String] Return Tweets newer than this Tweet ID.
+        #
+        # @param source [String] Match the source application.
+        #
         # @param to_user [String] Filter replies sent to a username.
         #
         # @param until_date [Date] End date in YYYY-MM-DD format.
@@ -350,6 +571,10 @@ module XTwitterScraper
         #
         # @param verified_only [Boolean] Only return tweets from verified authors.
         #
+        # @param within [String] Set the radius for the near filter.
+        #
+        # @param within_time [String] Match Tweets inside a recent time window.
+        #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [XTwitterScraper::Models::PaginatedTweets]
@@ -363,23 +588,36 @@ module XTwitterScraper
             path: ["x/users/%1$s/media", id],
             query: query.transform_keys(
               any_words: "anyWords",
+              blue_verified_only: "blueVerifiedOnly",
+              card_name: "cardName",
               conversation_id: "conversationId",
               exact_phrase: "exactPhrase",
+              exclude_source: "excludeSource",
               exclude_words: "excludeWords",
               from_user: "fromUser",
               in_reply_to_tweet_id: "inReplyToTweetId",
+              max_faves: "maxFaves",
+              max_id: "maxId",
+              max_quotes: "maxQuotes",
+              max_replies: "maxReplies",
+              max_retweets: "maxRetweets",
               media_type: "mediaType",
+              min_bookmarks: "minBookmarks",
               min_faves: "minFaves",
               min_quotes: "minQuotes",
               min_replies: "minReplies",
               min_retweets: "minRetweets",
+              min_views: "minViews",
+              native_retweets: "nativeRetweets",
               page_size: "pageSize",
               quotes_of_tweet_id: "quotesOfTweetId",
               retweets_of_tweet_id: "retweetsOfTweetId",
               since_date: "sinceDate",
+              since_id: "sinceId",
               to_user: "toUser",
               until_date: "untilDate",
-              verified_only: "verifiedOnly"
+              verified_only: "verifiedOnly",
+              within_time: "withinTime"
             ),
             model: XTwitterScraper::PaginatedTweets,
             options: options
@@ -391,12 +629,16 @@ module XTwitterScraper
         #
         # List tweets mentioning a user
         #
-        # @overload retrieve_mentions(id, any_words: nil, cashtags: nil, conversation_id: nil, cursor: nil, exact_phrase: nil, exclude_words: nil, from_user: nil, hashtags: nil, in_reply_to_tweet_id: nil, language: nil, media_type: nil, mentioning: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, page_size: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, retweets: nil, retweets_of_tweet_id: nil, since_date: nil, since_time: nil, to_user: nil, until_date: nil, until_time: nil, url: nil, verified_only: nil, request_options: {})
+        # @overload retrieve_mentions(id, any_words: nil, blue_verified_only: nil, card_name: nil, cashtags: nil, conversation_id: nil, cursor: nil, exact_phrase: nil, exclude_source: nil, exclude_words: nil, from_user: nil, geocode: nil, hashtags: nil, in_reply_to_tweet_id: nil, language: nil, max_faves: nil, max_id: nil, max_quotes: nil, max_replies: nil, max_retweets: nil, media_type: nil, mentioning: nil, min_bookmarks: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, min_views: nil, native_retweets: nil, near: nil, news: nil, page_size: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, retweets: nil, retweets_of_tweet_id: nil, safe: nil, since_date: nil, since_id: nil, since_time: nil, source: nil, to_user: nil, until_date: nil, until_time: nil, url: nil, verified_only: nil, within: nil, within_time: nil, request_options: {})
         #
         # @param id [String] User ID or username for mentions lookup
         #
         # @param any_words [String] Words or quoted phrases where any one can match. Separate with spaces, commas, o
         #
+        # @param blue_verified_only [Boolean] Only return tweets from Blue-verified authors.
+        #
+        # @param card_name [String] Match the Tweet card name.
+        #
         # @param cashtags [String] Cashtags separated by spaces, commas, or lines.
         #
         # @param conversation_id [String] Conversation ID filter.
@@ -405,20 +647,36 @@ module XTwitterScraper
         #
         # @param exact_phrase [String] Exact phrase to match.
         #
+        # @param exclude_source [String] Exclude a source application.
+        #
         # @param exclude_words [String] Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
         #
         # @param from_user [String] Filter by author username.
         #
+        # @param geocode [String] Match latitude, longitude, and radius.
+        #
         # @param hashtags [String] Hashtags separated by spaces, commas, or lines.
         #
         # @param in_reply_to_tweet_id [String] Only replies to this tweet ID.
         #
         # @param language [String] Language code filter, e.g. en or tr.
         #
+        # @param max_faves [Integer] Maximum likes threshold. maxLikes is also accepted.
+        #
+        # @param max_id [String] Return Tweets older than this Tweet ID.
+        #
+        # @param max_quotes [Integer] Maximum quotes threshold.
+        #
+        # @param max_replies [Integer] Maximum replies threshold.
+        #
+        # @param max_retweets [Integer] Maximum retweets threshold.
+        #
         # @param media_type [Symbol, XTwitterScraper::Models::X::UserRetrieveMentionsParams::MediaType] Filter by media type.
         #
         # @param mentioning [String] Filter tweets mentioning a username.
         #
+        # @param min_bookmarks [Integer] Minimum bookmark count threshold.
+        #
         # @param min_faves [Integer] Minimum likes threshold.
         #
         # @param min_quotes [Integer] Minimum quote count threshold.
@@ -427,6 +685,14 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
+        # @param min_views [Integer] Minimum view count threshold.
+        #
+        # @param native_retweets [Boolean] Only return native reposts.
+        #
+        # @param near [String] Match a place name.
+        #
+        # @param news [Boolean] Only return news results.
+        #
         # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
         #
         # @param quotes [Symbol, XTwitterScraper::Models::X::UserRetrieveMentionsParams::Quotes] Quote mode.
@@ -439,10 +705,16 @@ module XTwitterScraper
         #
         # @param retweets_of_tweet_id [String] Only retweets of this tweet ID.
         #
+        # @param safe [Boolean] Enable the safe-search filter.
+        #
         # @param since_date [Date] Start date in YYYY-MM-DD format.
         #
+        # @param since_id [String] Return Tweets newer than this Tweet ID.
+        #
         # @param since_time [String] Unix timestamp - return mentions after this time
         #
+        # @param source [String] Match the source application.
+        #
         # @param to_user [String] Filter replies sent to a username.
         #
         # @param until_date [Date] End date in YYYY-MM-DD format.
@@ -453,6 +725,10 @@ module XTwitterScraper
         #
         # @param verified_only [Boolean] Only return tweets from verified authors.
         #
+        # @param within [String] Set the radius for the near filter.
+        #
+        # @param within_time [String] Match Tweets inside a recent time window.
+        #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [XTwitterScraper::Models::PaginatedTweets]
@@ -466,25 +742,38 @@ module XTwitterScraper
             path: ["x/users/%1$s/mentions", id],
             query: query.transform_keys(
               any_words: "anyWords",
+              blue_verified_only: "blueVerifiedOnly",
+              card_name: "cardName",
               conversation_id: "conversationId",
               exact_phrase: "exactPhrase",
+              exclude_source: "excludeSource",
               exclude_words: "excludeWords",
               from_user: "fromUser",
               in_reply_to_tweet_id: "inReplyToTweetId",
+              max_faves: "maxFaves",
+              max_id: "maxId",
+              max_quotes: "maxQuotes",
+              max_replies: "maxReplies",
+              max_retweets: "maxRetweets",
               media_type: "mediaType",
+              min_bookmarks: "minBookmarks",
               min_faves: "minFaves",
               min_quotes: "minQuotes",
               min_replies: "minReplies",
               min_retweets: "minRetweets",
+              min_views: "minViews",
+              native_retweets: "nativeRetweets",
               page_size: "pageSize",
               quotes_of_tweet_id: "quotesOfTweetId",
               retweets_of_tweet_id: "retweetsOfTweetId",
               since_date: "sinceDate",
+              since_id: "sinceId",
               since_time: "sinceTime",
               to_user: "toUser",
               until_date: "untilDate",
               until_time: "untilTime",
-              verified_only: "verifiedOnly"
+              verified_only: "verifiedOnly",
+              within_time: "withinTime"
             ),
             model: XTwitterScraper::PaginatedTweets,
             options: options
@@ -494,26 +783,36 @@ module XTwitterScraper
         # Some parameter documentations has been truncated, see
         # {XTwitterScraper::Models::X::UserRetrieveRepliesParams} for more details.
         #
-        # Returns the user's timeline with replies included by default.
+        # Returns target-authored posts and replies. Omit mode for automatic maximum
+        # coverage. Pass next_cursor unchanged. Unprefixed cursors stay legacy. Excludes
+        # other-author context.
         #
-        # @overload retrieve_replies(id, any_words: nil, cashtags: nil, conversation_id: nil, cursor: nil, exact_phrase: nil, exclude_words: nil, from_user: nil, hashtags: nil, include_parent_tweet: nil, in_reply_to_tweet_id: nil, language: nil, media_type: nil, mentioning: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, page_size: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, retweets: nil, retweets_of_tweet_id: nil, since_date: nil, to_user: nil, until_date: nil, url: nil, verified_only: nil, request_options: {})
+        # @overload retrieve_replies(id, any_words: nil, blue_verified_only: nil, card_name: nil, cashtags: nil, conversation_id: nil, cursor: nil, exact_phrase: nil, exclude_source: nil, exclude_words: nil, from_user: nil, geocode: nil, hashtags: nil, include_parent_tweet: nil, in_reply_to_tweet_id: nil, language: nil, max_faves: nil, max_id: nil, max_quotes: nil, max_replies: nil, max_retweets: nil, media_type: nil, mentioning: nil, min_bookmarks: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, min_views: nil, native_retweets: nil, near: nil, news: nil, page_size: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, retweets: nil, retweets_of_tweet_id: nil, safe: nil, since_date: nil, since_id: nil, source: nil, to_user: nil, until_date: nil, url: nil, verified_only: nil, within: nil, within_time: nil, request_options: {})
         #
         # @param id [String] Target user ID or username for the replies timeline.
         #
         # @param any_words [String] Words or quoted phrases where any one can match. Separate with spaces, commas, o
         #
+        # @param blue_verified_only [Boolean] Only return tweets from Blue-verified authors.
+        #
+        # @param card_name [String] Match the Tweet card name.
+        #
         # @param cashtags [String] Cashtags separated by spaces, commas, or lines.
         #
         # @param conversation_id [String] Conversation ID filter.
         #
-        # @param cursor [String] Pagination cursor for user replies
+        # @param cursor [String] Cursor from the previous response. Xquik cursors resume automatic coverage. Exis
         #
         # @param exact_phrase [String] Exact phrase to match.
         #
+        # @param exclude_source [String] Exclude a source application.
+        #
         # @param exclude_words [String] Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
         #
         # @param from_user [String] Filter by author username.
         #
+        # @param geocode [String] Match latitude, longitude, and radius.
+        #
         # @param hashtags [String] Hashtags separated by spaces, commas, or lines.
         #
         # @param include_parent_tweet [Boolean] Include each reply's parent tweet.
@@ -522,10 +821,22 @@ module XTwitterScraper
         #
         # @param language [String] Language code filter, e.g. en or tr.
         #
+        # @param max_faves [Integer] Maximum likes threshold. maxLikes is also accepted.
+        #
+        # @param max_id [String] Return Tweets older than this Tweet ID.
+        #
+        # @param max_quotes [Integer] Maximum quotes threshold.
+        #
+        # @param max_replies [Integer] Maximum replies threshold.
+        #
+        # @param max_retweets [Integer] Maximum retweets threshold.
+        #
         # @param media_type [Symbol, XTwitterScraper::Models::X::UserRetrieveRepliesParams::MediaType] Filter by media type.
         #
         # @param mentioning [String] Filter tweets mentioning a username.
         #
+        # @param min_bookmarks [Integer] Minimum bookmark count threshold.
+        #
         # @param min_faves [Integer] Minimum likes threshold.
         #
         # @param min_quotes [Integer] Minimum quote count threshold.
@@ -534,7 +845,15 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
-        # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
+        # @param min_views [Integer] Minimum view count threshold.
+        #
+        # @param native_retweets [Boolean] Only return native reposts.
+        #
+        # @param near [String] Match a place name.
+        #
+        # @param news [Boolean] Only return news results.
+        #
+        # @param page_size [Integer] Automatic pages accept 1-300 Tweets. Standard pages keep 1-100. Default 20. Cont
         #
         # @param quotes [Symbol, XTwitterScraper::Models::X::UserRetrieveRepliesParams::Quotes] Quote mode.
         #
@@ -546,8 +865,14 @@ module XTwitterScraper
         #
         # @param retweets_of_tweet_id [String] Only retweets of this tweet ID.
         #
+        # @param safe [Boolean] Enable the safe-search filter.
+        #
         # @param since_date [Date] Start date in YYYY-MM-DD format.
         #
+        # @param since_id [String] Return Tweets newer than this Tweet ID.
+        #
+        # @param source [String] Match the source application.
+        #
         # @param to_user [String] Filter replies sent to a username.
         #
         # @param until_date [Date] End date in YYYY-MM-DD format.
@@ -556,6 +881,10 @@ module XTwitterScraper
         #
         # @param verified_only [Boolean] Only return tweets from verified authors.
         #
+        # @param within [String] Set the radius for the near filter.
+        #
+        # @param within_time [String] Match Tweets inside a recent time window.
+        #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [XTwitterScraper::Models::PaginatedTweets]
@@ -569,38 +898,82 @@ module XTwitterScraper
             path: ["x/users/%1$s/replies", id],
             query: query.transform_keys(
               any_words: "anyWords",
+              blue_verified_only: "blueVerifiedOnly",
+              card_name: "cardName",
               conversation_id: "conversationId",
               exact_phrase: "exactPhrase",
+              exclude_source: "excludeSource",
               exclude_words: "excludeWords",
               from_user: "fromUser",
               include_parent_tweet: "includeParentTweet",
               in_reply_to_tweet_id: "inReplyToTweetId",
+              max_faves: "maxFaves",
+              max_id: "maxId",
+              max_quotes: "maxQuotes",
+              max_replies: "maxReplies",
+              max_retweets: "maxRetweets",
               media_type: "mediaType",
+              min_bookmarks: "minBookmarks",
               min_faves: "minFaves",
               min_quotes: "minQuotes",
               min_replies: "minReplies",
               min_retweets: "minRetweets",
+              min_views: "minViews",
+              native_retweets: "nativeRetweets",
               page_size: "pageSize",
               quotes_of_tweet_id: "quotesOfTweetId",
               retweets_of_tweet_id: "retweetsOfTweetId",
               since_date: "sinceDate",
+              since_id: "sinceId",
               to_user: "toUser",
               until_date: "untilDate",
-              verified_only: "verifiedOnly"
+              verified_only: "verifiedOnly",
+              within_time: "withinTime"
             ),
             model: XTwitterScraper::PaginatedTweets,
             options: options
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {XTwitterScraper::Models::X::UserRetrieveSearchParams} for more details.
+        #
         # Search users by name or username
         #
-        # @overload retrieve_search(q:, cursor: nil, request_options: {})
+        # @overload retrieve_search(q:, bio_contains: nil, cursor: nil, has_location: nil, has_website: nil, location_contains: nil, max_followers: nil, max_following: nil, max_statuses: nil, min_account_age_days: nil, min_followers: nil, min_following: nil, min_statuses: nil, username_contains: nil, verified_only: nil, verified_type: nil, request_options: {})
         #
         # @param q [String] User search query
         #
+        # @param bio_contains [String] Match any comma-separated or line-separated bio term, ignoring case.
+        #
         # @param cursor [String] Pagination cursor for user search
         #
+        # @param has_location [Boolean] Only return profiles with a location.
+        #
+        # @param has_website [Boolean] Only return profiles with a website.
+        #
+        # @param location_contains [String] Match a location substring, ignoring case.
+        #
+        # @param max_followers [Integer] Maximum follower count. Missing counts pass this maximum.
+        #
+        # @param max_following [Integer] Maximum following count.
+        #
+        # @param max_statuses [Integer] Maximum post count. maxPosts is also accepted.
+        #
+        # @param min_account_age_days [Integer] Minimum account age in whole days.
+        #
+        # @param min_followers [Integer] Minimum follower count. Filtering happens before billing.
+        #
+        # @param min_following [Integer] Minimum following count.
+        #
+        # @param min_statuses [Integer] Minimum post count. minPosts is also accepted.
+        #
+        # @param username_contains [String] Match a username substring, ignoring case.
+        #
+        # @param verified_only [Boolean] Only return verified profiles.
+        #
+        # @param verified_type [String] Match the verification type exactly, ignoring case.
+        #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [XTwitterScraper::Models::PaginatedUsers]
@@ -612,7 +985,22 @@ module XTwitterScraper
           @client.request(
             method: :get,
             path: "x/users/search",
-            query: query,
+            query: query.transform_keys(
+              bio_contains: "bioContains",
+              has_location: "hasLocation",
+              has_website: "hasWebsite",
+              location_contains: "locationContains",
+              max_followers: "maxFollowers",
+              max_following: "maxFollowing",
+              max_statuses: "maxStatuses",
+              min_account_age_days: "minAccountAgeDays",
+              min_followers: "minFollowers",
+              min_following: "minFollowing",
+              min_statuses: "minStatuses",
+              username_contains: "usernameContains",
+              verified_only: "verifiedOnly",
+              verified_type: "verifiedType"
+            ),
             model: XTwitterScraper::PaginatedUsers,
             options: options
           )
@@ -621,26 +1009,35 @@ module XTwitterScraper
         # Some parameter documentations has been truncated, see
         # {XTwitterScraper::Models::X::UserRetrieveTweetsParams} for more details.
         #
-        # List recent tweets posted by a user
+        # Omit mode for automatic maximum coverage. Pass next_cursor unchanged. Unprefixed
+        # cursors use legacy pagination. Shape and billing stay the same.
         #
-        # @overload retrieve_tweets(id, any_words: nil, cashtags: nil, conversation_id: nil, cursor: nil, exact_phrase: nil, exclude_words: nil, from_user: nil, hashtags: nil, include_parent_tweet: nil, include_replies: nil, in_reply_to_tweet_id: nil, language: nil, media_type: nil, mentioning: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, page_size: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, retweets: nil, retweets_of_tweet_id: nil, since_date: nil, to_user: nil, until_date: nil, url: nil, verified_only: nil, request_options: {})
+        # @overload retrieve_tweets(id, any_words: nil, blue_verified_only: nil, card_name: nil, cashtags: nil, conversation_id: nil, cursor: nil, exact_phrase: nil, exclude_source: nil, exclude_words: nil, from_user: nil, geocode: nil, hashtags: nil, include_parent_tweet: nil, include_replies: nil, in_reply_to_tweet_id: nil, language: nil, max_faves: nil, max_id: nil, max_quotes: nil, max_replies: nil, max_retweets: nil, media_type: nil, mentioning: nil, min_bookmarks: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, min_views: nil, native_retweets: nil, near: nil, news: nil, page_size: nil, quotes: nil, quotes_of_tweet_id: nil, replies: nil, retweets: nil, retweets_of_tweet_id: nil, safe: nil, since_date: nil, since_id: nil, source: nil, to_user: nil, until_date: nil, url: nil, verified_only: nil, within: nil, within_time: nil, request_options: {})
         #
         # @param id [String] X user ID or username
         #
         # @param any_words [String] Words or quoted phrases where any one can match. Separate with spaces, commas, o
         #
+        # @param blue_verified_only [Boolean] Only return tweets from Blue-verified authors.
+        #
+        # @param card_name [String] Match the Tweet card name.
+        #
         # @param cashtags [String] Cashtags separated by spaces, commas, or lines.
         #
         # @param conversation_id [String] Conversation ID filter.
         #
-        # @param cursor [String] Pagination cursor for user tweets
+        # @param cursor [String] Cursor from the previous response. Xquik cursors resume automatic coverage. Exis
         #
         # @param exact_phrase [String] Exact phrase to match.
         #
+        # @param exclude_source [String] Exclude a source application.
+        #
         # @param exclude_words [String] Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
         #
         # @param from_user [String] Filter by author username.
         #
+        # @param geocode [String] Match latitude, longitude, and radius.
+        #
         # @param hashtags [String] Hashtags separated by spaces, commas, or lines.
         #
         # @param include_parent_tweet [Boolean] Include parent tweet for replies
@@ -651,10 +1048,22 @@ module XTwitterScraper
         #
         # @param language [String] Language code filter, e.g. en or tr.
         #
+        # @param max_faves [Integer] Maximum likes threshold. maxLikes is also accepted.
+        #
+        # @param max_id [String] Return Tweets older than this Tweet ID.
+        #
+        # @param max_quotes [Integer] Maximum quotes threshold.
+        #
+        # @param max_replies [Integer] Maximum replies threshold.
+        #
+        # @param max_retweets [Integer] Maximum retweets threshold.
+        #
         # @param media_type [Symbol, XTwitterScraper::Models::X::UserRetrieveTweetsParams::MediaType] Filter by media type.
         #
         # @param mentioning [String] Filter tweets mentioning a username.
         #
+        # @param min_bookmarks [Integer] Minimum bookmark count threshold.
+        #
         # @param min_faves [Integer] Minimum likes threshold.
         #
         # @param min_quotes [Integer] Minimum quote count threshold.
@@ -663,7 +1072,15 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
-        # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
+        # @param min_views [Integer] Minimum view count threshold.
+        #
+        # @param native_retweets [Boolean] Only return native reposts.
+        #
+        # @param near [String] Match a place name.
+        #
+        # @param news [Boolean] Only return news results.
+        #
+        # @param page_size [Integer] Automatic pages accept 1-300 Tweets. Standard pages keep 1-100. Default 20. Cont
         #
         # @param quotes [Symbol, XTwitterScraper::Models::X::UserRetrieveTweetsParams::Quotes] Quote mode.
         #
@@ -675,8 +1092,14 @@ module XTwitterScraper
         #
         # @param retweets_of_tweet_id [String] Only retweets of this tweet ID.
         #
+        # @param safe [Boolean] Enable the safe-search filter.
+        #
         # @param since_date [Date] Start date in YYYY-MM-DD format.
         #
+        # @param since_id [String] Return Tweets newer than this Tweet ID.
+        #
+        # @param source [String] Match the source application.
+        #
         # @param to_user [String] Filter replies sent to a username.
         #
         # @param until_date [Date] End date in YYYY-MM-DD format.
@@ -685,6 +1108,10 @@ module XTwitterScraper
         #
         # @param verified_only [Boolean] Only return tweets from verified authors.
         #
+        # @param within [String] Set the radius for the near filter.
+        #
+        # @param within_time [String] Match Tweets inside a recent time window.
+        #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [XTwitterScraper::Models::PaginatedTweets]
@@ -698,25 +1125,38 @@ module XTwitterScraper
             path: ["x/users/%1$s/tweets", id],
             query: query.transform_keys(
               any_words: "anyWords",
+              blue_verified_only: "blueVerifiedOnly",
+              card_name: "cardName",
               conversation_id: "conversationId",
               exact_phrase: "exactPhrase",
+              exclude_source: "excludeSource",
               exclude_words: "excludeWords",
               from_user: "fromUser",
               include_parent_tweet: "includeParentTweet",
               include_replies: "includeReplies",
               in_reply_to_tweet_id: "inReplyToTweetId",
+              max_faves: "maxFaves",
+              max_id: "maxId",
+              max_quotes: "maxQuotes",
+              max_replies: "maxReplies",
+              max_retweets: "maxRetweets",
               media_type: "mediaType",
+              min_bookmarks: "minBookmarks",
               min_faves: "minFaves",
               min_quotes: "minQuotes",
               min_replies: "minReplies",
               min_retweets: "minRetweets",
+              min_views: "minViews",
+              native_retweets: "nativeRetweets",
               page_size: "pageSize",
               quotes_of_tweet_id: "quotesOfTweetId",
               retweets_of_tweet_id: "retweetsOfTweetId",
               since_date: "sinceDate",
+              since_id: "sinceId",
               to_user: "toUser",
               until_date: "untilDate",
-              verified_only: "verifiedOnly"
+              verified_only: "verifiedOnly",
+              within_time: "withinTime"
             ),
             model: XTwitterScraper::PaginatedTweets,
             options: options
@@ -729,17 +1169,51 @@ module XTwitterScraper
         #
         # List verified followers of a user
         #
-        # @overload retrieve_verified_followers(id, cursor: nil, page_size: nil, request_options: {})
+        # @overload retrieve_verified_followers(id, after: nil, bio_contains: nil, cursor: nil, has_location: nil, has_website: nil, limit: nil, location_contains: nil, max_followers: nil, max_following: nil, max_statuses: nil, min_account_age_days: nil, min_followers: nil, min_following: nil, min_statuses: nil, mode: nil, page_size: nil, username_contains: nil, verified_only: nil, verified_type: nil, request_options: {})
         #
         # @param id [String] User ID or username for verified followers
         #
-        # @param cursor [String] Pagination cursor for verified followers
+        # @param after [String] Legacy cursor alias. Prefer cursor.
+        #
+        # @param bio_contains [String] Match any comma-separated or line-separated bio term, ignoring case.
+        #
+        # @param cursor [String] Cursor from the previous response. Xquik cursors resume automatic coverage. Exis
+        #
+        # @param has_location [Boolean] Only return profiles with a location.
+        #
+        # @param has_website [Boolean] Only return profiles with a website.
+        #
+        # @param limit [Integer] Legacy page-size alias outside explicit coverage mode. Coverage accepts 1-10000.
+        #
+        # @param location_contains [String] Match a location substring, ignoring case.
+        #
+        # @param max_followers [Integer] Maximum follower count. Missing counts pass this maximum.
+        #
+        # @param max_following [Integer] Maximum following count.
+        #
+        # @param max_statuses [Integer] Maximum post count. maxPosts is also accepted.
+        #
+        # @param min_account_age_days [Integer] Minimum account age in whole days.
         #
-        # @param page_size [Integer] Maximum user profiles requested from this page (20-200, default 200). The respon
+        # @param min_followers [Integer] Minimum follower count. Filtering happens before billing.
+        #
+        # @param min_following [Integer] Minimum following count.
+        #
+        # @param min_statuses [Integer] Minimum post count. minPosts is also accepted.
+        #
+        # @param mode [Symbol, XTwitterScraper::Models::X::UserRetrieveVerifiedFollowersParams::Mode] Omit mode for resumable maximum coverage. Standard keeps legacy pagination. Cove
+        #
+        # @param page_size [Integer] Maximum user profiles: automatic 300; standard 200. Sources return fewer profile
+        #
+        # @param username_contains [String] Match a username substring, ignoring case.
+        #
+        # @param verified_only [Boolean] Only return verified profiles.
+        #
+        # @param verified_type [String] Match the verification type exactly, ignoring case.
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [XTwitterScraper::Models::PaginatedUsers]
+        # @return [XTwitterScraper::Models::PaginatedUsers, XTwitterScraper::Models::X::UserRetrieveVerifiedFollowersResponse::UserListCoverageResponse]
         #
         # @see XTwitterScraper::Models::X::UserRetrieveVerifiedFollowersParams
         def retrieve_verified_followers(id, params = {})
@@ -748,8 +1222,24 @@ module XTwitterScraper
           @client.request(
             method: :get,
             path: ["x/users/%1$s/verified-followers", id],
-            query: query.transform_keys(page_size: "pageSize"),
-            model: XTwitterScraper::PaginatedUsers,
+            query: query.transform_keys(
+              bio_contains: "bioContains",
+              has_location: "hasLocation",
+              has_website: "hasWebsite",
+              location_contains: "locationContains",
+              max_followers: "maxFollowers",
+              max_following: "maxFollowing",
+              max_statuses: "maxStatuses",
+              min_account_age_days: "minAccountAgeDays",
+              min_followers: "minFollowers",
+              min_following: "minFollowing",
+              min_statuses: "minStatuses",
+              page_size: "pageSize",
+              username_contains: "usernameContains",
+              verified_only: "verifiedOnly",
+              verified_type: "verifiedType"
+            ),
+            model: XTwitterScraper::Models::X::UserRetrieveVerifiedFollowersResponse,
             options: options
           )
         end