x-twitter-scraper 0.4.5 → 0.5.2

data/lib/x_twitter_scraper/resources/compose.rb

@@ -4,35 +4,17 @@ module XTwitterScraper
   module Resources
     # AI tweet composition, drafts, writing styles, and radar
     class Compose
-      # Compose, refine, or score a tweet
+      # 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.
       #
-      # @overload create(step:, additional_context: nil, call_to_action: nil, draft: nil, goal: nil, has_link: nil, has_media: nil, media_type: nil, style_username: nil, tone: nil, topic: nil, request_options: {})
-      #
-      # @param step [Symbol, XTwitterScraper::Models::ComposeCreateParams::Step] Workflow step
-      #
-      # @param additional_context [String] Extra context or URLs (refine)
-      #
-      # @param call_to_action [String] Desired call to action (refine)
-      #
-      # @param draft [String] Tweet draft text to evaluate (score)
-      #
-      # @param goal [Symbol, XTwitterScraper::Models::ComposeCreateParams::Goal] Optimization goal
-      #
-      # @param has_link [Boolean] Whether a link is attached (score)
-      #
-      # @param has_media [Boolean] Whether media is attached (score)
-      #
-      # @param media_type [Symbol, XTwitterScraper::Models::ComposeCreateParams::MediaType] Media type (refine)
-      #
-      # @param style_username [String] Cached style username for voice matching (compose)
-      #
-      # @param tone [String] Desired tone (refine)
-      #
-      # @param topic [String] Tweet topic (compose, refine)
+      # @overload create(body:, request_options: {})
       #
+      # @param body [XTwitterScraper::Models::ComposeCreateParams::Body::ComposePrepareRequest, XTwitterScraper::Models::ComposeCreateParams::Body::ComposeRefineRequest, XTwitterScraper::Models::ComposeCreateParams::Body::ComposeScoreRequest]
       # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [XTwitterScraper::Models::ComposeCreateResponse]
+      # @return [XTwitterScraper::Models::ComposeCreateResponse::ComposePrepareResult, XTwitterScraper::Models::ComposeCreateResponse::ComposeRefineResult, XTwitterScraper::Models::ComposeCreateResponse::ComposeScoreResult]
       #
       # @see XTwitterScraper::Models::ComposeCreateParams
       def create(params)
@@ -40,7 +22,7 @@ module XTwitterScraper
         @client.request(
           method: :post,
           path: "compose",
-          body: parsed,
+          body: parsed[:body],
           model: XTwitterScraper::Models::ComposeCreateResponse,
           options: options
         )

data/lib/x_twitter_scraper/resources/credits.rb

@@ -50,7 +50,7 @@ module XTwitterScraper
       #
       # @overload retrieve_topup_status(session_id:, request_options: {})
       #
-      # @param session_id [String] Billing session ID returned by the top-up billing flow.
+      # @param session_id [String] Top-up session ID to inspect.
       #
       # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/x_twitter_scraper/resources/extractions.rb

@@ -126,15 +126,15 @@ module XTwitterScraper
       #
       # @param retweets_of_tweet_id [String] Estimate only retweets of this tweet ID (tweet_search_extractor)
       #
-      # @param search_query [String] Required for tweet_search_extractor & community_search.
+      # @param search_query [String] Query used to price tweet_search_extractor or community_search.
       #
       # @param since_date [Date] Estimate start date in YYYY-MM-DD format (tweet_search_extractor)
       #
-      # @param target_community_id [String] Required for community_post_extractor & community_search.
+      # @param target_community_id [String] Community ID used to price community_post_extractor or community_search.
       #
-      # @param target_list_id [String] Required for list_follower_explorer, list_member_extractor & list_post_extractor
+      # @param target_list_id [String] List ID used to price list_follower_explorer, list_member_extractor, or list_pos
       #
-      # @param target_space_id [String] Required for space_explorer.
+      # @param target_space_id [String] Space ID used to price space_explorer.
       #
       # @param target_tweet_id [String]
       #

data/lib/x_twitter_scraper/resources/guest_wallets.rb

@@ -15,7 +15,7 @@ module XTwitterScraper
       #
       # @overload create(amount_minor:, idempotency_key:, currency: :usd, request_options: {})
       #
-      # @param amount_minor [Integer] Body param: Confirmed USD amount in cents.
+      # @param amount_minor [Integer] Body param: USD cents accepted for this checkout.
       #
       # @param idempotency_key [String] Header param: Generate a cryptographically random UUID v4. Reuse it only to retr
       #
