x-twitter-scraper 0.5.5 → 0.6.0

data/lib/x_twitter_scraper/models/x/x_account.rb

@@ -19,11 +19,11 @@ module XTwitterScraper
         required :created_at, Time, api_name: :createdAt
 
         # @!attribute health
-        #   Derived connection health. `healthy` = session active. `needsReauth` = user must
+        #   Derived connection health. `healthy` = ready to use. `needsReauth` = user must
         #   submit fresh credentials. `locked` = X locked the account; unlock on x.com
-        #   first. `suspended` = X banned the account. `recovering` = past cooldown, will
-        #   auto-retry on next use. `temporaryIssue` = temporary connection problem; retry
-        #   shortly.
+        #   first. `suspended` = X banned the account. `recovering` = cooldown ended; the
+        #   account can reconnect on its next use. `temporaryIssue` = temporary connection
+        #   problem; wait before the next use.
         #
         #   @return [Symbol, XTwitterScraper::Models::X::XAccount::Health]
         required :health, enum: -> { XTwitterScraper::X::XAccount::Health }
@@ -63,7 +63,7 @@ module XTwitterScraper
         #
         #   @param created_at [Time]
         #
-        #   @param health [Symbol, XTwitterScraper::Models::X::XAccount::Health] Derived connection health. `healthy` = session active. `needsReauth` = user must
+        #   @param health [Symbol, XTwitterScraper::Models::X::XAccount::Health] Derived connection health. `healthy` = ready to use. `needsReauth` = user must s
         #
         #   @param status [String]
         #
@@ -75,11 +75,11 @@ module XTwitterScraper
         #
         #   @param cookies_obtained_at [Time]
 
-        # Derived connection health. `healthy` = session active. `needsReauth` = user must
+        # Derived connection health. `healthy` = ready to use. `needsReauth` = user must
         # submit fresh credentials. `locked` = X locked the account; unlock on x.com
-        # first. `suspended` = X banned the account. `recovering` = past cooldown, will
-        # auto-retry on next use. `temporaryIssue` = temporary connection problem; retry
-        # shortly.
+        # first. `suspended` = X banned the account. `recovering` = cooldown ended; the
+        # account can reconnect on its next use. `temporaryIssue` = temporary connection
+        # problem; wait before the next use.
         #
         # @see XTwitterScraper::Models::X::XAccount#health
         module Health

data/lib/x_twitter_scraper/resources/compose.rb

@@ -8,10 +8,10 @@ module XTwitterScraper
   module Resources
     # AI tweet composition, drafts, writing styles, and radar
     class Compose
