brand.dev 0.24.0 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a00f1524f31f5130cddc6248ee9013aa339c420fb8a99ee4236d89cf80969f82
-  data.tar.gz: '09f8dec8b06ddad368899fdf113dda2429a66f032d099f52a791f41c41cbb528'
+  metadata.gz: da2f382bfc60d07b03395142e31176eb88b2640e8a5eb2aa6f83156464d409ae
+  data.tar.gz: e8f182c0ae6057bce6ad230ccb2e36a6dfec2c1723e5135a2e5ada98841d7f28
 SHA512:
-  metadata.gz: c96b78a973e6c4e036cd0c55870f7dfa3ea5623e38446d47ecfae9274cb801bc76fa91513add1135e120474b855dab373e046ca3849495b0a775806d3b5eb6d1
-  data.tar.gz: 70c05ab291fd1bafe0cd434ac01f89d6e8afea599f8935dbb29bf1b242bbc3b1b1a14bfec6c49e1a424b4ccd1362492a13a02285422fca0ef8feba1aa2771170
+  metadata.gz: d7d6d1ffebf9c3cf4e7c5e1a2ff28278fde05b607679987c0d91ca6d0809919bdae6deb4ff39abda7e4f87dfaec83505f6cd4948632fab18e45ee711a5946a1c
+  data.tar.gz: 958e744b9d622e3c0f36f4cac53681a8bb85f3a4090b2e827b9e15d9b53f71cca873b916fda66a9eb931bb9626ced4f9314be30740d087b0aa32040c359066ae

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.26.0 (2026-02-23)
+
+Full Changelog: [v0.25.0...v0.26.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.25.0...v0.26.0)
+
+### Features
+
+* **api:** manual updates ([bfe9b29](https://github.com/brand-dot-dev/ruby-sdk/commit/bfe9b298f2c51f4d2762da550344251c2b0b7256))
+
+## 0.25.0 (2026-02-22)
+
+Full Changelog: [v0.24.0...v0.25.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.24.0...v0.25.0)
+
+### Features
+
+* **api:** api update ([a8001da](https://github.com/brand-dot-dev/ruby-sdk/commit/a8001da388a5bf764a6fe19b7df7bc3572ae3dce))
+
+
+### Chores
+
+* **internal:** remove mock server code ([106d37c](https://github.com/brand-dot-dev/ruby-sdk/commit/106d37c53f7459910a897b4f675b97a003b73f7c))
+* update mock server docs ([e60e130](https://github.com/brand-dot-dev/ruby-sdk/commit/e60e13027cec2ae0282f1ca4c4785d3586efe304))
+
 ## 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)

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.24.0"
+gem "brand.dev", "~> 0.26.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/brand_dev/models/brand_ai_product_response.rb

@@ -58,6 +58,12 @@ module BrandDev
         #   @return [Array<String>]
         required :features, BrandDev::Internal::Type::ArrayOf[String]
 
+        # @!attribute images
+        #   URLs to product images on the page (up to 7)
+        #
+        #   @return [Array<String>]
+        required :images, BrandDev::Internal::Type::ArrayOf[String]
+
         # @!attribute name
         #   Name of the product
         #
@@ -122,13 +128,15 @@ module BrandDev
         #   @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)
+        # @!method initialize(description:, features:, images:, 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 images [Array<String>] URLs to product images on the page (up to 7)
+        #
         #   @param name [String] Name of the product
         #
         #   @param tags [Array<String>] Tags associated with the product

data/lib/brand_dev/models/brand_ai_products_response.rb

@@ -27,6 +27,12 @@ module BrandDev
         #   @return [Array<String>]
         required :features, BrandDev::Internal::Type::ArrayOf[String]
 
+        # @!attribute images
+        #   URLs to product images on the page (up to 7)
+        #
+        #   @return [Array<String>]
+        required :images, BrandDev::Internal::Type::ArrayOf[String]
+
         # @!attribute name
         #   Name of the product
         #
@@ -91,11 +97,13 @@ module BrandDev
         #   @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)
+        # @!method initialize(description:, features:, images:, name:, tags:, target_audience:, billing_frequency: nil, category: nil, currency: nil, image_url: nil, price: nil, pricing_model: nil, url: nil)
         #   @param description [String] Description of the product
         #
         #   @param features [Array<String>] List of product features
         #
+        #   @param images [Array<String>] URLs to product images on the page (up to 7)
+        #
         #   @param name [String] Name of the product
         #
         #   @param tags [Array<String>] Tags associated with the product

data/lib/brand_dev/models/brand_web_scrape_html_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#web_scrape_html
+    class BrandWebScrapeHTMLParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      # @!attribute url
+      #   Full URL to scrape (must include http:// or https:// protocol)
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(url:, request_options: {})
+      #   @param url [String] Full URL to scrape (must include http:// or https:// protocol)
+      #
+      #   @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/brand_dev/models/brand_web_scrape_html_response.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#web_scrape_html
+    class BrandWebScrapeHTMLResponse < BrandDev::Internal::Type::BaseModel
+      # @!attribute html
+      #   Raw HTML content of the page
+      #
+      #   @return [String]
+      required :html, String
+
+      # @!attribute success
+      #   Indicates success
+      #
+      #   @return [Boolean, BrandDev::Models::BrandWebScrapeHTMLResponse::Success]
+      required :success, enum: -> { BrandDev::Models::BrandWebScrapeHTMLResponse::Success }
+
+      # @!attribute url
+      #   The URL that was scraped
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(html:, success:, url:)
+      #   @param html [String] Raw HTML content of the page
+      #
+      #   @param success [Boolean, BrandDev::Models::BrandWebScrapeHTMLResponse::Success] Indicates success
+      #
+      #   @param url [String] The URL that was scraped
+
+      # Indicates success
+      #
+      # @see BrandDev::Models::BrandWebScrapeHTMLResponse#success
+      module Success
+        extend BrandDev::Internal::Type::Enum
+
+        TRUE = true
+
+        # @!method self.values
+        #   @return [Array<Boolean>]
+      end
+    end
+  end
+end

data/lib/brand_dev/models/brand_web_scrape_images_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#web_scrape_images
+    class BrandWebScrapeImagesParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      # @!attribute url
+      #   Full URL to scrape images from (must include http:// or https:// protocol)
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(url:, request_options: {})
+      #   @param url [String] Full URL to scrape images from (must include http:// or https:// protocol)
+      #
+      #   @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/brand_dev/models/brand_web_scrape_images_response.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#web_scrape_images
+    class BrandWebScrapeImagesResponse < BrandDev::Internal::Type::BaseModel
+      # @!attribute images
+      #   Array of scraped images
+      #
+      #   @return [Array<BrandDev::Models::BrandWebScrapeImagesResponse::Image>]
+      required :images,
+               -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandWebScrapeImagesResponse::Image] }
+
+      # @!attribute success
+      #   Indicates success
+      #
+      #   @return [Boolean, BrandDev::Models::BrandWebScrapeImagesResponse::Success]
+      required :success, enum: -> { BrandDev::Models::BrandWebScrapeImagesResponse::Success }
+
+      # @!attribute url
+      #   The URL that was scraped
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(images:, success:, url:)
+      #   @param images [Array<BrandDev::Models::BrandWebScrapeImagesResponse::Image>] Array of scraped images
+      #
+      #   @param success [Boolean, BrandDev::Models::BrandWebScrapeImagesResponse::Success] Indicates success
+      #
+      #   @param url [String] The URL that was scraped
+
+      class Image < BrandDev::Internal::Type::BaseModel
+        # @!attribute alt
+        #   Alt text of the image, or null if not present
+        #
+        #   @return [String, nil]
+        required :alt, String, nil?: true
+
+        # @!attribute element
+        #   The HTML element the image was found in
+        #
+        #   @return [Symbol, BrandDev::Models::BrandWebScrapeImagesResponse::Image::Element]
+        required :element, enum: -> { BrandDev::Models::BrandWebScrapeImagesResponse::Image::Element }
+
+        # @!attribute src
+        #   The image source - can be a URL, inline HTML (for SVGs), or a base64 data URI
+        #
+        #   @return [String]
+        required :src, String
+
+        # @!attribute type
+        #   The type/format of the src value
+        #
+        #   @return [Symbol, BrandDev::Models::BrandWebScrapeImagesResponse::Image::Type]
+        required :type, enum: -> { BrandDev::Models::BrandWebScrapeImagesResponse::Image::Type }
+
+        # @!method initialize(alt:, element:, src:, type:)
+        #   @param alt [String, nil] Alt text of the image, or null if not present
+        #
+        #   @param element [Symbol, BrandDev::Models::BrandWebScrapeImagesResponse::Image::Element] The HTML element the image was found in
+        #
+        #   @param src [String] The image source - can be a URL, inline HTML (for SVGs), or a base64 data URI
+        #
+        #   @param type [Symbol, BrandDev::Models::BrandWebScrapeImagesResponse::Image::Type] The type/format of the src value
+
+        # The HTML element the image was found in
+        #
+        # @see BrandDev::Models::BrandWebScrapeImagesResponse::Image#element
+        module Element
+          extend BrandDev::Internal::Type::Enum
+
+          IMG = :img
+          SVG = :svg
+          LINK = :link
+          SOURCE = :source
+          VIDEO = :video
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # The type/format of the src value
+        #
+        # @see BrandDev::Models::BrandWebScrapeImagesResponse::Image#type
+        module Type
+          extend BrandDev::Internal::Type::Enum
+
+          URL = :url
+          HTML = :html
+          BASE64 = :base64
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # Indicates success
+      #
+      # @see BrandDev::Models::BrandWebScrapeImagesResponse#success
+      module Success
+        extend BrandDev::Internal::Type::Enum
+
+        TRUE = true
+
+        # @!method self.values
+        #   @return [Array<Boolean>]
+      end
+    end
+  end
+end

data/lib/brand_dev/models/brand_web_scrape_md_params.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#web_scrape_md
+    class BrandWebScrapeMdParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      # @!attribute url
+      #   Full URL to scrape and convert to markdown (must include http:// or https://
+      #   protocol)
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!attribute include_images
+      #   Include image references in Markdown output
+      #
+      #   @return [Boolean, nil]
+      optional :include_images, BrandDev::Internal::Type::Boolean
+
+      # @!attribute include_links
+      #   Preserve hyperlinks in Markdown output
+      #
+      #   @return [Boolean, nil]
+      optional :include_links, BrandDev::Internal::Type::Boolean
+
+      # @!method initialize(url:, include_images: nil, include_links: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {BrandDev::Models::BrandWebScrapeMdParams} for more details.
+      #
+      #   @param url [String] Full URL to scrape and convert to markdown (must include http:// or https:// pro
+      #
+      #   @param include_images [Boolean] Include image references in Markdown output
+      #
+      #   @param include_links [Boolean] Preserve hyperlinks in Markdown output
+      #
+      #   @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/brand_dev/models/brand_web_scrape_md_response.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#web_scrape_md
+    class BrandWebScrapeMdResponse < BrandDev::Internal::Type::BaseModel
+      # @!attribute markdown
+      #   Page content converted to GitHub Flavored Markdown
+      #
+      #   @return [String]
+      required :markdown, String
+
+      # @!attribute success
+      #   Indicates success
+      #
+      #   @return [Boolean, BrandDev::Models::BrandWebScrapeMdResponse::Success]
+      required :success, enum: -> { BrandDev::Models::BrandWebScrapeMdResponse::Success }
+
+      # @!attribute url
+      #   The URL that was scraped
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(markdown:, success:, url:)
+      #   @param markdown [String] Page content converted to GitHub Flavored Markdown
+      #
+      #   @param success [Boolean, BrandDev::Models::BrandWebScrapeMdResponse::Success] Indicates success
+      #
+      #   @param url [String] The URL that was scraped
+
+      # Indicates success
+      #
+      # @see BrandDev::Models::BrandWebScrapeMdResponse#success
+      module Success
+        extend BrandDev::Internal::Type::Enum
+
+        TRUE = true
+
+        # @!method self.values
+        #   @return [Array<Boolean>]
+      end
+    end
+  end
+end

data/lib/brand_dev/models/brand_web_scrape_sitemap_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#web_scrape_sitemap
+    class BrandWebScrapeSitemapParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      # @!attribute domain
+      #   Domain name to crawl sitemaps for (e.g., 'example.com'). The domain will be
+      #   automatically normalized and validated.
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!method initialize(domain:, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {BrandDev::Models::BrandWebScrapeSitemapParams} for more details.
+      #
+      #   @param domain [String] Domain name to crawl sitemaps for (e.g., 'example.com'). The domain will be auto
+      #
+      #   @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/brand_dev/models/brand_web_scrape_sitemap_response.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#web_scrape_sitemap
+    class BrandWebScrapeSitemapResponse < BrandDev::Internal::Type::BaseModel
+      # @!attribute domain
+      #   The normalized domain that was crawled
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!attribute meta
+      #   Metadata about the sitemap crawl operation
+      #
+      #   @return [BrandDev::Models::BrandWebScrapeSitemapResponse::Meta]
+      required :meta, -> { BrandDev::Models::BrandWebScrapeSitemapResponse::Meta }
+
+      # @!attribute success
+      #   Indicates success
+      #
+      #   @return [Boolean, BrandDev::Models::BrandWebScrapeSitemapResponse::Success]
+      required :success, enum: -> { BrandDev::Models::BrandWebScrapeSitemapResponse::Success }
+
+      # @!attribute urls
+      #   Array of discovered page URLs from the sitemap (max 500)
+      #
+      #   @return [Array<String>]
+      required :urls, BrandDev::Internal::Type::ArrayOf[String]
+
+      # @!method initialize(domain:, meta:, success:, urls:)
+      #   @param domain [String] The normalized domain that was crawled
+      #
+      #   @param meta [BrandDev::Models::BrandWebScrapeSitemapResponse::Meta] Metadata about the sitemap crawl operation
+      #
+      #   @param success [Boolean, BrandDev::Models::BrandWebScrapeSitemapResponse::Success] Indicates success
+      #
+      #   @param urls [Array<String>] Array of discovered page URLs from the sitemap (max 500)
+
+      # @see BrandDev::Models::BrandWebScrapeSitemapResponse#meta
+      class Meta < BrandDev::Internal::Type::BaseModel
+        # @!attribute errors
+        #   Number of errors encountered during crawling
+        #
+        #   @return [Integer]
+        required :errors, Integer
+
+        # @!attribute sitemaps_discovered
+        #   Total number of sitemap files discovered
+        #
+        #   @return [Integer]
+        required :sitemaps_discovered, Integer, api_name: :sitemapsDiscovered
+
+        # @!attribute sitemaps_fetched
+        #   Number of sitemap files successfully fetched and parsed
+        #
+        #   @return [Integer]
+        required :sitemaps_fetched, Integer, api_name: :sitemapsFetched
+
+        # @!attribute sitemaps_skipped
+        #   Number of sitemap files skipped (due to errors, timeouts, or limits)
+        #
+        #   @return [Integer]
+        required :sitemaps_skipped, Integer, api_name: :sitemapsSkipped
+
+        # @!method initialize(errors:, sitemaps_discovered:, sitemaps_fetched:, sitemaps_skipped:)
+        #   Metadata about the sitemap crawl operation
+        #
+        #   @param errors [Integer] Number of errors encountered during crawling
+        #
+        #   @param sitemaps_discovered [Integer] Total number of sitemap files discovered
+        #
+        #   @param sitemaps_fetched [Integer] Number of sitemap files successfully fetched and parsed
+        #
+        #   @param sitemaps_skipped [Integer] Number of sitemap files skipped (due to errors, timeouts, or limits)
+      end
+
+      # Indicates success
+      #
+      # @see BrandDev::Models::BrandWebScrapeSitemapResponse#success
+      module Success
+        extend BrandDev::Internal::Type::Enum
+
+        TRUE = true
+
+        # @!method self.values
+        #   @return [Array<Boolean>]
+      end
+    end
+  end
+end

data/lib/brand_dev/models.rb

@@ -70,4 +70,12 @@ module BrandDev
   BrandScreenshotParams = BrandDev::Models::BrandScreenshotParams
 
   BrandStyleguideParams = BrandDev::Models::BrandStyleguideParams
+
+  BrandWebScrapeHTMLParams = BrandDev::Models::BrandWebScrapeHTMLParams
+
+  BrandWebScrapeImagesParams = BrandDev::Models::BrandWebScrapeImagesParams
+
+  BrandWebScrapeMdParams = BrandDev::Models::BrandWebScrapeMdParams
+
+  BrandWebScrapeSitemapParams = BrandDev::Models::BrandWebScrapeSitemapParams
 end

data/lib/brand_dev/resources/brand.rb

@@ -521,6 +521,111 @@ module BrandDev
         )
       end
 
+      # Scrapes the given URL and returns the raw HTML content of the page. Uses
+      # automatic proxy escalation to handle blocked sites.
+      #
+      # @overload web_scrape_html(url:, request_options: {})
+      #
+      # @param url [String] Full URL to scrape (must include http:// or https:// protocol)
+      #
+      # @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [BrandDev::Models::BrandWebScrapeHTMLResponse]
+      #
+      # @see BrandDev::Models::BrandWebScrapeHTMLParams
+      def web_scrape_html(params)
+        parsed, options = BrandDev::BrandWebScrapeHTMLParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "web/scrape/html",
+          query: parsed,
+          model: BrandDev::Models::BrandWebScrapeHTMLResponse,
+          options: options
+        )
+      end
+
+      # Scrapes all images from the given URL. Extracts images from img, svg,
+      # picture/source, link, and video elements including inline SVGs, base64 data
+      # URIs, and standard URLs.
+      #
+      # @overload web_scrape_images(url:, request_options: {})
+      #
+      # @param url [String] Full URL to scrape images from (must include http:// or https:// protocol)
+      #
+      # @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [BrandDev::Models::BrandWebScrapeImagesResponse]
+      #
+      # @see BrandDev::Models::BrandWebScrapeImagesParams
+      def web_scrape_images(params)
+        parsed, options = BrandDev::BrandWebScrapeImagesParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "web/scrape/images",
+          query: parsed,
+          model: BrandDev::Models::BrandWebScrapeImagesResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {BrandDev::Models::BrandWebScrapeMdParams} for more details.
+      #
+      # Scrapes the given URL, converts the HTML content to GitHub Flavored Markdown
+      # (GFM), and returns the result. Uses automatic proxy escalation to handle blocked
+      # sites.
+      #
+      # @overload web_scrape_md(url:, include_images: nil, include_links: nil, request_options: {})
+      #
+      # @param url [String] Full URL to scrape and convert to markdown (must include http:// or https:// pro
+      #
+      # @param include_images [Boolean] Include image references in Markdown output
+      #
+      # @param include_links [Boolean] Preserve hyperlinks in Markdown output
+      #
+      # @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [BrandDev::Models::BrandWebScrapeMdResponse]
+      #
+      # @see BrandDev::Models::BrandWebScrapeMdParams
+      def web_scrape_md(params)
+        parsed, options = BrandDev::BrandWebScrapeMdParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "web/scrape/markdown",
+          query: parsed.transform_keys(include_images: "includeImages", include_links: "includeLinks"),
+          model: BrandDev::Models::BrandWebScrapeMdResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {BrandDev::Models::BrandWebScrapeSitemapParams} for more details.
+      #
+      # Crawls the sitemap of the given domain and returns all discovered page URLs.
+      # Supports sitemap index files (recursive), parallel fetching with concurrency
+      # control, deduplication, and filters out non-page resources (images, PDFs, etc.).
+      #
+      # @overload web_scrape_sitemap(domain:, request_options: {})
+      #
+      # @param domain [String] Domain name to crawl sitemaps for (e.g., 'example.com'). The domain will be auto
+      #
+      # @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [BrandDev::Models::BrandWebScrapeSitemapResponse]
+      #
+      # @see BrandDev::Models::BrandWebScrapeSitemapParams
+      def web_scrape_sitemap(params)
+        parsed, options = BrandDev::BrandWebScrapeSitemapParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "web/scrape/sitemap",
+          query: parsed,
+          model: BrandDev::Models::BrandWebScrapeSitemapResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [BrandDev::Client]

data/lib/brand_dev/version.rb

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

data/lib/brand_dev.rb

@@ -84,5 +84,13 @@ require_relative "brand_dev/models/brand_screenshot_params"
 require_relative "brand_dev/models/brand_screenshot_response"
 require_relative "brand_dev/models/brand_styleguide_params"
 require_relative "brand_dev/models/brand_styleguide_response"
+require_relative "brand_dev/models/brand_web_scrape_html_params"
+require_relative "brand_dev/models/brand_web_scrape_html_response"
+require_relative "brand_dev/models/brand_web_scrape_images_params"
+require_relative "brand_dev/models/brand_web_scrape_images_response"
+require_relative "brand_dev/models/brand_web_scrape_md_params"
+require_relative "brand_dev/models/brand_web_scrape_md_response"
+require_relative "brand_dev/models/brand_web_scrape_sitemap_params"
+require_relative "brand_dev/models/brand_web_scrape_sitemap_response"
 require_relative "brand_dev/models"
 require_relative "brand_dev/resources/brand"