@@ -72,7 +72,7 @@ module XTwitterScraper
       #
       # @overload topup(amount_minor:, idempotency_key:, currency: :usd, request_options: {})
       #
-      # @param amount_minor [Integer] Body param: Confirmed USD amount in cents.
+      # @param amount_minor [Integer] Body param: USD cents accepted for this checkout.
       #
       # @param idempotency_key [String] Header param: Generate a cryptographically random UUID v4. Reuse it only to retr
       #

data/lib/x_twitter_scraper/resources/monitors/keywords.rb

@@ -3,12 +3,11 @@
 module XTwitterScraper
   module Resources
     class Monitors
-      # Real-time X account monitoring
+      # X account monitoring with 1-second checks
       class Keywords
-        # Creates an instant keyword monitor. Keyword monitors are unlimited. Active
-        # monitors check every 1 second and cost 21 credits per hour. Events and webhook
-        # deliveries are included. Creation requires available credits for the first
-        # hourly charge.
+        # Creates a keyword monitor. Keyword monitors are unlimited. Active monitors check
+        # every 1 second and cost 21 credits per hour. Events and webhook deliveries are
+        # included. Creation requires available credits for the first hourly charge.
         #
         # @overload create(event_types:, query:, request_options: {})
         #

data/lib/x_twitter_scraper/resources/monitors.rb

@@ -2,13 +2,13 @@
 
 module XTwitterScraper
   module Resources
-    # Real-time X account monitoring
+    # X account monitoring with 1-second checks
     class Monitors
-      # Real-time X account monitoring
+      # X account monitoring with 1-second checks
       # @return [XTwitterScraper::Resources::Monitors::Keywords]
       attr_reader :keywords
 
-      # Creates an instant monitor. Monitors are unlimited. Active monitors check every
+      # Creates an account monitor. Monitors are unlimited. Active monitors check every
       # 1 second and cost 21 credits per hour. Events and webhook deliveries are
       # included. Creation requires available credits for the first hourly charge and
       # username lookup.

data/lib/x_twitter_scraper/resources/support/tickets.rb

@@ -5,12 +5,19 @@ module XTwitterScraper
     class Support
       # Support ticket management
       class Tickets
+        # Some parameter documentations has been truncated, see
+        # {XTwitterScraper::Models::Support::TicketCreateParams} for more details.
+        #
         # Create a support ticket
         #
-        # @overload create(body:, subject:, request_options: {})
+        # @overload create(body:, subject:, idempotency_key: nil, request_options: {})
+        #
+        # @param body [String] Body param
+        #
+        # @param subject [String] Body param
+        #
+        # @param idempotency_key [String] Header param: Generate one random value per ticket or reply. Reuse it only when
         #
-        # @param body [String]
-        # @param subject [String]
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
         # @return [XTwitterScraper::Models::Support::TicketCreateResponse]
@@ -18,10 +25,12 @@ module XTwitterScraper
         # @see XTwitterScraper::Models::Support::TicketCreateParams
         def create(params)
           parsed, options = XTwitterScraper::Support::TicketCreateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :post,
             path: "support/tickets",
-            body: parsed,
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
             model: XTwitterScraper::Models::Support::TicketCreateResponse,
             options: options
           )
@@ -89,13 +98,18 @@ module XTwitterScraper
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {XTwitterScraper::Models::Support::TicketReplyParams} for more details.
+        #
         # Reply to a support ticket
         #
-        # @overload reply(id, body:, request_options: {})
+        # @overload reply(id, body:, idempotency_key: nil, request_options: {})
         #
-        # @param id [String] Support ticket public ID for the reply
+        # @param id [String] Path param: Support ticket public ID for the reply
         #
-        # @param body [String]
+        # @param body [String] Body param
+        #
+        # @param idempotency_key [String] Header param: Generate one random value per ticket or reply. Reuse it only when
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -104,10 +118,12 @@ module XTwitterScraper
         # @see XTwitterScraper::Models::Support::TicketReplyParams
         def reply(id, params)
           parsed, options = XTwitterScraper::Support::TicketReplyParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :post,
             path: ["support/tickets/%1$s/messages", id],
-            body: parsed,
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
             model: XTwitterScraper::Models::Support::TicketReplyResponse,
             options: options
           )

data/lib/x_twitter_scraper/resources/trends.rb