-      # Run one step of Xquik's three-step writing workflow. Compose returns questions
-      # and editorial rules. Refine returns goal-specific guidance. Score applies
-      # deterministic text checks. It does not predict reach or expose X ranking
-      # weights.
+      # Run one step of Xquik's three-step writing workflow. Compose returns questions,
+      # editorial rules, and source-specific Radar recommendations. Refine returns
+      # goal-specific guidance. Score applies deterministic text checks. It does not
+      # predict reach or expose X ranking weights.
       #
       # @overload create(body:, request_options: {})
       #

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

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module XTwitterScraper
+  module Resources
+    class X
+      # Connected X account management
+      class AccountConnectionAttempts
+        # Get X account connection status
+        #
+        # @overload retrieve(id, request_options: {})
+        #
+        # @param id [String] Connection attempt ID returned by `POST /x/accounts`.
+        #
+        # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptPending, XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptSuccess, XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionAttemptFailed, XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse::XAccountConnectionChallenge]
+        #
+        # @see XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveParams
+        def retrieve(id, params = {})
+          @client.request(
+            method: :get,
+            path: ["x/account-connection-attempts/%1$s", id],
+            model: XTwitterScraper::Models::X::AccountConnectionAttemptRetrieveResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [XTwitterScraper::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

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 [Object]
         #
         # @see XTwitterScraper::Models::X::AccountCreateParams
         def create(params)
@@ -32,7 +32,7 @@ module XTwitterScraper
             method: :post,
             path: "x/accounts",
             body: parsed,
-            model: XTwitterScraper::Models::X::AccountCreateResponse,
+            model: XTwitterScraper::Internal::Type::Unknown,
             options: options
           )
         end
@@ -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.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.6.0"
 end

data/lib/x_twitter_scraper.rb

@@ -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"
@@ -304,6 +306,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/radar_item.rbi

@@ -22,12 +22,24 @@ module XTwitterScraper
       sig { returns(Time) }
       attr_accessor :created_at
 
+      # BCP-47 language code. und means the source did not identify a language.
       sig { returns(String) }
       attr_accessor :language
 
       # Source-specific fields. Shape varies per source:
       #
-      # - reddit: { subreddit: string, author: string }
+      # - reddit: { author, authorId?, subreddit, subredditId?, subredditSubscribers?,
+      #   sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?,
+      #   numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?,
+      #   postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?,
+      #   editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?,
+      #   isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?,
+      #   isSelf?, isSpoiler?, isVideo?, locked?, stickied? }. `score` is Reddit's
+      #   public net score. Exact public upvote and downvote counts are not available.
+      #   Estimated counts derive from the public score and upvote ratio, which Reddit
+      #   may fuzz. Comment bodies are not included. Current items combine public
+      #   listing discovery with server-rendered post data and use `sourceFormat: html`;
+      #   `json` and `rss` remain for legacy rows.
       # - github: { starsToday: number }
       # - hacker_news: { points: number, numberComments: number }
       # - google_trends: { approxTraffic: number }
@@ -35,9 +47,19 @@ module XTwitterScraper
       # - wikipedia: { views: number }
       # - trustmrr: { mrr, growthPercent, last30Days, total, customers,
       #   activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
-      #   growthMrrPercent?, multiple?, paymentProvider?, rank? }
-      sig { returns(T::Hash[Symbol, T.anything]) }
-      attr_accessor :metadata
+      #   foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?,
+      #   multiple?, paymentProvider?, profitMarginLast30Days?, rank?,
+      #   revenuePerVisitor?, targetAudience?, visitorsLast30Days? } For the startup
+      #   growth source, xHandle is the founder's X username without @. The rank field
+      #   is the source's revenue rank. Result order represents reported 30-day
+      #   revenue-growth rank.
+      sig { returns(XTwitterScraper::RadarItem::Metadata) }
+      attr_reader :metadata
+
+      sig do
+        params(metadata: XTwitterScraper::RadarItem::Metadata::OrHash).void
+      end
+      attr_writer :metadata
 
       sig { returns(Time) }
       attr_accessor :published_at
@@ -64,6 +86,7 @@ module XTwitterScraper
       sig { params(description: String).void }
       attr_writer :description
 
+      # Source image. Startup growth items return the logo here.
       sig { returns(T.nilable(String)) }
       attr_reader :image_url
 
@@ -84,7 +107,7 @@ module XTwitterScraper
           category: XTwitterScraper::RadarItem::Category::OrSymbol,
           created_at: Time,
           language: String,
-          metadata: T::Hash[Symbol, T.anything],
+          metadata: XTwitterScraper::RadarItem::Metadata::OrHash,
           published_at: Time,
           region: String,
           score: Float,
@@ -101,10 +124,22 @@ module XTwitterScraper
         id:,
         category:,
         created_at:,
+        # BCP-47 language code. und means the source did not identify a language.
         language:,
         # Source-specific fields. Shape varies per source:
         #
-        # - reddit: { subreddit: string, author: string }
+        # - reddit: { author, authorId?, subreddit, subredditId?, subredditSubscribers?,
+        #   sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?,
+        #   numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?,
+        #   postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?,
+        #   editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?,
+        #   isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?,
+        #   isSelf?, isSpoiler?, isVideo?, locked?, stickied? }. `score` is Reddit's
+        #   public net score. Exact public upvote and downvote counts are not available.
+        #   Estimated counts derive from the public score and upvote ratio, which Reddit
+        #   may fuzz. Comment bodies are not included. Current items combine public
+        #   listing discovery with server-rendered post data and use `sourceFormat: html`;
+        #   `json` and `rss` remain for legacy rows.
         # - github: { starsToday: number }
         # - hacker_news: { points: number, numberComments: number }
         # - google_trends: { approxTraffic: number }
@@ -112,7 +147,12 @@ module XTwitterScraper
         # - wikipedia: { views: number }
         # - trustmrr: { mrr, growthPercent, last30Days, total, customers,
         #   activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
-        #   growthMrrPercent?, multiple?, paymentProvider?, rank? }
+        #   foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?,
+        #   multiple?, paymentProvider?, profitMarginLast30Days?, rank?,
+        #   revenuePerVisitor?, targetAudience?, visitorsLast30Days? } For the startup
+        #   growth source, xHandle is the founder's X username without @. The rank field
+        #   is the source's revenue rank. Result order represents reported 30-day
+        #   revenue-growth rank.
         metadata:,
         published_at:,
         region:,
@@ -122,6 +162,7 @@ module XTwitterScraper
         source_id:,
         title:,
         description: nil,
+        # Source image. Startup growth items return the logo here.
         image_url: nil,
         url: nil
       )
@@ -134,7 +175,7 @@ module XTwitterScraper
             category: XTwitterScraper::RadarItem::Category::TaggedSymbol,
             created_at: Time,
             language: String,
-            metadata: T::Hash[Symbol, T.anything],
+            metadata: XTwitterScraper::RadarItem::Metadata,
             published_at: Time,
             region: String,
             score: Float,
@@ -184,6 +225,202 @@ module XTwitterScraper
         end
       end
 
