x-twitter-scraper 0.5.5 → 0.7.0

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

@@ -11,19 +11,19 @@ module XTwitterScraper
       class Accounts
         # Connect X account
         #
-        # @overload create(email:, password:, username:, totp_secret: nil, request_options: {})
+        # @overload create(email:, password:, totp_secret:, username:, request_options: {})
         #
         # @param email [String] Account email
         #
         # @param password [String] Account password
         #
-        # @param username [String] X username
+        # @param totp_secret [String] Authenticator App TOTP secret required for durable login
         #
-        # @param totp_secret [String] TOTP secret for 2FA
+        # @param username [String] X username
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [XTwitterScraper::Models::X::AccountCreateResponse]
+        # @return [XTwitterScraper::Models::X::AccountCreateResponse::SanitizedXAccount, XTwitterScraper::Models::X::AccountCreateResponse::XAccountConnectionAttemptPending, XTwitterScraper::Models::X::AccountCreateResponse::XAccountConnectionChallenge]
         #
         # @see XTwitterScraper::Models::X::AccountCreateParams
         def create(params)
@@ -124,7 +124,7 @@ module XTwitterScraper
         #
         # @param email [String] Email for the X account (updates stored email)
         #
-        # @param totp_secret [String] TOTP secret for 2FA re-authentication
+        # @param totp_secret [String] Replacement Authenticator App TOTP secret. Omit it to reuse the saved secret.
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #

data/lib/x_twitter_scraper/resources/x/communities/tweets.rb

@@ -23,7 +23,7 @@ module XTwitterScraper
           #
           # @param cursor [String] Pagination cursor for community results
           #
-          # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+          # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
           #
           # @param query_type [Symbol, XTwitterScraper::Models::X::Communities::TweetListParams::QueryType] Sort order for community results (Latest or Top)
           #
@@ -60,7 +60,7 @@ module XTwitterScraper
           #
           # @param cursor [String] Pagination cursor for community tweets
           #
-          # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+          # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
           #
           # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
           #

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

@@ -170,7 +170,7 @@ module XTwitterScraper
         #
         # @param cursor [String] Pagination cursor for community search
         #
-        # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+        # @param page_size [Integer] Maximum page items (1-100, default 20). The source, filters, or credits can reduce results.
         #
         # @param query_type [Symbol, XTwitterScraper::Models::X::CommunityRetrieveSearchParams::QueryType] Sort order (Latest or Top)
         #

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

@@ -79,7 +79,7 @@ module XTwitterScraper
         #
         # @param include_replies [Boolean] Include replies (default false)
         #
-        # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+        # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
         #
         # @param since_time [String] Unix timestamp - filter after
         #

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

@@ -204,7 +204,7 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
-        # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+        # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
         #
         # @param quotes [Symbol, XTwitterScraper::Models::X::TweetGetQuotesParams::Quotes] Quote mode.
         #
@@ -272,13 +272,12 @@ module XTwitterScraper
         # Some parameter documentations has been truncated, see
         # {XTwitterScraper::Models::X::TweetGetRepliesParams} for more details.
         #
-        # Returns visible replies. For an unfiltered first page, Xquik compares a terminal
-        # page with the post's reported reply count. If the page is visibly incomplete,
-        # the endpoint returns 424 `replies_incomplete` instead of presenting partial
-        # coverage as complete. Use tweet search with a `conversation_id:{id}` query as
-        # the broader fallback.
+        # Returns direct replies. Complete mode merges available timeline views, supported
+        # rankings, every forward cursor module, labeled hidden-content branches,
+        # exact-parent time partitions scaled to the reported reply count, and search. It
+        # separates nested replies and returns 424 below 80% coverage.
         #
-        # @overload get_replies(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 get_replies(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, limit: nil, media_type: nil, mentioning: nil, min_faves: nil, min_quotes: nil, min_replies: nil, min_retweets: nil, mode: 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: {})
         #
         # @param id [String] Tweet ID to get replies
         #
