onlyfans 0.2.0 → 0.3.0

data/rbi/onlyfans/models/data_export_create_params.rbi

@@ -16,8 +16,9 @@ module Onlyfans
       attr_accessor :end_date
 
       # The output file format. Supported formats vary by export type: `csv` or `xlsx`
-      # for transactions, chat_messages, trial_links, tracking_links, smart_links,
-      # payouts, chargebacks, public_profiles, fans, followings; `zip` for media_vault.
+      # for transactions, chat_messages, fansly_chat_messages, trial_links,
+      # tracking_links, smart_links, payouts, chargebacks, public_profiles, fans,
+      # followings, profile_visitors; `zip` for media_vault.
       sig { returns(Onlyfans::DataExportCreateParams::FileType::OrSymbol) }
       attr_accessor :file_type
 
@@ -25,12 +26,16 @@ module Onlyfans
       sig { returns(String) }
       attr_accessor :start_date
 
-      # The type of data to export
+      # The type of data to export. Use `fansly_chat_messages` to export Fansly chat
+      # messages (all other types are OnlyFans). `profile_visitors` returns one row per
+      # account per day, scraped one day at a time so the daily numbers are not
+      # aggregated away by OnlyFans.
       sig { returns(Onlyfans::DataExportCreateParams::Type::OrSymbol) }
       attr_accessor :type
 
       # Array of account prefixed IDs to export data from. Not required for
-      # `public_profiles` type.
+      # `public_profiles` type. For `fansly_chat_messages`, pass Fansly account prefixed
+      # IDs (`fansly_acct_...`); all other types take OnlyFans account IDs.
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :account_ids
 
@@ -56,19 +61,23 @@ module Onlyfans
       # account, max 10,000,000), `maxChats` (optional per-account chat scrape limit),
       # `skipMassMessages` (optional, bool), `chatIds` (optional array of numeric
       # fan/chat IDs; filters output and can drastically reduce totals). For
-      # `media_vault`: `mediaType` (required, one of: `all`, `photo`, `gif`, `video`,
-      # `audio`). For `fans`: `type` (required, one of: `all`, `active`, `expired`,
-      # `latest`). For `followings`: `type` (required, one of: `all`, `active`,
-      # `expired`). For `public_profiles`: `query` (optional, full-text search),
-      # `gender` (optional, filter: male, female, trans, couple), `minSubscribePrice`
-      # (optional, USD), `maxSubscribePrice` (optional, USD), `location` (optional),
-      # `minPostsCount` (optional, minimum posts), `minPhotosCount` (optional, minimum
-      # photos), `minVideosCount` (optional, minimum videos), `minSubscribersCount`
-      # (optional, minimum subscribers), `minJoinDate` (optional, ISO 8601 date),
-      # `minLastSeenAt` (optional, ISO 8601 date), `createdAtFrom` (optional, ISO 8601
-      # date, profile added to DB after), `createdAtTo` (optional, ISO 8601 date,
-      # profile added to DB before), `instagram` (optional), `twitter` (optional),
-      # `tiktok` (optional), `maxResults` (optional, limit results).
+      # `fansly_chat_messages`: `maxMessages` (required per account, max 10,000,000),
+      # `maxChats` (optional per-account chat scrape limit), `chatIds` (optional array
+      # of Fansly group ID strings; filters output and can drastically reduce totals).
+      # For `media_vault`: `mediaType` (required, one of: `all`, `photo`, `gif`,
+      # `video`, `audio`). For `fans`: `type` (required, one of: `all`, `active`,
+      # `expired`, `latest`). For `followings`: `type` (required, one of: `all`,
+      # `active`, `expired`). For `public_profiles`: `query` (optional, full-text
+      # search), `gender` (optional, filter: male, female, trans, couple),
+      # `minSubscribePrice` (optional, USD), `maxSubscribePrice` (optional, USD),
+      # `location` (optional), `minPostsCount` (optional, minimum posts),
+      # `minPhotosCount` (optional, minimum photos), `minVideosCount` (optional, minimum
+      # videos), `minSubscribersCount` (optional, minimum subscribers),
+      # `maxSubscribersCount` (optional, maximum subscribers), `minJoinDate` (optional,
+      # ISO 8601 date), `minLastSeenAt` (optional, ISO 8601 date), `createdAtFrom`
+      # (optional, ISO 8601 date, profile added to DB after), `createdAtTo` (optional,
+      # ISO 8601 date, profile added to DB before), `instagram` (optional), `twitter`
+      # (optional), `tiktok` (optional), `maxResults` (optional, limit results).
       sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
       attr_reader :options
 
