context.dev 1.26.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb1eb49bd2c33309910f98a48b129a07a32707a85e5a832277226ee555d22780
-  data.tar.gz: 4c7410af11f9f6f69145a70f37e1c613fe9a90d6b2ea99acc061c10ae9119716
+  metadata.gz: d3053b0240426586c72a3ff1876ef8965d555cc938b5cf82bc69dc8d728b3c13
+  data.tar.gz: 3cbe46d917bc4abca8abe5f1af719b66de6eb2c78b912f5846ed769412975579
 SHA512:
-  metadata.gz: 13e5b25d98899a354e90fdf559ea5b3ed8d1140a543f538a7909691a92ecb49917e87398f2da8b3759aad2751487c02e4b89e4738f15febe9bc10995825c4660
-  data.tar.gz: b82dee66dd6c01d5a4edb347097a978708714164cbe4460b7da394f0440b297afcc602bf52cc3cf597e3fe8638559b953bafe0288512e883f1d3b2957fc62cea
+  metadata.gz: 36f207582130d9e38c3704b516f4927062f00f3b5b5f60cfbcf6a171f5081afed1c0c540810611a000d6a869bf9127a97b50d5a69c723da8aa18d2ae1ebda5b1
+  data.tar.gz: 1a27a3872ba648463b321aee475780bf0c42142a33ae6d39453364727ec290645be4e53750afb9db0d3fe3b2a15b722338a1494d3a2271c483eea43d460fd70f

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.28.0 (2026-06-06)
+
+Full Changelog: [v1.27.0...v1.28.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.27.0...v1.28.0)
+
+### Features
+
+* **api:** api update ([22eb08f](https://github.com/context-dot-dev/context-ruby-sdk/commit/22eb08f65d1001052f1bd247a4d60e2680bb33ea))
+
+## 1.27.0 (2026-06-01)
+
+Full Changelog: [v1.26.0...v1.27.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.26.0...v1.27.0)
+
+### Features
+
+* **api:** manual updates ([e3971dc](https://github.com/context-dot-dev/context-ruby-sdk/commit/e3971dcc3b94f5b998562f8ecb82a292cc8f00bd))
+
 ## 1.26.0 (2026-06-01)
 
 Full Changelog: [v1.25.0...v1.26.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.25.0...v1.26.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "context.dev", "~> 1.26.0"
+gem "context.dev", "~> 1.28.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/models/web_extract_competitors_params.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Web#extract_competitors
+    class WebExtractCompetitorsParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute domain
+      #   Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      #   and normalized to their domain.
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!attribute num_competitors
+      #   Exact number of direct competitors to return. Defaults to 5.
+      #
+      #   @return [Integer, nil]
+      optional :num_competitors, Integer
+
+      # @!attribute timeout_ms
+      #   Optional timeout in milliseconds for the request. If the request takes longer
+      #   than this value, it will be aborted with a 408 status code. Maximum allowed
+      #   value is 300000ms (5 minutes).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer
+
+      # @!method initialize(domain:, num_competitors: nil, timeout_ms: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::WebExtractCompetitorsParams} for more details.
+      #
+      #   @param domain [String] Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      #
+      #   @param num_competitors [Integer] Exact number of direct competitors to return. Defaults to 5.
+      #
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/context_dev/models/web_extract_competitors_response.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Web#extract_competitors
+    class WebExtractCompetitorsResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute competitors
+      #   Direct competitors ordered by relevance and confidence.
+      #
+      #   @return [Array<ContextDev::Models::WebExtractCompetitorsResponse::Competitor>]
+      required :competitors,
+               -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::WebExtractCompetitorsResponse::Competitor] }
+
+      # @!attribute domain
+      #   Normalized input domain.
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!attribute status
+      #   Status of the response.
+      #
+      #   @return [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Status]
+      required :status, enum: -> { ContextDev::Models::WebExtractCompetitorsResponse::Status }
+
+      # @!attribute target
+      #   Target company profile inferred from the landing page.
+      #
+      #   @return [ContextDev::Models::WebExtractCompetitorsResponse::Target]
+      required :target, -> { ContextDev::Models::WebExtractCompetitorsResponse::Target }
+
+      # @!method initialize(competitors:, domain:, status:, target:)
+      #   @param competitors [Array<ContextDev::Models::WebExtractCompetitorsResponse::Competitor>] Direct competitors ordered by relevance and confidence.
+      #
+      #   @param domain [String] Normalized input domain.
+      #
+      #   @param status [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Status] Status of the response.
+      #
+      #   @param target [ContextDev::Models::WebExtractCompetitorsResponse::Target] Target company profile inferred from the landing page.
+
+      class Competitor < ContextDev::Internal::Type::BaseModel
+        # @!attribute confidence
+        #   Confidence that this company is a direct competitor.
+        #
+        #   @return [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence]
+        required :confidence,
+                 enum: -> { ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence }
+
+        # @!attribute description
+        #   Short description of the competitor.
+        #
+        #   @return [String]
+        required :description, String
+
+        # @!attribute domain
+        #   Competitor's normalized official domain.
+        #
+        #   @return [String]
+        required :domain, String
+
+        # @!attribute name
+        #   Competitor company or product name.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute source_urls
+        #   Search result URLs used as evidence for this competitor.
+        #
+        #   @return [Array<String>]
+        required :source_urls, ContextDev::Internal::Type::ArrayOf[String], api_name: :sourceUrls
+
+        # @!attribute url
+        #   Competitor website URL.
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!method initialize(confidence:, description:, domain:, name:, source_urls:, url:)
+        #   @param confidence [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence] Confidence that this company is a direct competitor.
+        #
+        #   @param description [String] Short description of the competitor.
+        #
+        #   @param domain [String] Competitor's normalized official domain.
+        #
+        #   @param name [String] Competitor company or product name.
+        #
+        #   @param source_urls [Array<String>] Search result URLs used as evidence for this competitor.
+        #
+        #   @param url [String] Competitor website URL.
+
+        # Confidence that this company is a direct competitor.
+        #
+        # @see ContextDev::Models::WebExtractCompetitorsResponse::Competitor#confidence
+        module Confidence
+          extend ContextDev::Internal::Type::Enum
+
+          HIGH = :high
+          MEDIUM = :medium
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # Status of the response.
+      #
+      # @see ContextDev::Models::WebExtractCompetitorsResponse#status
+      module Status
+        extend ContextDev::Internal::Type::Enum
+
+        OK = :ok
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see ContextDev::Models::WebExtractCompetitorsResponse#target
+      class Target < ContextDev::Internal::Type::BaseModel
+        # @!attribute company_name
+        #   Company or product name inferred from the landing page.
+        #
+        #   @return [String]
+        required :company_name, String, api_name: :companyName
+
+        # @!attribute field
+        #   Specific operating field, product category, or market.
+        #
+        #   @return [String]
+        required :field, String
+
+        # @!attribute field_description
+        #   One-sentence description of what the target company sells and who it serves.
+        #
+        #   @return [String]
+        required :field_description, String, api_name: :fieldDescription
+
+        # @!attribute website_url
+        #   Resolved URL used for the landing page analysis.
+        #
+        #   @return [String]
+        required :website_url, String, api_name: :websiteUrl
+
+        # @!method initialize(company_name:, field:, field_description:, website_url:)
+        #   Target company profile inferred from the landing page.
+        #
+        #   @param company_name [String] Company or product name inferred from the landing page.
+        #
+        #   @param field [String] Specific operating field, product category, or market.
+        #
+        #   @param field_description [String] One-sentence description of what the target company sells and who it serves.
+        #
+        #   @param website_url [String] Resolved URL used for the landing page analysis.
+      end
+    end
+  end
+end

data/lib/context_dev/models/web_web_scrape_html_params.rb

@@ -13,6 +13,14 @@ module ContextDev
       #   @return [String]
       required :url, String
 
+      # @!attribute headers
+      #   Optional outbound HTTP headers forwarded only to the target URL, sent as
+      #   deep-object query params such as headers[X-Custom]=value. When provided, caching
+      #   is bypassed: the result is neither read from nor written to cache.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :headers, ContextDev::Internal::Type::HashOf[String]
+
       # @!attribute include_frames
       #   When true, iframes are rendered inline into the returned HTML.
       #
@@ -49,12 +57,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer
 
-      # @!method initialize(url:, include_frames: nil, max_age_ms: nil, pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(url:, headers: nil, include_frames: nil, max_age_ms: nil, pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeHTMLParams} for more details.
       #
       #   @param url [String] Full URL to scrape (must include http:// or https:// protocol)
       #
+      #   @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       #   @param include_frames [Boolean] When true, iframes are rendered inline into the returned HTML.
       #
       #   @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y

data/lib/context_dev/models/web_web_scrape_images_params.rb

@@ -20,6 +20,14 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeImagesParams::Enrichment, nil]
       optional :enrichment, -> { ContextDev::WebWebScrapeImagesParams::Enrichment }
 
+      # @!attribute headers
+      #   Optional outbound HTTP headers forwarded only to the target URL, sent as
+      #   deep-object query params such as headers[X-Custom]=value. When provided, caching
+      #   is bypassed: the result is neither read from nor written to cache.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :headers, ContextDev::Internal::Type::HashOf[String]
+
       # @!attribute max_age_ms
       #   Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
       #   day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
@@ -42,7 +50,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer
 
-      # @!method initialize(url:, enrichment: nil, max_age_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(url:, enrichment: nil, headers: nil, max_age_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeImagesParams} for more details.
       #
@@ -50,6 +58,8 @@ module ContextDev
       #
       #   @param enrichment [ContextDev::Models::WebWebScrapeImagesParams::Enrichment] Optional per-image processing, sent as deep-object query params such as enrichme
       #
+      #   @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       #   @param max_age_ms [Integer] Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
       #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th

data/lib/context_dev/models/web_web_scrape_md_params.rb

@@ -14,6 +14,14 @@ module ContextDev
       #   @return [String]
       required :url, String
 
+      # @!attribute headers
+      #   Optional outbound HTTP headers forwarded only to the target URL, sent as
+      #   deep-object query params such as headers[X-Custom]=value. When provided, caching
+      #   is bypassed: the result is neither read from nor written to cache.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :headers, ContextDev::Internal::Type::HashOf[String]
+
       # @!attribute include_frames
       #   When true, the contents of iframes are rendered to Markdown.
       #
@@ -75,12 +83,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer
 
-      # @!method initialize(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(url:, headers: nil, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeMdParams} for more details.
       #
       #   @param url [String] Full URL to scrape into LLM usable Markdown (must include http:// or https:// pr
       #
+      #   @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       #   @param include_frames [Boolean] When true, the contents of iframes are rendered to Markdown.
       #
       #   @param include_images [Boolean] Include image references in Markdown output

data/lib/context_dev/models/web_web_scrape_sitemap_params.rb

@@ -13,6 +13,14 @@ module ContextDev
       #   @return [String]
       required :domain, String
 
+      # @!attribute headers
+      #   Optional outbound HTTP headers forwarded only to the target URL, sent as
+      #   deep-object query params such as headers[X-Custom]=value. When provided, caching
+      #   is bypassed: the result is neither read from nor written to cache.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :headers, ContextDev::Internal::Type::HashOf[String]
+
       # @!attribute max_links
       #   Maximum number of links to return from the sitemap crawl. Defaults to 10,000.
       #   Minimum is 1, maximum is 100,000.
@@ -35,12 +43,14 @@ module ContextDev
       #   @return [String, nil]
       optional :url_regex, String
 
-      # @!method initialize(domain:, max_links: nil, timeout_ms: nil, url_regex: nil, request_options: {})
+      # @!method initialize(domain:, headers: nil, max_links: nil, timeout_ms: nil, url_regex: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeSitemapParams} for more details.
       #
       #   @param domain [String] Domain to build a sitemap for
       #
+      #   @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       #   @param max_links [Integer] Maximum number of links to return from the sitemap crawl. Defaults to 10,000. Mi
       #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th

data/lib/context_dev/models.rb

@@ -67,6 +67,8 @@ module ContextDev
 
   UtilityPrefetchParams = ContextDev::Models::UtilityPrefetchParams
 
+  WebExtractCompetitorsParams = ContextDev::Models::WebExtractCompetitorsParams
+
   WebExtractFontsParams = ContextDev::Models::WebExtractFontsParams
 
   WebExtractParams = ContextDev::Models::WebExtractParams

data/lib/context_dev/resources/web.rb

@@ -49,6 +49,37 @@ module ContextDev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::WebExtractCompetitorsParams} for more details.
+      #
+      # Analyze a company's landing page and web search evidence to return direct
+      # competitors for the same product or market.
+      #
+      # @overload extract_competitors(domain:, num_competitors: nil, timeout_ms: nil, request_options: {})
+      #
+      # @param domain [String] Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      #
+      # @param num_competitors [Integer] Exact number of direct competitors to return. Defaults to 5.
+      #
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::WebExtractCompetitorsResponse]
+      #
+      # @see ContextDev::Models::WebExtractCompetitorsParams
+      def extract_competitors(params)
+        parsed, options = ContextDev::WebExtractCompetitorsParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "web/competitors",
+          query: query.transform_keys(num_competitors: "numCompetitors", timeout_ms: "timeoutMS"),
+          model: ContextDev::Models::WebExtractCompetitorsResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::WebExtractFontsParams} for more details.
       #