@@ -7,7 +7,7 @@ module XTwitterScraper
       # Some parameter documentations has been truncated, see
       # {XTwitterScraper::Models::TrendListParams} for more details.
       #
-      # Get trending hashtags and topics by region (alias)
+      # Get trending hashtags & topics by region (alias)
       #
       # @overload list(count: nil, woeid: nil, request_options: {})
       #

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

@@ -6,13 +6,18 @@ module XTwitterScraper
       class Communities
         # X write actions (tweets, likes, follows, DMs)
         class Join
+          # Some parameter documentations has been truncated, see
+          # {XTwitterScraper::Models::X::Communities::JoinCreateParams} for more details.
+          #
           # Join community
           #
-          # @overload create(id, account:, request_options: {})
+          # @overload create(id, account:, idempotency_key:, request_options: {})
+          #
+          # @param id [String] Path param: Resource ID returned by the matching create or list endpoint.
           #
-          # @param id [String] Resource ID returned by the matching create or list endpoint.
+          # @param account [String] Body param: X account identifier (@username or account ID)
           #
-          # @param account [String] X account identifier (@username or account ID)
+          # @param idempotency_key [String] Header param: Generate one unique value for each intended write. Reuse it only w
           #
           # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -21,22 +26,29 @@ module XTwitterScraper
           # @see XTwitterScraper::Models::X::Communities::JoinCreateParams
           def create(id, params)
             parsed, options = XTwitterScraper::X::Communities::JoinCreateParams.dump_request(params)
+            header_params = {idempotency_key: "idempotency-key"}
             @client.request(
               method: :post,
               path: ["x/communities/%1$s/join", id],
-              body: parsed,
+              headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+              body: parsed.except(*header_params.keys),
               model: XTwitterScraper::Models::X::Communities::JoinCreateResponse,
               options: options
             )
           end
 
+          # Some parameter documentations has been truncated, see
+          # {XTwitterScraper::Models::X::Communities::JoinDeleteAllParams} for more details.
+          #
           # Leave community
           #
-          # @overload delete_all(id, account:, request_options: {})
+          # @overload delete_all(id, account:, idempotency_key:, request_options: {})
+          #
+          # @param id [String] Path param: Resource ID returned by the matching create or list endpoint.
           #
-          # @param id [String] Resource ID returned by the matching create or list endpoint.
+          # @param account [String] Body param: X account identifier (@username or account ID)
           #
-          # @param account [String] X account identifier (@username or account ID)
+          # @param idempotency_key [String] Header param: Generate one unique value for each intended write. Reuse it only w
           #
           # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
           #
@@ -45,10 +57,12 @@ module XTwitterScraper
           # @see XTwitterScraper::Models::X::Communities::JoinDeleteAllParams
           def delete_all(id, params)
             parsed, options = XTwitterScraper::X::Communities::JoinDeleteAllParams.dump_request(params)
+            header_params = {idempotency_key: "idempotency-key"}
             @client.request(
               method: :delete,
               path: ["x/communities/%1$s/join", id],
-              body: parsed,
+              headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+              body: parsed.except(*header_params.keys),
               model: XTwitterScraper::Models::X::Communities::JoinDeleteAllResponse,
               options: options
             )

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

@@ -12,15 +12,20 @@ module XTwitterScraper
         # @return [XTwitterScraper::Resources::X::Communities::Tweets]
         attr_reader :tweets
 
+        # Some parameter documentations has been truncated, see
+        # {XTwitterScraper::Models::X::CommunityCreateParams} for more details.
+        #
         # Create community
         #
-        # @overload create(account:, name:, description: nil, request_options: {})
+        # @overload create(account:, name:, idempotency_key:, description: nil, request_options: {})
+        #
+        # @param account [String] Body param: X account (@username or ID) creating the community
         #
-        # @param account [String] X account (@username or ID) creating the community
+        # @param name [String] Body param: Community name
         #
-        # @param name [String] Community name
+        # @param idempotency_key [String] Header param: Generate one unique value for each intended write. Reuse it only w
         #
-        # @param description [String] Community description
+        # @param description [String] Body param: Community description
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -29,24 +34,31 @@ module XTwitterScraper
         # @see XTwitterScraper::Models::X::CommunityCreateParams
         def create(params)
           parsed, options = XTwitterScraper::X::CommunityCreateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :post,
             path: "x/communities",
-            body: parsed,
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
             model: XTwitterScraper::Models::X::CommunityCreateResponse,
             options: options
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {XTwitterScraper::Models::X::CommunityDeleteParams} for more details.
+        #
         # Delete community
         #