@@ -92,15 +101,20 @@ module Onlyfans
         # The end date for the export (ISO 8601 format).
         end_date:,
         # The output file format. Supported formats vary by export type: `csv` or `xlsx`
-        # for transactions, chat_messages, trial_links, tracking_links, smart_links,
-        # payouts, chargebacks, public_profiles, fans, followings; `zip` for media_vault.
+        # for transactions, chat_messages, fansly_chat_messages, trial_links,
+        # tracking_links, smart_links, payouts, chargebacks, public_profiles, fans,
+        # followings, profile_visitors; `zip` for media_vault.
         file_type:,
         # The start date for the export (ISO 8601 format).
         start_date:,
-        # The type of data to export
+        # The type of data to export. Use `fansly_chat_messages` to export Fansly chat
+        # messages (all other types are OnlyFans). `profile_visitors` returns one row per
+        # account per day, scraped one day at a time so the daily numbers are not
+        # aggregated away by OnlyFans.
         type:,
         # Array of account prefixed IDs to export data from. Not required for
-        # `public_profiles` type.
+        # `public_profiles` type. For `fansly_chat_messages`, pass Fansly account prefixed
+        # IDs (`fansly_acct_...`); all other types take OnlyFans account IDs.
         account_ids: nil,
         # When true, automatically starts the export after creation.
         auto_start: nil,
@@ -111,19 +125,23 @@ module Onlyfans
         # account, max 10,000,000), `maxChats` (optional per-account chat scrape limit),
         # `skipMassMessages` (optional, bool), `chatIds` (optional array of numeric
         # fan/chat IDs; filters output and can drastically reduce totals). For
-        # `media_vault`: `mediaType` (required, one of: `all`, `photo`, `gif`, `video`,
-        # `audio`). For `fans`: `type` (required, one of: `all`, `active`, `expired`,
-        # `latest`). For `followings`: `type` (required, one of: `all`, `active`,
-        # `expired`). For `public_profiles`: `query` (optional, full-text search),
-        # `gender` (optional, filter: male, female, trans, couple), `minSubscribePrice`
-        # (optional, USD), `maxSubscribePrice` (optional, USD), `location` (optional),
-        # `minPostsCount` (optional, minimum posts), `minPhotosCount` (optional, minimum
-        # photos), `minVideosCount` (optional, minimum videos), `minSubscribersCount`
-        # (optional, minimum subscribers), `minJoinDate` (optional, ISO 8601 date),
-        # `minLastSeenAt` (optional, ISO 8601 date), `createdAtFrom` (optional, ISO 8601
-        # date, profile added to DB after), `createdAtTo` (optional, ISO 8601 date,
-        # profile added to DB before), `instagram` (optional), `twitter` (optional),
-        # `tiktok` (optional), `maxResults` (optional, limit results).
+        # `fansly_chat_messages`: `maxMessages` (required per account, max 10,000,000),
+        # `maxChats` (optional per-account chat scrape limit), `chatIds` (optional array
+        # of Fansly group ID strings; filters output and can drastically reduce totals).
+        # For `media_vault`: `mediaType` (required, one of: `all`, `photo`, `gif`,
+        # `video`, `audio`). For `fans`: `type` (required, one of: `all`, `active`,
+        # `expired`, `latest`). For `followings`: `type` (required, one of: `all`,
+        # `active`, `expired`). For `public_profiles`: `query` (optional, full-text
+        # search), `gender` (optional, filter: male, female, trans, couple),
+        # `minSubscribePrice` (optional, USD), `maxSubscribePrice` (optional, USD),
+        # `location` (optional), `minPostsCount` (optional, minimum posts),
+        # `minPhotosCount` (optional, minimum photos), `minVideosCount` (optional, minimum
+        # videos), `minSubscribersCount` (optional, minimum subscribers),
+        # `maxSubscribersCount` (optional, maximum subscribers), `minJoinDate` (optional,
+        # ISO 8601 date), `minLastSeenAt` (optional, ISO 8601 date), `createdAtFrom`
+        # (optional, ISO 8601 date, profile added to DB after), `createdAtTo` (optional,
+        # ISO 8601 date, profile added to DB before), `instagram` (optional), `twitter`
+        # (optional), `tiktok` (optional), `maxResults` (optional, limit results).
         options: nil,
         request_options: {}
       )
