x-twitter-scraper 0.7.2 → 0.9.0

data/rbi/x_twitter_scraper/resources/guest_wallets.rbi

@@ -8,11 +8,9 @@ module XTwitterScraper
   module Resources
     # Accountless prepaid access for paid read endpoints
     class GuestWallets
-      # Create a one-use Stripe-hosted checkout after the user explicitly confirms a
-      # $10-$250 USD amount. This request creates no charge by itself. The user opens
-      # checkout_url on Stripe. This endpoint returns the paid-read API key without
-      # requiring an Xquik account, email, dashboard, or Xquik web page. An idempotent
-      # replay returns the same key.
+      # Create a one-use hosted checkout after the user confirms $10-$250 USD. The
+      # request creates no charge. It returns a paid-read API key without an Xquik
+      # account. Replays return the same key.
       sig do
         params(
           amount_minor: Integer,
@@ -34,10 +32,9 @@ module XTwitterScraper
       )
       end
 
-      # Poll after Stripe payment. Use usable to decide whether paid reads can run. An
-      # active wallet can remain usable while a top-up is pending. A new wallet becomes
-      # usable only after verified webhook fulfillment. Send the guest key as
-      # Authorization: Bearer.
+      # Poll after payment. Use usable to decide whether paid reads can run. An active
+      # wallet can remain usable while a top-up is pending. A new wallet becomes usable
+      # only after payment is verified. Send the guest key as Authorization: Bearer.
       sig do
         params(
           request_options: XTwitterScraper::RequestOptions::OrHash
@@ -46,10 +43,9 @@ module XTwitterScraper
       def retrieve_status(request_options: {})
       end
 
-      # Create a one-use Stripe-hosted checkout for an existing paid-read guest key
-      # after the user explicitly confirms a $10-$250 USD amount. The key remains the
-      # same. This request creates no charge by itself and never redirects through an
-      # Xquik web page.
+      # Create a one-use hosted checkout after the user confirms a $10-$250 USD amount
+      # for an existing paid-read guest key. The key remains the same. This request
+      # creates no charge and never redirects through Xquik.
       sig do
         params(
           amount_minor: Integer,

data/rbi/x_twitter_scraper/resources/support/attachments.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module XTwitterScraper
+  module Resources
+    class Support
+      # Support ticket management
+      class Attachments
+        # Streams an authenticated user's support image or video. Video requests support
+        # one standard byte range for seeking and resumable playback.
+        sig do
+          params(
+            id: String,
+            range: String,
+            request_options: XTwitterScraper::RequestOptions::OrHash
+          ).returns(StringIO)
+        end
+        def download(
+          # Support attachment public ID
+          id,
+          # Optional single byte range
+          range: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig do
+          params(client: XTwitterScraper::Client).returns(T.attached_class)
+        end
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/x_twitter_scraper/resources/support.rbi

@@ -7,6 +7,10 @@
 module XTwitterScraper
   module Resources
     class Support
+      # Support ticket management
+      sig { returns(XTwitterScraper::Resources::Support::Attachments) }
+      attr_reader :attachments
+
       # Support ticket management
       sig { returns(XTwitterScraper::Resources::Support::Tickets) }
       attr_reader :tickets

data/rbi/x_twitter_scraper/resources/x/communities.rbi

@@ -86,20 +86,62 @@ module XTwitterScraper
         sig do
           params(
             id: String,
+            bio_contains: String,
             cursor: String,
+            has_location: T::Boolean,
+            has_website: T::Boolean,
+            location_contains: String,
+            max_followers: Integer,
+            max_following: Integer,
+            max_statuses: Integer,
+            min_account_age_days: Integer,
+            min_followers: Integer,
+            min_following: Integer,
+            min_statuses: Integer,
             page_size: Integer,
+            username_contains: String,
+            verified_only: T::Boolean,
+            verified_type: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(XTwitterScraper::PaginatedUsers)
         end
         def retrieve_members(
           # Community ID for member lookup
           id,
+          # Match any comma-separated or line-separated bio term, ignoring case.
+          bio_contains: nil,
           # Pagination cursor
           cursor: nil,
+          # Only return profiles with a location.
+          has_location: nil,
+          # Only return profiles with a website.
+          has_website: nil,
+          # Match a location substring, ignoring case.
+          location_contains: nil,
+          # Maximum follower count. Missing counts pass this maximum.
+          max_followers: nil,
+          # Maximum following count.
+          max_following: nil,
+          # Maximum post count. maxPosts is also accepted.
+          max_statuses: nil,
+          # Minimum account age in whole days.
+          min_account_age_days: nil,
+          # Minimum follower count. Filtering happens before billing.
+          min_followers: nil,
+          # Minimum following count.
+          min_following: nil,
+          # Minimum post count. minPosts is also accepted.
+          min_statuses: nil,
           # Items per page (20-200, default 20). This is an upper bound for paid
           # authenticated calls: remaining credits can reduce the returned page size, and
           # zero affordable results returns 402 insufficient_credits.
           page_size: nil,
+          # Match a username substring, ignoring case.
+          username_contains: nil,
+          # Only return verified profiles.
+          verified_only: nil,
+          # Match the verification type exactly, ignoring case.
+          verified_type: nil,
           request_options: {}
         )
         end
@@ -108,15 +150,57 @@ module XTwitterScraper
         sig do
           params(
             id: String,
+            bio_contains: String,
             cursor: String,
+            has_location: T::Boolean,
+            has_website: T::Boolean,
+            location_contains: String,
+            max_followers: Integer,
+            max_following: Integer,
+            max_statuses: Integer,
+            min_account_age_days: Integer,
+            min_followers: Integer,
+            min_following: Integer,
+            min_statuses: Integer,
+            username_contains: String,
+            verified_only: T::Boolean,
+            verified_type: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(XTwitterScraper::PaginatedUsers)
         end
         def retrieve_moderators(
           # Community ID for moderator lookup
           id,
+          # Match any comma-separated or line-separated bio term, ignoring case.
+          bio_contains: nil,
           # Pagination cursor for community moderators
           cursor: nil,
+          # Only return profiles with a location.
+          has_location: nil,
+          # Only return profiles with a website.
+          has_website: nil,
+          # Match a location substring, ignoring case.
+          location_contains: nil,
+          # Maximum follower count. Missing counts pass this maximum.
+          max_followers: nil,
+          # Maximum following count.
+          max_following: nil,
+          # Maximum post count. maxPosts is also accepted.
+          max_statuses: nil,
+          # Minimum account age in whole days.
+          min_account_age_days: nil,
+          # Minimum follower count. Filtering happens before billing.
+          min_followers: nil,
+          # Minimum following count.
+          min_following: nil,
+          # Minimum post count. minPosts is also accepted.
+          min_statuses: nil,
+          # Match a username substring, ignoring case.
+          username_contains: nil,
+          # Only return verified profiles.
+          verified_only: nil,
+          # Match the verification type exactly, ignoring case.
+          verified_type: nil,
           request_options: {}
         )
         end

data/rbi/x_twitter_scraper/resources/x/lists.rbi

@@ -13,21 +13,62 @@ module XTwitterScraper
         sig do
           params(
             id: String,
+            bio_contains: String,
             cursor: String,
+            has_location: T::Boolean,
+            has_website: T::Boolean,
+            location_contains: String,
+            max_followers: Integer,
+            max_following: Integer,
+            max_statuses: Integer,
+            min_account_age_days: Integer,
+            min_followers: Integer,
+            min_following: Integer,
+            min_statuses: Integer,
             page_size: Integer,
+            username_contains: String,
+            verified_only: T::Boolean,
+            verified_type: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(XTwitterScraper::PaginatedUsers)
         end
         def retrieve_followers(
           # List ID
           id,
+          # Match any comma-separated or line-separated bio term, ignoring case.
+          bio_contains: nil,
           # Pagination cursor for list followers
           cursor: nil,
-          # Maximum user profiles requested from this page (20-200, default 200). The
-          # response can contain fewer profiles because the source returned fewer or
-          # remaining credits cover fewer results. Keep requesting next_cursor while
-          # has_next_page is true. The deprecated limit and count aliases remain accepted.
+          # Only return profiles with a location.
+          has_location: nil,
+          # Only return profiles with a website.
+          has_website: nil,
+          # Match a location substring, ignoring case.
+          location_contains: nil,
+          # Maximum follower count. Missing counts pass this maximum.
+          max_followers: nil,
+          # Maximum following count.
+          max_following: nil,
+          # Maximum post count. maxPosts is also accepted.
+          max_statuses: nil,
+          # Minimum account age in whole days.
+          min_account_age_days: nil,
+          # Minimum follower count. Filtering happens before billing.
+          min_followers: nil,
+          # Minimum following count.
+          min_following: nil,
+          # Minimum post count. minPosts is also accepted.
+          min_statuses: nil,
+          # Maximum user profiles requested from this page (20-200, default 200). Source,
+          # filters, or credits can return fewer profiles. Keep requesting next_cursor while
+          # has_next_page is true. Deprecated aliases remain accepted.
           page_size: nil,
+          # Match a username substring, ignoring case.
+          username_contains: nil,
+          # Only return verified profiles.
+          verified_only: nil,
+          # Match the verification type exactly, ignoring case.
+          verified_type: nil,
           request_options: {}
         )
         end
@@ -36,18 +77,60 @@ module XTwitterScraper
         sig do
           params(
             id: String,
+            bio_contains: String,
             cursor: String,
+            has_location: T::Boolean,
+            has_website: T::Boolean,
+            location_contains: String,
+            max_followers: Integer,
+            max_following: Integer,
+            max_statuses: Integer,
+            min_account_age_days: Integer,
+            min_followers: Integer,
+            min_following: Integer,
+            min_statuses: Integer,
             page_size: Integer,
+            username_contains: String,
+            verified_only: T::Boolean,
+            verified_type: String,
             request_options: XTwitterScraper::RequestOptions::OrHash
           ).returns(XTwitterScraper::PaginatedUsers)
         end
         def retrieve_members(
           # List ID for member lookup
           id,
+          # Match any comma-separated or line-separated bio term, ignoring case.
+          bio_contains: nil,
           # Pagination cursor for list members
           cursor: nil,
+          # Only return profiles with a location.
+          has_location: nil,
+          # Only return profiles with a website.
+          has_website: nil,
+          # Match a location substring, ignoring case.
+          location_contains: nil,
+          # Maximum follower count. Missing counts pass this maximum.
+          max_followers: nil,
+          # Maximum following count.
+          max_following: nil,
+          # Maximum post count. maxPosts is also accepted.
+          max_statuses: nil,
+          # Minimum account age in whole days.
+          min_account_age_days: nil,
+          # Minimum follower count. Filtering happens before billing.
+          min_followers: nil,
+          # Minimum following count.
+          min_following: nil,
+          # Minimum post count. minPosts is also accepted.
+          min_statuses: nil,
           # Members per page (20-200, default 20)
           page_size: nil,
+          # Match a username substring, ignoring case.
+          username_contains: nil,
+          # Only return verified profiles.
+          verified_only: nil,
+          # Match the verification type exactly, ignoring case.
+          verified_type: nil,
           request_options: {}
         )
         end