brand.dev 0.22.0 → 0.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73bfa839e4a462bc79f8d9fe6b6d8120ffff7ccc4f9da829328bb081eee1f9ac
-  data.tar.gz: 9e8e4646335f5c229cfa63c93e192a76dd767965df8714b807f218fed1e65de0
+  metadata.gz: a00f1524f31f5130cddc6248ee9013aa339c420fb8a99ee4236d89cf80969f82
+  data.tar.gz: '09f8dec8b06ddad368899fdf113dda2429a66f032d099f52a791f41c41cbb528'
 SHA512:
-  metadata.gz: 3b2512f8069a014412a4f323863a6ef5d4c9a5b9f871758e0990aaac655059cae0168e96d76e34cebf871d018fc905288597df757b01e3a32468ad43497ca4d6
-  data.tar.gz: 3ba4231e77f884b787073607b2454bc146cf175a44541e5a0c49f406f9e0bfb7332e8711a2dada8ce10c28ed0265c5b422c72d8b396d34631aab24af0b2f9409
+  metadata.gz: c96b78a973e6c4e036cd0c55870f7dfa3ea5623e38446d47ecfae9274cb801bc76fa91513add1135e120474b855dab373e046ca3849495b0a775806d3b5eb6d1
+  data.tar.gz: 70c05ab291fd1bafe0cd434ac01f89d6e8afea599f8935dbb29bf1b242bbc3b1b1a14bfec6c49e1a424b4ccd1362492a13a02285422fca0ef8feba1aa2771170

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.24.0 (2026-02-09)
+
+Full Changelog: [v0.23.0...v0.24.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.23.0...v0.24.0)
+
+### Features
+
+* **api:** manual updates ([d51dcea](https://github.com/brand-dot-dev/ruby-sdk/commit/d51dcea705ad031b9010a391b7ed3a26c115beab))
+
+## 0.23.0 (2026-02-07)
+
+Full Changelog: [v0.22.0...v0.23.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.22.0...v0.23.0)
+
+### Features
+
+* **api:** api update ([c1d523e](https://github.com/brand-dot-dev/ruby-sdk/commit/c1d523ebcc0e29a2a3231a2df3f755e2e02b4616))
+
 ## 0.22.0 (2026-02-07)
 
 Full Changelog: [v0.21.0...v0.22.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.21.0...v0.22.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 "brand.dev", "~> 0.22.0"
+gem "brand.dev", "~> 0.24.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/brand_dev/models/brand_ai_product_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#ai_product
+    class BrandAIProductParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      # @!attribute url
+      #   The product page URL to extract product data from.
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!attribute timeout_ms
+      #   Optional timeout in milliseconds for the request. Maximum allowed value is
+      #   300000ms (5 minutes).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer, api_name: :timeoutMS
+
+      # @!method initialize(url:, timeout_ms: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {BrandDev::Models::BrandAIProductParams} for more details.
+      #
+      #   @param url [String] The product page URL to extract product data from.
+      #
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
+      #
+      #   @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/brand_dev/models/brand_ai_product_response.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#ai_product
+    class BrandAIProductResponse < BrandDev::Internal::Type::BaseModel
+      # @!attribute is_product_page
+      #   Whether the given URL is a product detail page
+      #
+      #   @return [Boolean, nil]
+      optional :is_product_page, BrandDev::Internal::Type::Boolean
+
+      # @!attribute platform
+      #   The detected ecommerce platform, or null if not a product page
+      #
+      #   @return [Symbol, BrandDev::Models::BrandAIProductResponse::Platform, nil]
+      optional :platform, enum: -> { BrandDev::Models::BrandAIProductResponse::Platform }, nil?: true
+
+      # @!attribute product
+      #   The extracted product data, or null if not a product page
+      #
+      #   @return [BrandDev::Models::BrandAIProductResponse::Product, nil]
+      optional :product, -> { BrandDev::Models::BrandAIProductResponse::Product }, nil?: true
+
+      # @!method initialize(is_product_page: nil, platform: nil, product: nil)
+      #   @param is_product_page [Boolean] Whether the given URL is a product detail page
+      #
+      #   @param platform [Symbol, BrandDev::Models::BrandAIProductResponse::Platform, nil] The detected ecommerce platform, or null if not a product page
+      #
+      #   @param product [BrandDev::Models::BrandAIProductResponse::Product, nil] The extracted product data, or null if not a product page
+
+      # The detected ecommerce platform, or null if not a product page
+      #
+      # @see BrandDev::Models::BrandAIProductResponse#platform
+      module Platform
+        extend BrandDev::Internal::Type::Enum
+
+        AMAZON = :amazon
+        TIKTOK_SHOP = :tiktok_shop
+        ETSY = :etsy
+        GENERIC = :generic
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see BrandDev::Models::BrandAIProductResponse#product
+      class Product < BrandDev::Internal::Type::BaseModel
+        # @!attribute description
+        #   Description of the product
+        #
+        #   @return [String]
+        required :description, String
+
+        # @!attribute features
+        #   List of product features
+        #
+        #   @return [Array<String>]
+        required :features, BrandDev::Internal::Type::ArrayOf[String]
+
+        # @!attribute name
+        #   Name of the product
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute tags
+        #   Tags associated with the product
+        #
+        #   @return [Array<String>]
+        required :tags, BrandDev::Internal::Type::ArrayOf[String]
+
+        # @!attribute target_audience
+        #   Target audience for the product (array of strings)
+        #
+        #   @return [Array<String>]
+        required :target_audience, BrandDev::Internal::Type::ArrayOf[String]
+
+        # @!attribute billing_frequency
+        #   Billing frequency for the product
+        #
+        #   @return [Symbol, BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency, nil]
+        optional :billing_frequency,
+                 enum: -> { BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency },
+                 nil?: true
+
+        # @!attribute category
+        #   Category of the product
+        #
+        #   @return [String, nil]
+        optional :category, String, nil?: true
+
+        # @!attribute currency
+        #   Currency code for the price (e.g., USD, EUR)
+        #
+        #   @return [String, nil]
+        optional :currency, String, nil?: true
+
+        # @!attribute image_url
+        #   URL to the product image
+        #
+        #   @return [String, nil]
+        optional :image_url, String, nil?: true
+
+        # @!attribute price
+        #   Price of the product
+        #
+        #   @return [Float, nil]
+        optional :price, Float, nil?: true
+
+        # @!attribute pricing_model
+        #   Pricing model for the product
+        #
+        #   @return [Symbol, BrandDev::Models::BrandAIProductResponse::Product::PricingModel, nil]
+        optional :pricing_model,
+                 enum: -> { BrandDev::Models::BrandAIProductResponse::Product::PricingModel },
+                 nil?: true
+
+        # @!attribute url
+        #   URL to the product page
+        #
+        #   @return [String, nil]
+        optional :url, String, nil?: true
+
+        # @!method initialize(description:, features:, name:, tags:, target_audience:, billing_frequency: nil, category: nil, currency: nil, image_url: nil, price: nil, pricing_model: nil, url: nil)
+        #   The extracted product data, or null if not a product page
+        #
+        #   @param description [String] Description of the product
+        #
+        #   @param features [Array<String>] List of product features
+        #
+        #   @param name [String] Name of the product
+        #
+        #   @param tags [Array<String>] Tags associated with the product
+        #
+        #   @param target_audience [Array<String>] Target audience for the product (array of strings)
+        #
+        #   @param billing_frequency [Symbol, BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency, nil] Billing frequency for the product
+        #
+        #   @param category [String, nil] Category of the product
+        #
+        #   @param currency [String, nil] Currency code for the price (e.g., USD, EUR)
+        #
+        #   @param image_url [String, nil] URL to the product image
+        #
+        #   @param price [Float, nil] Price of the product
+        #
+        #   @param pricing_model [Symbol, BrandDev::Models::BrandAIProductResponse::Product::PricingModel, nil] Pricing model for the product
+        #
+        #   @param url [String, nil] URL to the product page
+
+        # Billing frequency for the product
+        #
+        # @see BrandDev::Models::BrandAIProductResponse::Product#billing_frequency
+        module BillingFrequency
+          extend BrandDev::Internal::Type::Enum
+
+          MONTHLY = :monthly
+          YEARLY = :yearly
+          ONE_TIME = :one_time
+          USAGE_BASED = :usage_based
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Pricing model for the product
+        #
+        # @see BrandDev::Models::BrandAIProductResponse::Product#pricing_model
+        module PricingModel
+          extend BrandDev::Internal::Type::Enum
+
+          PER_SEAT = :per_seat
+          FLAT = :flat
+          TIERED = :tiered
+          FREEMIUM = :freemium
+          CUSTOM = :custom
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/brand_dev/models/brand_ai_products_params.rb

@@ -7,21 +7,11 @@ module BrandDev
       extend BrandDev::Internal::Type::RequestParameters::Converter
       include BrandDev::Internal::Type::RequestParameters
 
-      # @!attribute direct_url
-      #   A specific URL to use directly as the starting point for extraction without
-      #   domain resolution. Useful when you want to extract products from a specific page
-      #   rather than discovering the site's product pages automatically. Either 'domain'
-      #   or 'directUrl' must be provided, but not both.
-      #
-      #   @return [String, nil]
-      optional :direct_url, String, api_name: :directUrl
-
       # @!attribute domain
-      #   The domain name to analyze. Either 'domain' or 'directUrl' must be provided, but
-      #   not both.
+      #   The domain name to analyze.
       #
-      #   @return [String, nil]
-      optional :domain, String
+      #   @return [String]
+      required :domain, String
 
       # @!attribute max_products
       #   Maximum number of products to extract.
@@ -30,24 +20,30 @@ module BrandDev
       optional :max_products, Integer, api_name: :maxProducts
 
       # @!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).
+      #   Optional timeout in milliseconds for the request. Maximum allowed value is
+      #   300000ms (5 minutes).
       #
       #   @return [Integer, nil]
       optional :timeout_ms, Integer, api_name: :timeoutMS
 
-      # @!method initialize(direct_url: nil, domain: nil, max_products: nil, timeout_ms: nil, request_options: {})
+      # @!attribute direct_url
+      #   A specific URL to use directly as the starting point for extraction without
+      #   domain resolution.
+      #
+      #   @return [String]
+      required :direct_url, String, api_name: :directUrl
+
+      # @!method initialize(domain:, direct_url:, max_products: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {BrandDev::Models::BrandAIProductsParams} for more details.
       #
-      #   @param direct_url [String] A specific URL to use directly as the starting point for extraction without doma
+      #   @param domain [String] The domain name to analyze.
       #
-      #   @param domain [String] The domain name to analyze. Either 'domain' or 'directUrl' must be provided, but
+      #   @param direct_url [String] A specific URL to use directly as the starting point for extraction without doma
       #
       #   @param max_products [Integer] Maximum number of products to extract.
       #
-      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
       #
       #   @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/brand_dev/models.rb

@@ -39,6 +39,8 @@ module BrandDev
     mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
   end
 
+  BrandAIProductParams = BrandDev::Models::BrandAIProductParams
+
   BrandAIProductsParams = BrandDev::Models::BrandAIProductsParams
 
   BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams

data/lib/brand_dev/resources/brand.rb

@@ -35,6 +35,35 @@ module BrandDev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {BrandDev::Models::BrandAIProductParams} for more details.
+      #
+      # Beta feature: Given a single URL, determines if it is a product detail page,
+      # classifies the platform/product type, and extracts the product information.
+      # Supports Amazon, TikTok Shop, Etsy, and generic ecommerce sites.
+      #
+      # @overload ai_product(url:, timeout_ms: nil, request_options: {})
+      #
+      # @param url [String] The product page URL to extract product data from.
+      #
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
+      #
+      # @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [BrandDev::Models::BrandAIProductResponse]
+      #
+      # @see BrandDev::Models::BrandAIProductParams
+      def ai_product(params)
+        parsed, options = BrandDev::BrandAIProductParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "brand/ai/product",
+          body: parsed,
+          model: BrandDev::Models::BrandAIProductResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {BrandDev::Models::BrandAIProductsParams} for more details.
       #
@@ -42,22 +71,22 @@ module BrandDev
       # analyze the website and return a list of products with details such as name,
       # description, image, pricing, features, and more.
       #
-      # @overload ai_products(direct_url: nil, domain: nil, max_products: nil, timeout_ms: nil, request_options: {})
+      # @overload ai_products(domain:, direct_url:, max_products: nil, timeout_ms: nil, request_options: {})
       #
-      # @param direct_url [String] A specific URL to use directly as the starting point for extraction without doma
+      # @param domain [String] The domain name to analyze.
       #
-      # @param domain [String] The domain name to analyze. Either 'domain' or 'directUrl' must be provided, but
+      # @param direct_url [String] A specific URL to use directly as the starting point for extraction without doma
       #
       # @param max_products [Integer] Maximum number of products to extract.
       #
-      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
       #
       # @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [BrandDev::Models::BrandAIProductsResponse]
       #
       # @see BrandDev::Models::BrandAIProductsParams
-      def ai_products(params = {})
+      def ai_products(params)
         parsed, options = BrandDev::BrandAIProductsParams.dump_request(params)
         @client.request(
           method: :post,

data/lib/brand_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BrandDev
-  VERSION = "0.22.0"
+  VERSION = "0.24.0"
 end

data/lib/brand_dev.rb

@@ -52,6 +52,8 @@ require_relative "brand_dev/errors"
 require_relative "brand_dev/internal/transport/base_client"
 require_relative "brand_dev/internal/transport/pooled_net_requester"
 require_relative "brand_dev/client"
+require_relative "brand_dev/models/brand_ai_product_params"
+require_relative "brand_dev/models/brand_ai_product_response"
 require_relative "brand_dev/models/brand_ai_products_params"
 require_relative "brand_dev/models/brand_ai_products_response"
 require_relative "brand_dev/models/brand_ai_query_params"

data/rbi/brand_dev/models/brand_ai_product_params.rbi

@@ -0,0 +1,56 @@
+# typed: strong
+
+module BrandDev
+  module Models
+    class BrandAIProductParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(BrandDev::BrandAIProductParams, BrandDev::Internal::AnyHash)
+        end
+
+      # The product page URL to extract product data from.
+      sig { returns(String) }
+      attr_accessor :url
+
+      # Optional timeout in milliseconds for the request. 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(
+          url: String,
+          timeout_ms: Integer,
+          request_options: BrandDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The product page URL to extract product data from.
+        url:,
+        # Optional timeout in milliseconds for the request. Maximum allowed value is
+        # 300000ms (5 minutes).
+        timeout_ms: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            url: String,
+            timeout_ms: Integer,
+            request_options: BrandDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/brand_dev/models/brand_ai_product_response.rbi

@@ -0,0 +1,368 @@
+# typed: strong
+
+module BrandDev
+  module Models
+    class BrandAIProductResponse < BrandDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            BrandDev::Models::BrandAIProductResponse,
+            BrandDev::Internal::AnyHash
+          )
+        end
+
+      # Whether the given URL is a product detail page
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :is_product_page
+
+      sig { params(is_product_page: T::Boolean).void }
+      attr_writer :is_product_page
+
+      # The detected ecommerce platform, or null if not a product page
+      sig do
+        returns(
+          T.nilable(
+            BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+          )
+        )
+      end
+      attr_accessor :platform
+
+      # The extracted product data, or null if not a product page
+      sig do
+        returns(T.nilable(BrandDev::Models::BrandAIProductResponse::Product))
+      end
+      attr_reader :product
+
+      sig do
+        params(
+          product:
+            T.nilable(BrandDev::Models::BrandAIProductResponse::Product::OrHash)
+        ).void
+      end
+      attr_writer :product
+
+      sig do
+        params(
+          is_product_page: T::Boolean,
+          platform:
+            T.nilable(
+              BrandDev::Models::BrandAIProductResponse::Platform::OrSymbol
+            ),
+          product:
+            T.nilable(BrandDev::Models::BrandAIProductResponse::Product::OrHash)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Whether the given URL is a product detail page
+        is_product_page: nil,
+        # The detected ecommerce platform, or null if not a product page
+        platform: nil,
+        # The extracted product data, or null if not a product page
+        product: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            is_product_page: T::Boolean,
+            platform:
+              T.nilable(
+                BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+              ),
+            product:
+              T.nilable(BrandDev::Models::BrandAIProductResponse::Product)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The detected ecommerce platform, or null if not a product page
+      module Platform
+        extend BrandDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, BrandDev::Models::BrandAIProductResponse::Platform)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AMAZON =
+          T.let(
+            :amazon,
+            BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+          )
+        TIKTOK_SHOP =
+          T.let(
+            :tiktok_shop,
+            BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+          )
+        ETSY =
+          T.let(
+            :etsy,
+            BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+          )
+        GENERIC =
+          T.let(
+            :generic,
+            BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class Product < BrandDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              BrandDev::Models::BrandAIProductResponse::Product,
+              BrandDev::Internal::AnyHash
+            )
+          end
+
+        # Description of the product
+        sig { returns(String) }
+        attr_accessor :description
+
+        # List of product features
+        sig { returns(T::Array[String]) }
+        attr_accessor :features
+
+        # Name of the product
+        sig { returns(String) }
+        attr_accessor :name
+
+        # Tags associated with the product
+        sig { returns(T::Array[String]) }
+        attr_accessor :tags
+
+        # Target audience for the product (array of strings)
+        sig { returns(T::Array[String]) }
+        attr_accessor :target_audience
+
+        # Billing frequency for the product
+        sig do
+          returns(
+            T.nilable(
+              BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::TaggedSymbol
+            )
+          )
+        end
+        attr_accessor :billing_frequency
+
+        # Category of the product
+        sig { returns(T.nilable(String)) }
+        attr_accessor :category
+
+        # Currency code for the price (e.g., USD, EUR)
+        sig { returns(T.nilable(String)) }
+        attr_accessor :currency
+
+        # URL to the product image
+        sig { returns(T.nilable(String)) }
+        attr_accessor :image_url
+
+        # Price of the product
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :price
+
+        # Pricing model for the product
+        sig do
+          returns(
+            T.nilable(
+              BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+          )
+        end
+        attr_accessor :pricing_model
+
+        # URL to the product page
+        sig { returns(T.nilable(String)) }
+        attr_accessor :url
+
+        # The extracted product data, or null if not a product page
+        sig do
+          params(
+            description: String,
+            features: T::Array[String],
+            name: String,
+            tags: T::Array[String],
+            target_audience: T::Array[String],
+            billing_frequency:
+              T.nilable(
+                BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::OrSymbol
+              ),
+            category: T.nilable(String),
+            currency: T.nilable(String),
+            image_url: T.nilable(String),
+            price: T.nilable(Float),
+            pricing_model:
+              T.nilable(
+                BrandDev::Models::BrandAIProductResponse::Product::PricingModel::OrSymbol
+              ),
+            url: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Description of the product
+          description:,
+          # List of product features
+          features:,
+          # Name of the product
+          name:,
+          # Tags associated with the product
+          tags:,
+          # Target audience for the product (array of strings)
+          target_audience:,
+          # Billing frequency for the product
+          billing_frequency: nil,
+          # Category of the product
+          category: nil,
+          # Currency code for the price (e.g., USD, EUR)
+          currency: nil,
+          # URL to the product image
+          image_url: nil,
+          # Price of the product
+          price: nil,
+          # Pricing model for the product
+          pricing_model: nil,
+          # URL to the product page
+          url: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              description: String,
+              features: T::Array[String],
+              name: String,
+              tags: T::Array[String],
+              target_audience: T::Array[String],
+              billing_frequency:
+                T.nilable(
+                  BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::TaggedSymbol
+                ),
+              category: T.nilable(String),
+              currency: T.nilable(String),
+              image_url: T.nilable(String),
+              price: T.nilable(Float),
+              pricing_model:
+                T.nilable(
+                  BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+                ),
+              url: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Billing frequency for the product
+        module BillingFrequency
+          extend BrandDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          MONTHLY =
+            T.let(
+              :monthly,
+              BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::TaggedSymbol
+            )
+          YEARLY =
+            T.let(
+              :yearly,
+              BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::TaggedSymbol
+            )
+          ONE_TIME =
+            T.let(
+              :one_time,
+              BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::TaggedSymbol
+            )
+          USAGE_BASED =
+            T.let(
+              :usage_based,
+              BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        # Pricing model for the product
+        module PricingModel
+          extend BrandDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                BrandDev::Models::BrandAIProductResponse::Product::PricingModel
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          PER_SEAT =
+            T.let(
+              :per_seat,
+              BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+          FLAT =
+            T.let(
+              :flat,
+              BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+          TIERED =
+            T.let(
+              :tiered,
+              BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+          FREEMIUM =
+            T.let(
+              :freemium,
+              BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+          CUSTOM =
+            T.let(
+              :custom,
+              BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/brand_dev/models/brand_ai_products_params.rbi

@@ -11,23 +11,9 @@ module BrandDev
           T.any(BrandDev::BrandAIProductsParams, BrandDev::Internal::AnyHash)
         end
 
-      # A specific URL to use directly as the starting point for extraction without
-      # domain resolution. Useful when you want to extract products from a specific page
-      # rather than discovering the site's product pages automatically. Either 'domain'
-      # or 'directUrl' must be provided, but not both.
-      sig { returns(T.nilable(String)) }
-      attr_reader :direct_url
-
-      sig { params(direct_url: String).void }
-      attr_writer :direct_url
-
-      # The domain name to analyze. Either 'domain' or 'directUrl' must be provided, but
-      # not both.
-      sig { returns(T.nilable(String)) }
-      attr_reader :domain
-
-      sig { params(domain: String).void }
-      attr_writer :domain
+      # The domain name to analyze.
+      sig { returns(String) }
+      attr_accessor :domain
 
       # Maximum number of products to extract.
       sig { returns(T.nilable(Integer)) }
@@ -36,38 +22,38 @@ module BrandDev
       sig { params(max_products: Integer).void }
       attr_writer :max_products
 
-      # 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).
+      # Optional timeout in milliseconds for the request. 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
 
+      # A specific URL to use directly as the starting point for extraction without
+      # domain resolution.
+      sig { returns(String) }
+      attr_accessor :direct_url
+
       sig do
         params(
-          direct_url: String,
           domain: String,
+          direct_url: String,
           max_products: Integer,
           timeout_ms: Integer,
           request_options: BrandDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
+        # The domain name to analyze.
+        domain:,
         # A specific URL to use directly as the starting point for extraction without
-        # domain resolution. Useful when you want to extract products from a specific page
-        # rather than discovering the site's product pages automatically. Either 'domain'
-        # or 'directUrl' must be provided, but not both.
-        direct_url: nil,
-        # The domain name to analyze. Either 'domain' or 'directUrl' must be provided, but
-        # not both.
-        domain: nil,
+        # domain resolution.
+        direct_url:,
         # Maximum number of products to extract.
         max_products: 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).
+        # Optional timeout in milliseconds for the request. Maximum allowed value is
+        # 300000ms (5 minutes).
         timeout_ms: nil,
         request_options: {}
       )
@@ -76,10 +62,10 @@ module BrandDev
       sig do
         override.returns(
           {
-            direct_url: String,
             domain: String,
             max_products: Integer,
             timeout_ms: Integer,
+            direct_url: String,
             request_options: BrandDev::RequestOptions
           }
         )

data/rbi/brand_dev/models.rbi

@@ -1,6 +1,8 @@
 # typed: strong
 
 module BrandDev
+  BrandAIProductParams = BrandDev::Models::BrandAIProductParams
+
   BrandAIProductsParams = BrandDev::Models::BrandAIProductsParams
 
   BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams

data/rbi/brand_dev/resources/brand.rbi

@@ -34,32 +34,48 @@ module BrandDev
       )
       end
 
+      # Beta feature: Given a single URL, determines if it is a product detail page,
+      # classifies the platform/product type, and extracts the product information.
+      # Supports Amazon, TikTok Shop, Etsy, and generic ecommerce sites.
+      sig do
+        params(
+          url: String,
+          timeout_ms: Integer,
+          request_options: BrandDev::RequestOptions::OrHash
+        ).returns(BrandDev::Models::BrandAIProductResponse)
+      end
+      def ai_product(
+        # The product page URL to extract product data from.
+        url:,
+        # Optional timeout in milliseconds for the request. Maximum allowed value is
+        # 300000ms (5 minutes).
+        timeout_ms: nil,
+        request_options: {}
+      )
+      end
+
       # Beta feature: Extract product information from a brand's website. Brand.dev will
       # analyze the website and return a list of products with details such as name,
       # description, image, pricing, features, and more.
       sig do
         params(
-          direct_url: String,
           domain: String,
+          direct_url: String,
           max_products: Integer,
           timeout_ms: Integer,
           request_options: BrandDev::RequestOptions::OrHash
         ).returns(BrandDev::Models::BrandAIProductsResponse)
       end
       def ai_products(
+        # The domain name to analyze.
+        domain:,
         # A specific URL to use directly as the starting point for extraction without
-        # domain resolution. Useful when you want to extract products from a specific page
-        # rather than discovering the site's product pages automatically. Either 'domain'
-        # or 'directUrl' must be provided, but not both.
-        direct_url: nil,
-        # The domain name to analyze. Either 'domain' or 'directUrl' must be provided, but
-        # not both.
-        domain: nil,
+        # domain resolution.
+        direct_url:,
         # Maximum number of products to extract.
         max_products: 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).
+        # Optional timeout in milliseconds for the request. Maximum allowed value is
+        # 300000ms (5 minutes).
         timeout_ms: nil,
         request_options: {}
       )

data/sig/brand_dev/models/brand_ai_product_params.rbs

@@ -0,0 +1,30 @@
+module BrandDev
+  module Models
+    type brand_ai_product_params =
+      { url: String, timeout_ms: Integer }
+      & BrandDev::Internal::Type::request_parameters
+
+    class BrandAIProductParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      attr_accessor url: String
+
+      attr_reader timeout_ms: Integer?
+
+      def timeout_ms=: (Integer) -> Integer
+
+      def initialize: (
+        url: String,
+        ?timeout_ms: Integer,
+        ?request_options: BrandDev::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        url: String,
+        timeout_ms: Integer,
+        request_options: BrandDev::RequestOptions
+      }
+    end
+  end
+end

data/sig/brand_dev/models/brand_ai_product_response.rbs

@@ -0,0 +1,144 @@
+module BrandDev
+  module Models
+    type brand_ai_product_response =
+      {
+        is_product_page: bool,
+        platform: BrandDev::Models::BrandAIProductResponse::platform?,
+        product: BrandDev::Models::BrandAIProductResponse::Product?
+      }
+
+    class BrandAIProductResponse < BrandDev::Internal::Type::BaseModel
+      attr_reader is_product_page: bool?
+
+      def is_product_page=: (bool) -> bool
+
+      attr_accessor platform: BrandDev::Models::BrandAIProductResponse::platform?
+
+      attr_accessor product: BrandDev::Models::BrandAIProductResponse::Product?
+
+      def initialize: (
+        ?is_product_page: bool,
+        ?platform: BrandDev::Models::BrandAIProductResponse::platform?,
+        ?product: BrandDev::Models::BrandAIProductResponse::Product?
+      ) -> void
+
+      def to_hash: -> {
+        is_product_page: bool,
+        platform: BrandDev::Models::BrandAIProductResponse::platform?,
+        product: BrandDev::Models::BrandAIProductResponse::Product?
+      }
+
+      type platform = :amazon | :tiktok_shop | :etsy | :generic
+
+      module Platform
+        extend BrandDev::Internal::Type::Enum
+
+        AMAZON: :amazon
+        TIKTOK_SHOP: :tiktok_shop
+        ETSY: :etsy
+        GENERIC: :generic
+
+        def self?.values: -> ::Array[BrandDev::Models::BrandAIProductResponse::platform]
+      end
+
+      type product =
+        {
+          description: String,
+          features: ::Array[String],
+          name: String,
+          tags: ::Array[String],
+          target_audience: ::Array[String],
+          billing_frequency: BrandDev::Models::BrandAIProductResponse::Product::billing_frequency?,
+          category: String?,
+          currency: String?,
+          image_url: String?,
+          price: Float?,
+          pricing_model: BrandDev::Models::BrandAIProductResponse::Product::pricing_model?,
+          url: String?
+        }
+
+      class Product < BrandDev::Internal::Type::BaseModel
+        attr_accessor description: String
+
+        attr_accessor features: ::Array[String]
+
+        attr_accessor name: String
+
+        attr_accessor tags: ::Array[String]
+
+        attr_accessor target_audience: ::Array[String]
+
+        attr_accessor billing_frequency: BrandDev::Models::BrandAIProductResponse::Product::billing_frequency?
+
+        attr_accessor category: String?
+
+        attr_accessor currency: String?
+
+        attr_accessor image_url: String?
+
+        attr_accessor price: Float?
+
+        attr_accessor pricing_model: BrandDev::Models::BrandAIProductResponse::Product::pricing_model?
+
+        attr_accessor url: String?
+
+        def initialize: (
+          description: String,
+          features: ::Array[String],
+          name: String,
+          tags: ::Array[String],
+          target_audience: ::Array[String],
+          ?billing_frequency: BrandDev::Models::BrandAIProductResponse::Product::billing_frequency?,
+          ?category: String?,
+          ?currency: String?,
+          ?image_url: String?,
+          ?price: Float?,
+          ?pricing_model: BrandDev::Models::BrandAIProductResponse::Product::pricing_model?,
+          ?url: String?
+        ) -> void
+
+        def to_hash: -> {
+          description: String,
+          features: ::Array[String],
+          name: String,
+          tags: ::Array[String],
+          target_audience: ::Array[String],
+          billing_frequency: BrandDev::Models::BrandAIProductResponse::Product::billing_frequency?,
+          category: String?,
+          currency: String?,
+          image_url: String?,
+          price: Float?,
+          pricing_model: BrandDev::Models::BrandAIProductResponse::Product::pricing_model?,
+          url: String?
+        }
+
+        type billing_frequency = :monthly | :yearly | :one_time | :usage_based
+
+        module BillingFrequency
+          extend BrandDev::Internal::Type::Enum
+
+          MONTHLY: :monthly
+          YEARLY: :yearly
+          ONE_TIME: :one_time
+          USAGE_BASED: :usage_based
+
+          def self?.values: -> ::Array[BrandDev::Models::BrandAIProductResponse::Product::billing_frequency]
+        end
+
+        type pricing_model = :per_seat | :flat | :tiered | :freemium | :custom
+
+        module PricingModel
+          extend BrandDev::Internal::Type::Enum
+
+          PER_SEAT: :per_seat
+          FLAT: :flat
+          TIERED: :tiered
+          FREEMIUM: :freemium
+          CUSTOM: :custom
+
+          def self?.values: -> ::Array[BrandDev::Models::BrandAIProductResponse::Product::pricing_model]
+        end
+      end
+    end
+  end
+end

data/sig/brand_dev/models/brand_ai_products_params.rbs

@@ -2,10 +2,10 @@ module BrandDev
   module Models
     type brand_ai_products_params =
       {
-        direct_url: String,
         domain: String,
         max_products: Integer,
-        timeout_ms: Integer
+        timeout_ms: Integer,
+        direct_url: String
       }
       & BrandDev::Internal::Type::request_parameters
 
@@ -13,13 +13,7 @@ module BrandDev
       extend BrandDev::Internal::Type::RequestParameters::Converter
       include BrandDev::Internal::Type::RequestParameters
 
-      attr_reader direct_url: String?
-
-      def direct_url=: (String) -> String
-
-      attr_reader domain: String?
-
-      def domain=: (String) -> String
+      attr_accessor domain: String
 
       attr_reader max_products: Integer?
 
@@ -29,19 +23,21 @@ module BrandDev
 
       def timeout_ms=: (Integer) -> Integer
 
+      attr_accessor direct_url: String
+
       def initialize: (
-        ?direct_url: String,
-        ?domain: String,
+        domain: String,
+        direct_url: String,
         ?max_products: Integer,
         ?timeout_ms: Integer,
         ?request_options: BrandDev::request_opts
       ) -> void
 
       def to_hash: -> {
-        direct_url: String,
         domain: String,
         max_products: Integer,
         timeout_ms: Integer,
+        direct_url: String,
         request_options: BrandDev::RequestOptions
       }
     end

data/sig/brand_dev/models.rbs

@@ -1,4 +1,6 @@
 module BrandDev
+  class BrandAIProductParams = BrandDev::Models::BrandAIProductParams
+
   class BrandAIProductsParams = BrandDev::Models::BrandAIProductsParams
 
   class BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams

data/sig/brand_dev/resources/brand.rbs

@@ -9,9 +9,15 @@ module BrandDev
         ?request_options: BrandDev::request_opts
       ) -> BrandDev::Models::BrandRetrieveResponse
 
+      def ai_product: (
+        url: String,
+        ?timeout_ms: Integer,
+        ?request_options: BrandDev::request_opts
+      ) -> BrandDev::Models::BrandAIProductResponse
+
       def ai_products: (
-        ?direct_url: String,
-        ?domain: String,
+        domain: String,
+        direct_url: String,
         ?max_products: Integer,
         ?timeout_ms: Integer,
         ?request_options: BrandDev::request_opts

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: brand.dev
 version: !ruby/object:Gem::Version
-  version: 0.22.0
+  version: 0.24.0
 platform: ruby
 authors:
 - Brand Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-07 00:00:00.000000000 Z
+date: 2026-02-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -68,6 +68,8 @@ files:
 - lib/brand_dev/internal/type/unknown.rb
 - lib/brand_dev/internal/util.rb
 - lib/brand_dev/models.rb
+- lib/brand_dev/models/brand_ai_product_params.rb
+- lib/brand_dev/models/brand_ai_product_response.rb
 - lib/brand_dev/models/brand_ai_products_params.rb
 - lib/brand_dev/models/brand_ai_products_response.rb
 - lib/brand_dev/models/brand_ai_query_params.rb
@@ -121,6 +123,8 @@ files:
 - rbi/brand_dev/internal/type/unknown.rbi
 - rbi/brand_dev/internal/util.rbi
 - rbi/brand_dev/models.rbi
+- rbi/brand_dev/models/brand_ai_product_params.rbi
+- rbi/brand_dev/models/brand_ai_product_response.rbi
 - rbi/brand_dev/models/brand_ai_products_params.rbi
 - rbi/brand_dev/models/brand_ai_products_response.rbi
 - rbi/brand_dev/models/brand_ai_query_params.rbi
@@ -173,6 +177,8 @@ files:
 - sig/brand_dev/internal/type/unknown.rbs
 - sig/brand_dev/internal/util.rbs
 - sig/brand_dev/models.rbs
+- sig/brand_dev/models/brand_ai_product_params.rbs
+- sig/brand_dev/models/brand_ai_product_response.rbs
 - sig/brand_dev/models/brand_ai_products_params.rbs
 - sig/brand_dev/models/brand_ai_products_response.rbs
 - sig/brand_dev/models/brand_ai_query_params.rbs