@@ -302,6 +301,8 @@ module XTwitterScraper
         #
         # @param language [String] Language code filter, e.g. en or tr.
         #
+        # @param limit [Integer] With mode=complete, maximum combined direct and nested reply rows (1-25000). Wit
+        #
         # @param media_type [Symbol, XTwitterScraper::Models::X::TweetGetRepliesParams::MediaType] Filter by media type.
         #
         # @param mentioning [String] Filter tweets mentioning a username.
@@ -314,7 +315,9 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
-        # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+        # @param mode [Symbol, XTwitterScraper::Models::X::TweetGetRepliesParams::Mode] Set complete for maximum-coverage collection. Complete mode accepts only limit.
+        #
+        # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
         #
         # @param quotes [Symbol, XTwitterScraper::Models::X::TweetGetRepliesParams::Quotes] Quote mode.
         #
@@ -342,7 +345,7 @@ module XTwitterScraper
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
-        # @return [XTwitterScraper::Models::PaginatedTweets]
+        # @return [XTwitterScraper::Models::X::TweetGetRepliesResponse]
         #
         # @see XTwitterScraper::Models::X::TweetGetRepliesParams
         def get_replies(id, params = {})
@@ -373,7 +376,7 @@ module XTwitterScraper
               until_time: "untilTime",
               verified_only: "verifiedOnly"
             ),
-            model: XTwitterScraper::PaginatedTweets,
+            model: XTwitterScraper::Models::X::TweetGetRepliesResponse,
             options: options
           )
         end
@@ -419,7 +422,7 @@ module XTwitterScraper
         #
         # @param cursor [String] Pagination cursor for thread tweets
         #
-        # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+        # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #

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

@@ -229,7 +229,7 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
-        # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+        # @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.
         #
@@ -328,7 +328,7 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
-        # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+        # @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.
         #
@@ -427,7 +427,7 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
-        # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+        # @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.
         #
@@ -534,7 +534,7 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
-        # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+        # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
         #
         # @param quotes [Symbol, XTwitterScraper::Models::X::UserRetrieveRepliesParams::Quotes] Quote mode.
         #
@@ -663,7 +663,7 @@ module XTwitterScraper
         #
         # @param min_retweets [Integer] Minimum retweets threshold.
         #
-        # @param page_size [Integer] Maximum items requested from this page (1-100, default 20). The response can con
+        # @param page_size [Integer] Maximum page items (1-100, default 20). Source, filters, or credits can reduce r
         #
         # @param quotes [Symbol, XTwitterScraper::Models::X::UserRetrieveTweetsParams::Quotes] Quote mode.
         #

data/lib/x_twitter_scraper/resources/x.rb

@@ -42,6 +42,10 @@ module XTwitterScraper
       # @return [XTwitterScraper::Resources::X::AccountConnectionChallenges]
       attr_reader :account_connection_challenges
 
+      # Connected X account management
+      # @return [XTwitterScraper::Resources::X::AccountConnectionAttempts]
+      attr_reader :account_connection_attempts
+
       # Look up, search, and analyze individual tweets
       # @return [XTwitterScraper::Resources::X::Bookmarks]
       attr_reader :bookmarks
@@ -165,6 +169,8 @@ module XTwitterScraper
         @accounts = XTwitterScraper::Resources::X::Accounts.new(client: client)
         @account_connection_challenges =
           XTwitterScraper::Resources::X::AccountConnectionChallenges.new(client: client)
+        @account_connection_attempts =
+          XTwitterScraper::Resources::X::AccountConnectionAttempts.new(client: client)
         @bookmarks = XTwitterScraper::Resources::X::Bookmarks.new(client: client)
         @lists = XTwitterScraper::Resources::X::Lists.new(client: client)
       end

data/lib/x_twitter_scraper/version.rb

@@ -5,5 +5,5 @@
 # frozen_string_literal: true
 
 module XTwitterScraper
-  VERSION = "0.5.5"
+  VERSION = "0.7.0"
 end

data/lib/x_twitter_scraper.rb