-        # @overload delete(id, account:, community_name:, request_options: {})
+        # @overload delete(id, account:, community_name:, idempotency_key:, request_options: {})
+        #
+        # @param id [String] Path param: Resource ID returned by the matching create or list endpoint.
         #
-        # @param id [String] Resource ID returned by the matching create or list endpoint.
+        # @param account [String] Body param: X account (@username or ID) deleting the community
         #
-        # @param account [String] X account (@username or ID) deleting the community
+        # @param community_name [String] Body param: Community name for confirmation
         #
-        # @param community_name [String] Community name for confirmation
+        # @param idempotency_key [String] Header param: Generate one unique value for each intended write. Reuse it only w
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -55,16 +67,18 @@ module XTwitterScraper
         # @see XTwitterScraper::Models::X::CommunityDeleteParams
         def delete(id, params)
           parsed, options = XTwitterScraper::X::CommunityDeleteParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :delete,
             path: ["x/communities/%1$s", id],
-            body: parsed,
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
             model: XTwitterScraper::Models::X::CommunityDeleteResponse,
             options: options
           )
         end
 
-        # Get community name, description and member count
+        # Get community name, description & member count
         #
         # @overload retrieve_info(id, request_options: {})
         #

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

@@ -36,17 +36,22 @@ module XTwitterScraper
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {XTwitterScraper::Models::X::DmSendParams} for more details.
+        #
         # Send direct message
         #
-        # @overload send_(user_id, account:, text:, media_ids: nil, request_options: {})
+        # @overload send_(user_id, account:, text:, idempotency_key:, media_ids: nil, request_options: {})
+        #
+        # @param user_id [String] Path param: Recipient user ID
         #
-        # @param user_id [String] Recipient user ID
+        # @param account [String] Body param: X account (@username or ID) sending the DM
         #
-        # @param account [String] X account (@username or ID) sending the DM
+        # @param text [String] Body param
         #
-        # @param text [String]
+        # @param idempotency_key [String] Header param: Generate one unique value for each intended write. Reuse it only w
         #
-        # @param media_ids [Array<String>] Optional array containing exactly 1 uploaded media ID.
+        # @param media_ids [Array<String>] Body param: Optional array containing exactly 1 uploaded media ID.
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -55,10 +60,12 @@ module XTwitterScraper
         # @see XTwitterScraper::Models::X::DmSendParams
         def send_(user_id, params)
           parsed, options = XTwitterScraper::X::DmSendParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :post,
             path: ["x/dm/%1$s", user_id],
-            body: parsed,
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
             model: XTwitterScraper::Models::X::DmSendResponse,
             options: options
           )

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

@@ -3,9 +3,8 @@
 module XTwitterScraper
   module Resources
     class X
-      # Media upload and download
       class Media
-        # Download images and videos from tweets
+        # Download images & videos from tweets
         #
         # @overload download(tweet_id: nil, tweet_ids: nil, tweet_input: nil, tweet_url: nil, request_options: {})
         #
@@ -33,13 +32,18 @@ module XTwitterScraper
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {XTwitterScraper::Models::X::MediaUploadParams} for more details.
+        #
         # Upload media
         #
-        # @overload upload(account:, url:, request_options: {})
+        # @overload upload(account:, url:, idempotency_key:, request_options: {})
+        #
+        # @param account [String] Body param: X account (@username or ID) uploading media from URL
         #
-        # @param account [String] X account (@username or ID) uploading media from URL
+        # @param url [String] Body param: HTTPS URL to download and upload as media
         #
-        # @param url [String] HTTPS URL to download and upload as media
+        # @param idempotency_key [String] Header param: Generate one unique value for each intended write. Reuse it only w
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -48,11 +52,17 @@ module XTwitterScraper
         # @see XTwitterScraper::Models::X::MediaUploadParams
         def upload(params)
           parsed, options = XTwitterScraper::X::MediaUploadParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :post,
             path: "x/media",
-            headers: {"content-type" => "multipart/form-data"},
-            body: parsed,
+            headers: {
+              "content-type" => "multipart/form-data",
+              **parsed.slice(*header_params.keys)
+            }.transform_keys(
+              header_params
+            ),
+            body: parsed.except(*header_params.keys),
             model: XTwitterScraper::Models::X::MediaUploadResponse,
             options: options
           )

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