@@ -268,10 +299,12 @@ module ContextDev
       #
       # Scrapes the given URL and returns the raw HTML content of the page.
       #
-      # @overload web_scrape_html(url:, include_frames: nil, max_age_ms: nil, pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_scrape_html(url:, headers: nil, include_frames: nil, max_age_ms: nil, pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #
       # @param url [String] Full URL to scrape (must include http:// or https:// protocol)
       #
+      # @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       # @param include_frames [Boolean] When true, iframes are rendered inline into the returned HTML.
       #
       # @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
@@ -312,12 +345,14 @@ module ContextDev
       # embeds. The base request costs 1 credit. When enrichment is enabled, the entire
       # call costs 5 credits.
       #
-      # @overload web_scrape_images(url:, enrichment: nil, max_age_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_scrape_images(url:, enrichment: nil, headers: nil, max_age_ms: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #
       # @param url [String] Page URL to inspect. Must include http:// or https://.
       #
       # @param enrichment [ContextDev::Models::WebWebScrapeImagesParams::Enrichment] Optional per-image processing, sent as deep-object query params such as enrichme
       #
+      # @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       # @param max_age_ms [Integer] Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
@@ -350,10 +385,12 @@ module ContextDev
       #
       # Scrapes the given URL into LLM usable Markdown.
       #