@@ -148,8 +166,9 @@ module Onlyfans
       end
 
       # The output file format. Supported formats vary by export type: `csv` or `xlsx`
-      # for transactions, chat_messages, trial_links, tracking_links, smart_links,
-      # payouts, chargebacks, public_profiles, fans, followings; `zip` for media_vault.
+      # for transactions, chat_messages, fansly_chat_messages, trial_links,
+      # tracking_links, smart_links, payouts, chargebacks, public_profiles, fans,
+      # followings, profile_visitors; `zip` for media_vault.
       module FileType
         extend Onlyfans::Internal::Type::Enum
 
@@ -175,7 +194,10 @@ module Onlyfans
         end
       end
 
-      # The type of data to export
+      # The type of data to export. Use `fansly_chat_messages` to export Fansly chat
+      # messages (all other types are OnlyFans). `profile_visitors` returns one row per
+      # account per day, scraped one day at a time so the daily numbers are not
+      # aggregated away by OnlyFans.
       module Type
         extend Onlyfans::Internal::Type::Enum
 
@@ -232,6 +254,16 @@ module Onlyfans
             :followings,
             Onlyfans::DataExportCreateParams::Type::TaggedSymbol
           )
+        PROFILE_VISITORS =
+          T.let(
+            :profile_visitors,
+            Onlyfans::DataExportCreateParams::Type::TaggedSymbol
+          )
+        FANSLY_CHAT_MESSAGES =
+          T.let(
+            :fansly_chat_messages,
+            Onlyfans::DataExportCreateParams::Type::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/onlyfans/models/data_export_list_params.rbi

@@ -170,6 +170,11 @@ module Onlyfans
             :tracking_links,
             Onlyfans::DataExportListParams::Type::TaggedSymbol
           )
+        SMART_LINKS =
+          T.let(
+            :smart_links,
+            Onlyfans::DataExportListParams::Type::TaggedSymbol
+          )
         PAYOUTS =
           T.let(:payouts, Onlyfans::DataExportListParams::Type::TaggedSymbol)
         CHARGEBACKS =
@@ -182,6 +187,19 @@ module Onlyfans
             :public_profiles,
             Onlyfans::DataExportListParams::Type::TaggedSymbol
           )