@@ -5,19 +5,24 @@ module XTwitterScraper
     class X
       # X write actions (tweets, likes, follows, DMs)
       class Profile
+        # Some parameter documentations has been truncated, see
+        # {XTwitterScraper::Models::X::ProfileUpdateParams} for more details.
+        #
         # Update X profile
         #
-        # @overload update(account:, description: nil, location: nil, name: nil, url: nil, request_options: {})
+        # @overload update(account:, idempotency_key:, description: nil, location: nil, name: nil, url: nil, request_options: {})
+        #
+        # @param account [String] Body param: X account (@username or ID) to update profile
         #
-        # @param account [String] X account (@username or ID) to update profile
+        # @param idempotency_key [String] Header param: Generate one unique value for each intended write. Reuse it only w
         #
-        # @param description [String] Bio description
+        # @param description [String] Body param: Bio description
         #
-        # @param location [String]
+        # @param location [String] Body param
         #
-        # @param name [String] Display name
+        # @param name [String] Body param: Display name
         #
-        # @param url [String] Website URL
+        # @param url [String] Body param: Website URL
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -26,22 +31,29 @@ module XTwitterScraper
         # @see XTwitterScraper::Models::X::ProfileUpdateParams
         def update(params)
           parsed, options = XTwitterScraper::X::ProfileUpdateParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :patch,
             path: "x/profile",
-            body: parsed,
+            headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
             model: XTwitterScraper::Models::X::ProfileUpdateResponse,
             options: options
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {XTwitterScraper::Models::X::ProfileUpdateAvatarParams} for more details.
+        #
         # Update profile avatar
         #
-        # @overload update_avatar(account:, url:, request_options: {})
+        # @overload update_avatar(account:, url:, idempotency_key:, request_options: {})
         #
-        # @param account [String] X account (@username or ID) receiving avatar from URL
+        # @param account [String] Body param: X account (@username or ID) receiving avatar from URL
         #
-        # @param url [String] HTTPS URL to the avatar image to download
+        # @param url [String] Body param: HTTPS URL to the avatar image to download
+        #
+        # @param idempotency_key [String] Header param: Generate one unique value for each intended write. Reuse it only w
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -50,23 +62,34 @@ module XTwitterScraper
         # @see XTwitterScraper::Models::X::ProfileUpdateAvatarParams
         def update_avatar(params)
           parsed, options = XTwitterScraper::X::ProfileUpdateAvatarParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :patch,
             path: "x/profile/avatar",
-            headers: {"content-type" => "multipart/form-data"},
-            body: parsed,
+            headers: {
+              "content-type" => "multipart/form-data",
+              **parsed.slice(*header_params.keys)
+            }.transform_keys(
+              header_params
+            ),
+            body: parsed.except(*header_params.keys),
             model: XTwitterScraper::Models::X::ProfileUpdateAvatarResponse,
             options: options
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {XTwitterScraper::Models::X::ProfileUpdateBannerParams} for more details.
+        #
         # Update profile banner
         #
-        # @overload update_banner(account:, url:, request_options: {})
+        # @overload update_banner(account:, url:, idempotency_key:, request_options: {})
+        #
+        # @param account [String] Body param: X account (@username or ID) receiving banner from URL
         #
-        # @param account [String] X account (@username or ID) receiving banner from URL
+        # @param url [String] Body param: HTTPS URL to the banner image to download
         #
-        # @param url [String] HTTPS URL to the banner image to download
+        # @param idempotency_key [String] Header param: Generate one unique value for each intended write. Reuse it only w
         #
         # @param request_options [XTwitterScraper::RequestOptions, Hash{Symbol=>Object}, nil]
         #
@@ -75,11 +98,17 @@ module XTwitterScraper
         # @see XTwitterScraper::Models::X::ProfileUpdateBannerParams
         def update_banner(params)
           parsed, options = XTwitterScraper::X::ProfileUpdateBannerParams.dump_request(params)
+          header_params = {idempotency_key: "idempotency-key"}
           @client.request(
             method: :patch,
             path: "x/profile/banner",
-            headers: {"content-type" => "multipart/form-data"},
-            body: parsed,
+            headers: {
+              "content-type" => "multipart/form-data",
+              **parsed.slice(*header_params.keys)
+            }.transform_keys(
+              header_params
+            ),
+            body: parsed.except(*header_params.keys),
             model: XTwitterScraper::Models::X::ProfileUpdateBannerResponse,
             options: options
           )