-      # @overload web_scrape_md(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_scrape_md(url:, headers: nil, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #
       # @param url [String] Full URL to scrape into LLM usable Markdown (must include http:// or https:// pr
       #
+      # @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       # @param include_frames [Boolean] When true, the contents of iframes are rendered to Markdown.
       #
       # @param include_images [Boolean] Include image references in Markdown output
@@ -403,10 +440,12 @@ module ContextDev
       #
       # Crawl an entire website's sitemap and return all discovered page URLs.
       #
-      # @overload web_scrape_sitemap(domain:, max_links: nil, timeout_ms: nil, url_regex: nil, request_options: {})
+      # @overload web_scrape_sitemap(domain:, headers: nil, max_links: nil, timeout_ms: nil, url_regex: nil, request_options: {})
       #
       # @param domain [String] Domain to build a sitemap for
       #
+      # @param headers [Hash{Symbol=>String}] Optional outbound HTTP headers forwarded only to the target URL, sent as deep-ob
+      #
       # @param max_links [Integer] Maximum number of links to return from the sitemap crawl. Defaults to 10,000. Mi
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th

data/lib/context_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ContextDev
-  VERSION = "1.26.0"
+  VERSION = "1.28.0"
 end

data/lib/context_dev.rb

@@ -80,6 +80,8 @@ require_relative "context_dev/models/utility_prefetch_by_email_params"
 require_relative "context_dev/models/utility_prefetch_by_email_response"
 require_relative "context_dev/models/utility_prefetch_params"
 require_relative "context_dev/models/utility_prefetch_response"