+        FANS = T.let(:fans, Onlyfans::DataExportListParams::Type::TaggedSymbol)
+        FOLLOWINGS =
+          T.let(:followings, Onlyfans::DataExportListParams::Type::TaggedSymbol)
+        PROFILE_VISITORS =
+          T.let(
+            :profile_visitors,
+            Onlyfans::DataExportListParams::Type::TaggedSymbol
+          )
+        FANSLY_CHAT_MESSAGES =
+          T.let(
+            :fansly_chat_messages,
+            Onlyfans::DataExportListParams::Type::TaggedSymbol
+          )
 
         sig do
           override.returns(

data/rbi/onlyfans/models/data_export_list_response.rbi

@@ -423,6 +423,12 @@ module Onlyfans
           sig { returns(T.nilable(String)) }
           attr_accessor :failed_at
 
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :failed_downloads
+
+          sig { params(failed_downloads: Integer).void }
+          attr_writer :failed_downloads
+
           sig { returns(T.nilable(String)) }
           attr_accessor :failed_reason
 
@@ -483,6 +489,7 @@ module Onlyfans
               end_date: String,
               export_columns: T::Array[String],
               failed_at: T.nilable(String),
+              failed_downloads: Integer,
               failed_reason: T.nilable(String),
               file_type: String,
               progress_percentage: Integer,
@@ -504,6 +511,7 @@ module Onlyfans
             end_date: nil,
             export_columns: nil,
             failed_at: nil,
+            failed_downloads: nil,
             failed_reason: nil,
             file_type: nil,
             progress_percentage: nil,
@@ -531,6 +539,7 @@ module Onlyfans
                 end_date: String,
                 export_columns: T::Array[String],
                 failed_at: T.nilable(String),
+                failed_downloads: Integer,
                 failed_reason: T.nilable(String),
                 file_type: String,
                 progress_percentage: Integer,

data/rbi/onlyfans/models/data_export_retrieve_response.rbi

@@ -349,6 +349,12 @@ module Onlyfans
         sig { returns(T.nilable(String)) }
         attr_accessor :failed_at
 
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :failed_downloads
+
+        sig { params(failed_downloads: Integer).void }
+        attr_writer :failed_downloads
+
         sig { returns(T.nilable(String)) }
         attr_accessor :failed_reason
 
@@ -407,6 +413,7 @@ module Onlyfans
             end_date: String,
             export_columns: T::Array[String],
             failed_at: T.nilable(String),
+            failed_downloads: Integer,
             failed_reason: T.nilable(String),
             file_type: String,
             progress_percentage: Integer,
@@ -426,6 +433,7 @@ module Onlyfans
           end_date: nil,
           export_columns: nil,
           failed_at: nil,
+          failed_downloads: nil,
           failed_reason: nil,
           file_type: nil,
           progress_percentage: nil,
@@ -451,6 +459,7 @@ module Onlyfans
               end_date: String,
               export_columns: T::Array[String],
               failed_at: T.nilable(String),
+              failed_downloads: Integer,
               failed_reason: T.nilable(String),
               file_type: String,
               progress_percentage: Integer,

data/rbi/onlyfans/models/engagement/message_get_message_buyers_params.rbi

@@ -42,7 +42,7 @@ module Onlyfans
         sig { params(offset: Integer).void }
         attr_writer :offset
 
-        # Optional flag for subsequent pages (example: all)
+        # Optional flag for subsequent pages (example: all).
         sig { returns(T.nilable(String)) }
         attr_reader :skip_users
 
@@ -77,7 +77,7 @@ module Onlyfans
           marker: nil,
           # Offset for pagination (default = 0)
           offset: nil,
-          # Optional flag for subsequent pages (example: all)
+          # Optional flag for subsequent pages (example: all).
           skip_users: nil,
           # Skip duplicate users in results (0/1). Default = 1
           skip_users_dups: nil,

data/rbi/onlyfans/models/engagement/message_get_top_message_params.rbi

@@ -18,8 +18,8 @@ module Onlyfans
         sig { returns(String) }
         attr_accessor :account
 
-        # The end date for the period. Keep empty to retrieve until now. MUST BE DATE
-        # AFTER `startDate`.
+        # The end date for the period. Keep empty to retrieve until now. It must be after
+        # `startDate`.
         sig { returns(T.nilable(String)) }
         attr_reader :end_date
 
@@ -43,8 +43,8 @@ module Onlyfans
         end
         def self.new(
           account:,
-          # The end date for the period. Keep empty to retrieve until now. MUST BE DATE
-          # AFTER `startDate`.
+          # The end date for the period. Keep empty to retrieve until now. It must be after
+          # `startDate`.
           end_date: nil,
           # The start date for the period. Keep empty to retrieve from the model start date.
           start_date: nil,

data/rbi/onlyfans/models/engagement/messages/direct_message_chart_params.rbi

@@ -19,7 +19,7 @@ module Onlyfans
           sig { returns(String) }
           attr_accessor :account
 
-          # End of the chart window in `Y-m-d H:i:s` format. Must be after `startDate`.
+          # End of the chart window in `Y-m-d H:i:s` format. It must be after `startDate`.
           sig { returns(T.nilable(String)) }
           attr_reader :end_date
 
@@ -51,7 +51,7 @@ module Onlyfans
           end
           def self.new(
             account:,
-            # End of the chart window in `Y-m-d H:i:s` format. Must be after `startDate`.
+            # End of the chart window in `Y-m-d H:i:s` format. It must be after `startDate`.
             end_date: nil,
             # Start of the chart window in `Y-m-d H:i:s` format.
             start_date: nil,

data/rbi/onlyfans/models/engagement/messages/direct_message_list_params.rbi

@@ -19,8 +19,8 @@ module Onlyfans
           sig { returns(String) }
           attr_accessor :account
 
-          # The latest message to retrieve. Keep empty to get all. MUST BE DATE AFTER
-          # `startDate`. This is also used for pagination.
+          # The latest message to retrieve. Keep empty to get all. It must be after
+          # `startDate` and is also used for pagination.
           sig { returns(T.nilable(String)) }
           attr_reader :end_date
 
@@ -68,8 +68,8 @@ module Onlyfans
           end
           def self.new(
             account:,
-            # The latest message to retrieve. Keep empty to get all. MUST BE DATE AFTER
-            # `startDate`. This is also used for pagination.
+            # The latest message to retrieve. Keep empty to get all. It must be after
+            # `startDate` and is also used for pagination.
             end_date: nil,
             # Number of messages to return (default = 10)
             limit: nil,

data/rbi/onlyfans/models/engagement/messages/mass_message_chart_params.rbi

@@ -19,7 +19,7 @@ module Onlyfans
           sig { returns(String) }
           attr_accessor :account
 
-          # End of the chart window in `Y-m-d H:i:s` format. Must be after `startDate`.
+          # End of the chart window in `Y-m-d H:i:s` format. It must be after `startDate`.
           sig { returns(T.nilable(String)) }
           attr_reader :end_date
 
@@ -51,7 +51,7 @@ module Onlyfans
           end
           def self.new(
             account:,
-            # End of the chart window in `Y-m-d H:i:s` format. Must be after `startDate`.
+            # End of the chart window in `Y-m-d H:i:s` format. It must be after `startDate`.
             end_date: nil,
             # Start of the chart window in `Y-m-d H:i:s` format.
             start_date: nil,

data/rbi/onlyfans/models/engagement/messages/mass_message_list_params.rbi

@@ -19,8 +19,8 @@ module Onlyfans
           sig { returns(String) }
           attr_accessor :account
 
-          # The latest message to retrieve. Keep empty to get all. MUST BE DATE AFTER
-          # `startDate`. This is also used for pagination.
+          # The latest message to retrieve. Keep empty to get all. It must be after
+          # `startDate` and is also used for pagination.
           sig { returns(T.nilable(String)) }
           attr_reader :end_date
 
@@ -60,8 +60,8 @@ module Onlyfans
           end
           def self.new(
             account:,
-            # The latest message to retrieve. Keep empty to get all. MUST BE DATE AFTER
-            # `startDate`. This is also used for pagination.
+            # The latest message to retrieve. Keep empty to get all. It must be after
+            # `startDate` and is also used for pagination.
             end_date: nil,
             # Number of messages to return (default = 10)
             limit: nil,

data/rbi/onlyfans/models/fan_list_active_params.rbi

@@ -20,8 +20,8 @@ module Onlyfans
       sig { params(filter: Onlyfans::FanListActiveParams::Filter::OrHash).void }
       attr_writer :filter
 
-      # Number of fans to return (1-50). Must be at least 1. Must not be greater
-      # than 20.
+      # Number of fans to return (1-20). OnlyFans does not allow more than 20 per page.
+      # Must be at least 1. Must not be greater than 20.
       sig { returns(T.nilable(Integer)) }
       attr_reader :limit
 
@@ -60,8 +60,8 @@ module Onlyfans
       def self.new(
         account:,
         filter: nil,
-        # Number of fans to return (1-50). Must be at least 1. Must not be greater
-        # than 20.
+        # Number of fans to return (1-20). OnlyFans does not allow more than 20 per page.
+        # Must be at least 1. Must not be greater than 20.
         limit: nil,
         # Number of fans to skip. Must be at least 0.
         offset: nil,
@@ -98,14 +98,45 @@ module Onlyfans
             )
           end
 
-        # Filter by minimum subscription duration in months. Must be at least 0.
+        # Filter by minimum subscription duration in months. Must use bracket syntax:
+        # filter[duration]=1 — the dot form (filter.duration=1) is rejected with a 422,
+        # because PHP rewrites it to `filter_duration` and the filter could not be
+        # applied. Must be at least 0.
         sig { returns(T.nilable(Integer)) }
         attr_reader :duration
 
         sig { params(duration: Integer).void }
         attr_writer :duration
 
-        # Filter by online status (`1` for online fans).
+        # Filter by **maximum** amount total spent by a fan — use
+        # `filter[max_total_spent]=0` to isolate fans who have never spent. Combine with
+        # `filter[total_spent]` for a range. Must use bracket syntax:
+        # filter[max_total_spent]=0 — the dot form is rejected with a 422, because PHP
+        # rewrites it to `filter_max_total_spent` and the filter could not be applied.
+        #
+        # OnlyFans itself has no maximum-spend filter, so this one is resolved against
+        # OnlyFansAPI's own fan index instead of being proxied. The fan objects in
+        # `data.list` are still fetched live from OnlyFans and are re-checked against your
+        # filters before being returned, but only fans we have already indexed for this
+        # account can appear. Each response reports its own coverage under `data._source`;
+        # when `data._source.is_complete` is `false` a full-base backfill is queued
+        # automatically, so retry later for a complete answer.
+        #
+        # `data._source.omitted_from_page` counts fans that matched your filters but which
+        # OnlyFans returned no usable data for on that page (a deleted account, or a
+        # partial response). They are left out of `data.list` and not revisited later in
+        # the same walk, so a non-zero value means that page was short — start a fresh
+        # walk to retry them. Cannot be combined with `filter[online]`. Must be at
+        # least 0.
+        sig { returns(T.nilable(Float)) }
+        attr_reader :max_total_spent
+
+        sig { params(max_total_spent: Float).void }
+        attr_writer :max_total_spent
+
+        # Filter by online status (`1` for online fans). Must use bracket syntax:
+        # filter[online]=1 — the dot form (filter.online=1) is rejected with a 422,
+        # because PHP rewrites it to `filter_online` and the filter could not be applied.
         sig do
           returns(
             T.nilable(Onlyfans::FanListActiveParams::Filter::Online::OrInteger)
@@ -113,14 +144,19 @@ module Onlyfans
         end
         attr_accessor :online
 
-        # Filter by minimum tips. Must be at least 0.
+        # Filter by minimum tips. Must use bracket syntax: filter[tips]=100 — the dot form
+        # (filter.tips=100) is rejected with a 422, because PHP rewrites it to
+        # `filter_tips` and the filter could not be applied. Must be at least 0.
         sig { returns(T.nilable(Integer)) }
         attr_reader :tips
 
         sig { params(tips: Integer).void }
         attr_writer :tips
 
-        # Filter by minimum amount total spent by a fan. Must be at least 0.
+        # Filter by minimum amount total spent by a fan. Must use bracket syntax:
+        # filter[total_spent]=100 — the dot form (filter.total_spent=100) is rejected with
+        # a 422, because PHP rewrites it to `filter_total_spent` and the filter could not
+        # be applied. Must be at least 0.
         sig { returns(T.nilable(Integer)) }
         attr_reader :total_spent
 
@@ -130,6 +166,7 @@ module Onlyfans
         sig do
           params(
             duration: Integer,
+            max_total_spent: Float,
             online:
               T.nilable(
                 Onlyfans::FanListActiveParams::Filter::Online::OrInteger
@@ -139,13 +176,44 @@ module Onlyfans
           ).returns(T.attached_class)
         end
         def self.new(
-          # Filter by minimum subscription duration in months. Must be at least 0.
+          # Filter by minimum subscription duration in months. Must use bracket syntax:
+          # filter[duration]=1 — the dot form (filter.duration=1) is rejected with a 422,
+          # because PHP rewrites it to `filter_duration` and the filter could not be
+          # applied. Must be at least 0.
           duration: nil,
-          # Filter by online status (`1` for online fans).
+          # Filter by **maximum** amount total spent by a fan — use
+          # `filter[max_total_spent]=0` to isolate fans who have never spent. Combine with
+          # `filter[total_spent]` for a range. Must use bracket syntax:
+          # filter[max_total_spent]=0 — the dot form is rejected with a 422, because PHP
+          # rewrites it to `filter_max_total_spent` and the filter could not be applied.
+          #
+          # OnlyFans itself has no maximum-spend filter, so this one is resolved against
+          # OnlyFansAPI's own fan index instead of being proxied. The fan objects in
+          # `data.list` are still fetched live from OnlyFans and are re-checked against your
+          # filters before being returned, but only fans we have already indexed for this
+          # account can appear. Each response reports its own coverage under `data._source`;
+          # when `data._source.is_complete` is `false` a full-base backfill is queued
+          # automatically, so retry later for a complete answer.
+          #
+          # `data._source.omitted_from_page` counts fans that matched your filters but which
+          # OnlyFans returned no usable data for on that page (a deleted account, or a
+          # partial response). They are left out of `data.list` and not revisited later in
+          # the same walk, so a non-zero value means that page was short — start a fresh
+          # walk to retry them. Cannot be combined with `filter[online]`. Must be at
+          # least 0.
+          max_total_spent: nil,
+          # Filter by online status (`1` for online fans). Must use bracket syntax:
+          # filter[online]=1 — the dot form (filter.online=1) is rejected with a 422,
+          # because PHP rewrites it to `filter_online` and the filter could not be applied.
           online: nil,
-          # Filter by minimum tips. Must be at least 0.
+          # Filter by minimum tips. Must use bracket syntax: filter[tips]=100 — the dot form
+          # (filter.tips=100) is rejected with a 422, because PHP rewrites it to
+          # `filter_tips` and the filter could not be applied. Must be at least 0.
           tips: nil,
-          # Filter by minimum amount total spent by a fan. Must be at least 0.
+          # Filter by minimum amount total spent by a fan. Must use bracket syntax:
+          # filter[total_spent]=100 — the dot form (filter.total_spent=100) is rejected with
+          # a 422, because PHP rewrites it to `filter_total_spent` and the filter could not
+          # be applied. Must be at least 0.
           total_spent: nil
         )
         end
@@ -154,6 +222,7 @@ module Onlyfans
           override.returns(
             {
               duration: Integer,
+              max_total_spent: Float,
               online:
                 T.nilable(
                   Onlyfans::FanListActiveParams::Filter::Online::OrInteger
@@ -166,7 +235,9 @@ module Onlyfans
         def to_hash
         end
 
-        # Filter by online status (`1` for online fans).
+        # Filter by online status (`1` for online fans). Must use bracket syntax:
+        # filter[online]=1 — the dot form (filter.online=1) is rejected with a 422,
+        # because PHP rewrites it to `filter_online` and the filter could not be applied.
         module Online
           extend Onlyfans::Internal::Type::Enum