@@ -57,6 +57,7 @@ require_relative "x_twitter_scraper/internal/transport/base_client"
 require_relative "x_twitter_scraper/internal/transport/pooled_net_requester"
 require_relative "x_twitter_scraper/client"
 require_relative "x_twitter_scraper/models/user_profile"
+require_relative "x_twitter_scraper/models/paginated_tweets"
 require_relative "x_twitter_scraper/models/account_retrieve_params"
 require_relative "x_twitter_scraper/models/account_retrieve_response"
 require_relative "x_twitter_scraper/models/account_set_x_username_params"
@@ -134,7 +135,6 @@ require_relative "x_twitter_scraper/models/monitors/keyword_retrieve_response"
 require_relative "x_twitter_scraper/models/monitors/keyword_update_params"
 require_relative "x_twitter_scraper/models/monitors/keyword_update_response"
 require_relative "x_twitter_scraper/models/monitor_update_params"
-require_relative "x_twitter_scraper/models/paginated_tweets"
 require_relative "x_twitter_scraper/models/paginated_users"
 require_relative "x_twitter_scraper/models/radar_item"
 require_relative "x_twitter_scraper/models/radar_retrieve_trending_topics_params"
@@ -184,6 +184,8 @@ require_relative "x_twitter_scraper/models/webhook_update_params"
 require_relative "x_twitter_scraper/models/winner"
 require_relative "x_twitter_scraper/models/x/account_bulk_retry_params"
 require_relative "x_twitter_scraper/models/x/account_bulk_retry_response"
+require_relative "x_twitter_scraper/models/x/account_connection_attempt_retrieve_params"
+require_relative "x_twitter_scraper/models/x/account_connection_attempt_retrieve_response"
 require_relative "x_twitter_scraper/models/x/account_connection_challenge_submit_params"
 require_relative "x_twitter_scraper/models/x/account_connection_challenge_submit_response"
 require_relative "x_twitter_scraper/models/x/account_create_params"
@@ -241,6 +243,7 @@ require_relative "x_twitter_scraper/models/x/tweet_detail"
 require_relative "x_twitter_scraper/models/x/tweet_get_favoriters_params"
 require_relative "x_twitter_scraper/models/x/tweet_get_quotes_params"
 require_relative "x_twitter_scraper/models/x/tweet_get_replies_params"
+require_relative "x_twitter_scraper/models/x/tweet_get_replies_response"
 require_relative "x_twitter_scraper/models/x/tweet_get_retweeters_params"
 require_relative "x_twitter_scraper/models/x/tweet_get_thread_params"
 require_relative "x_twitter_scraper/models/x/tweet_list_params"
@@ -304,6 +307,7 @@ require_relative "x_twitter_scraper/resources/support/tickets"
 require_relative "x_twitter_scraper/resources/trends"
 require_relative "x_twitter_scraper/resources/webhooks"
 require_relative "x_twitter_scraper/resources/x"
+require_relative "x_twitter_scraper/resources/x/account_connection_attempts"
 require_relative "x_twitter_scraper/resources/x/account_connection_challenges"
 require_relative "x_twitter_scraper/resources/x/accounts"
 require_relative "x_twitter_scraper/resources/x/bookmarks"

data/rbi/x_twitter_scraper/models/compose_create_response.rbi

@@ -61,6 +61,16 @@ module XTwitterScraper
         sig { returns(String) }
         attr_accessor :next_step
 