+require_relative "context_dev/models/web_extract_competitors_params"
+require_relative "context_dev/models/web_extract_competitors_response"
 require_relative "context_dev/models/web_extract_fonts_params"
 require_relative "context_dev/models/web_extract_fonts_response"
 require_relative "context_dev/models/web_extract_params"

data/rbi/context_dev/models/web_extract_competitors_params.rbi

@@ -0,0 +1,74 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class WebExtractCompetitorsParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::WebExtractCompetitorsParams,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      # and normalized to their domain.
+      sig { returns(String) }
+      attr_accessor :domain
+
+      # Exact number of direct competitors to return. Defaults to 5.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :num_competitors
+
+      sig { params(num_competitors: Integer).void }
+      attr_writer :num_competitors
+
+      # Optional timeout in milliseconds for the request. If the request takes longer
+      # than this value, it will be aborted with a 408 status code. Maximum allowed
+      # value is 300000ms (5 minutes).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :timeout_ms
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
+      sig do
+        params(
+          domain: String,
+          num_competitors: Integer,
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+        # and normalized to their domain.
+        domain:,
+        # Exact number of direct competitors to return. Defaults to 5.
+        num_competitors: nil,
+        # Optional timeout in milliseconds for the request. If the request takes longer
+        # than this value, it will be aborted with a 408 status code. Maximum allowed
+        # value is 300000ms (5 minutes).
+        timeout_ms: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            domain: String,
+            num_competitors: Integer,
+            timeout_ms: Integer,
+            request_options: ContextDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end