+      class Metadata < XTwitterScraper::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              XTwitterScraper::RadarItem::Metadata,
+              XTwitterScraper::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :author
+
+        sig { params(author: String).void }
+        attr_writer :author
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :content_url
+
+        sig { params(content_url: String).void }
+        attr_writer :content_url
+
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :estimated_downvotes
+
+        sig { params(estimated_downvotes: Integer).void }
+        attr_writer :estimated_downvotes
+
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :estimated_upvotes
+
+        sig { params(estimated_upvotes: Integer).void }
+        attr_writer :estimated_upvotes
+
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :number_comments
+
+        sig { params(number_comments: Integer).void }
+        attr_writer :number_comments
+
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :score
+
+        sig { params(score: Integer).void }
+        attr_writer :score
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :selftext
+
+        sig { params(selftext: String).void }
+        attr_writer :selftext
+
+        # Current items use html. json and rss are retained for legacy rows.
+        sig do
+          returns(
+            T.nilable(
+              XTwitterScraper::RadarItem::Metadata::SourceFormat::TaggedSymbol
+            )
+          )
+        end
+        attr_reader :source_format
+
+        sig do
+          params(
+            source_format:
+              XTwitterScraper::RadarItem::Metadata::SourceFormat::OrSymbol
+          ).void
+        end
+        attr_writer :source_format
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :subreddit
+
+        sig { params(subreddit: String).void }
+        attr_writer :subreddit
+
+        sig { returns(T.nilable(Float)) }
+        attr_reader :upvote_ratio
+
+        sig { params(upvote_ratio: Float).void }
+        attr_writer :upvote_ratio
+
+        # Source-specific fields. Shape varies per source:
+        #
+        # - reddit: { author, authorId?, subreddit, subredditId?, subredditSubscribers?,
+        #   sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?,
+        #   numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?,
+        #   postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?,
+        #   editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?,
+        #   isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?,
+        #   isSelf?, isSpoiler?, isVideo?, locked?, stickied? }. `score` is Reddit's
+        #   public net score. Exact public upvote and downvote counts are not available.
+        #   Estimated counts derive from the public score and upvote ratio, which Reddit
+        #   may fuzz. Comment bodies are not included. Current items combine public
+        #   listing discovery with server-rendered post data and use `sourceFormat: html`;
+        #   `json` and `rss` remain for legacy rows.
+        # - github: { starsToday: number }
+        # - hacker_news: { points: number, numberComments: number }
+        # - google_trends: { approxTraffic: number }
+        # - polymarket: { volume24hr: number }
+        # - wikipedia: { views: number }
+        # - trustmrr: { mrr, growthPercent, last30Days, total, customers,
+        #   activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
+        #   foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?,
+        #   multiple?, paymentProvider?, profitMarginLast30Days?, rank?,
+        #   revenuePerVisitor?, targetAudience?, visitorsLast30Days? } For the startup
+        #   growth source, xHandle is the founder's X username without @. The rank field
+        #   is the source's revenue rank. Result order represents reported 30-day
+        #   revenue-growth rank.
+        sig do
+          params(
+            author: String,
+            content_url: String,
+            estimated_downvotes: Integer,
+            estimated_upvotes: Integer,
+            number_comments: Integer,
+            score: Integer,
+            selftext: String,
+            source_format:
+              XTwitterScraper::RadarItem::Metadata::SourceFormat::OrSymbol,
+            subreddit: String,
+            upvote_ratio: Float
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          author: nil,
+          content_url: nil,
+          estimated_downvotes: nil,
+          estimated_upvotes: nil,
+          number_comments: nil,
+          score: nil,
+          selftext: nil,
+          # Current items use html. json and rss are retained for legacy rows.
+          source_format: nil,
+          subreddit: nil,
+          upvote_ratio: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              author: String,
+              content_url: String,
+              estimated_downvotes: Integer,
+              estimated_upvotes: Integer,
+              number_comments: Integer,
+              score: Integer,
+              selftext: String,
+              source_format:
+                XTwitterScraper::RadarItem::Metadata::SourceFormat::TaggedSymbol,
+              subreddit: String,
+              upvote_ratio: Float
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Current items use html. json and rss are retained for legacy rows.
+        module SourceFormat
+          extend XTwitterScraper::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, XTwitterScraper::RadarItem::Metadata::SourceFormat)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          HTML =
+            T.let(
+              :html,
+              XTwitterScraper::RadarItem::Metadata::SourceFormat::TaggedSymbol
+            )
+          JSON =
+            T.let(
+              :json,
+              XTwitterScraper::RadarItem::Metadata::SourceFormat::TaggedSymbol
+            )
+          RSS =
+            T.let(
+              :rss,
+              XTwitterScraper::RadarItem::Metadata::SourceFormat::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                XTwitterScraper::RadarItem::Metadata::SourceFormat::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
       module Source
         extend XTwitterScraper::Internal::Type::Enum