+        # Sources and guidance for researching a fresh post angle.
+        sig do
+          returns(
+            T::Array[
+              XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation
+            ]
+          )
+        end
+        attr_accessor :radar_recommendations
+
         # Published signal names with unpublished weights as null.
         sig do
           returns(
@@ -129,6 +139,10 @@ module XTwitterScraper
             follow_up_questions: T::Array[String],
             intent_url: String,
             next_step: String,
+            radar_recommendations:
+              T::Array[
+                XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::OrHash
+              ],
             scorer_weights:
               T::Array[
                 XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::ScorerWeight::OrHash
@@ -154,6 +168,8 @@ module XTwitterScraper
           # X post intent seeded with the topic.
           intent_url:,
           next_step:,
+          # Sources and guidance for researching a fresh post angle.
+          radar_recommendations:,
           # Published signal names with unpublished weights as null.
           scorer_weights:,
           # Signal source and evidence limits.
@@ -184,6 +200,10 @@ module XTwitterScraper
               follow_up_questions: T::Array[String],
               intent_url: String,
               next_step: String,
+              radar_recommendations:
+                T::Array[
+                  XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation
+                ],
               scorer_weights:
                 T::Array[
                   XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::ScorerWeight
@@ -254,6 +274,128 @@ module XTwitterScraper
           end
         end
 
+        class RadarRecommendation < XTwitterScraper::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation,
+                XTwitterScraper::Internal::AnyHash
+              )
+            end
+
+          # Radar endpoint for this source.
+          sig { returns(String) }
+          attr_accessor :endpoint
+
+          # Source-specific drafting guidance.
+          sig { returns(String) }
+          attr_accessor :guidance
+
+          sig do
+            returns(
+              XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source::TaggedSymbol
+            )
+          end
+          attr_accessor :source
+
+          # Current-topic research this source supports.
+          sig { returns(String) }
+          attr_accessor :use_for
+
+          sig do
+            params(
+              endpoint: String,
+              guidance: String,
+              source:
+                XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source::OrSymbol,
+              use_for: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Radar endpoint for this source.
+            endpoint:,
+            # Source-specific drafting guidance.
+            guidance:,
+            source:,
+            # Current-topic research this source supports.
+            use_for:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                endpoint: String,
+                guidance: String,
+                source:
+                  XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source::TaggedSymbol,
+                use_for: String
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module Source
+            extend XTwitterScraper::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            REDDIT =
+              T.let(
+                :reddit,
+                XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source::TaggedSymbol
+              )
+            GITHUB =
+              T.let(
+                :github,
+                XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source::TaggedSymbol
+              )
+            TRUSTMRR =
+              T.let(
+                :trustmrr,
+                XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source::TaggedSymbol
+              )
+            HACKER_NEWS =
+              T.let(
+                :hacker_news,
+                XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source::TaggedSymbol
+              )
+            GOOGLE_TRENDS =
+              T.let(
+                :google_trends,
+                XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source::TaggedSymbol
+              )
+            WIKIPEDIA =
+              T.let(
+                :wikipedia,
+                XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source::TaggedSymbol
+              )
+            POLYMARKET =
+              T.let(
+                :polymarket,
+                XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult::RadarRecommendation::Source::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         class ScorerWeight < XTwitterScraper::Internal::Type::BaseModel
           OrHash =
             T.type_alias do

data/rbi/x_twitter_scraper/models/content_disclosure.rbi

@@ -98,13 +98,6 @@ module XTwitterScraper
             )
           end
 
-        # Whether the disclosure can be edited on X.
-        sig { returns(T.nilable(T::Boolean)) }
-        attr_reader :can_edit
-
-        sig { params(can_edit: T::Boolean).void }
-        attr_writer :can_edit
-
         # Source of the AI-generated media disclosure.
         sig { returns(T.nilable(String)) }
         attr_reader :detection_source
@@ -121,14 +114,11 @@ module XTwitterScraper
 
         sig do
           params(
-            can_edit: T::Boolean,
             detection_source: String,
             has_ai_generated_media: T::Boolean
           ).returns(T.attached_class)
         end
         def self.new(
-          # Whether the disclosure can be edited on X.
-          can_edit: nil,
           # Source of the AI-generated media disclosure.
           detection_source: nil,
           # True when X labels the tweet as containing AI-generated media.
@@ -138,11 +128,7 @@ module XTwitterScraper
 
         sig do
           override.returns(
-            {
-              can_edit: T::Boolean,
-              detection_source: String,
-              has_ai_generated_media: T::Boolean
-            }
+            { detection_source: String, has_ai_generated_media: T::Boolean }
           )
         end
         def to_hash