context.dev 1.14.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 836fab0c1e0cb715edaeaf7f7206d4a0be107d9a8971ff6afba657ba13e8bf49
-  data.tar.gz: 9ece48b1e97a2d806adb38a9c16df4d94cba3448f892435b8096904fd27f513d
+  metadata.gz: 6ba57da748751f653f87b57407326a40a8af9b31dc9c10364c61e536a7eb57a6
+  data.tar.gz: b10761a87783d8544bae6dd0bad6c3f3275af2fd2c39e734e61709d89de8cd9e
 SHA512:
-  metadata.gz: 0d5018e385aa2664e995f451b8e020894d98af98ec9f06a8962d11da56e43c448cbe5c184a24d5a9310d5cd0b8f6c43009829809a75de0770749388fbd06a012
-  data.tar.gz: 01ab4b2ef6367f3d5c5a5e71d98a42f6d4db0fc17eb850c061e16355056c53dcca45b58ee836fadacd9ac2033e95ef0875aaaedea715d58c5d66cdae35956eba
+  metadata.gz: 53f3f7978e24bcac14e388d76f2ba02b1410354b536264a14074306ce6464725d5741ebf6d59b1d280eeb8b2babc1980c35397c45175213645d38fdbcd89a5c5
+  data.tar.gz: 4d9aa2a1af255cd2352c613bfd3fbbef1532d9ab6eb396d8e9e33d1a41f7b4eabd3601c6406a68d3688a338b1f588f3cf76bc7d17b8966ddff0b358dd1cc6d72

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.16.0 (2026-05-07)
+
+Full Changelog: [v1.15.0...v1.16.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.15.0...v1.16.0)
+
+### Features
+
+* **api:** api update ([f0b1f3a](https://github.com/context-dot-dev/context-ruby-sdk/commit/f0b1f3afd885c44cb464393b57d944fa27a6c0b5))
+
+## 1.15.0 (2026-05-06)
+
+Full Changelog: [v1.14.0...v1.15.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.14.0...v1.15.0)
+
+### Features
+
+* **api:** api update ([42c8282](https://github.com/context-dot-dev/context-ruby-sdk/commit/42c8282f18c421ca317b51c640ea42cc04c61230))
+
 ## 1.14.0 (2026-05-06)
 
 Full Changelog: [v1.13.0...v1.14.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.13.0...v1.14.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.14.0"
+gem "context.dev", "~> 1.16.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/models/brand_retrieve_by_email_params.rb

@@ -21,6 +21,15 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::BrandRetrieveByEmailParams::ForceLanguage, nil]
       optional :force_language, enum: -> { ContextDev::BrandRetrieveByEmailParams::ForceLanguage }
 
+      # @!attribute max_age_ms
+      #   Maximum age in milliseconds for cached brand data before the API performs a hard
+      #   refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
+      #   are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
+      #   year.
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, Integer
+
       # @!attribute max_speed
       #   Optional parameter to optimize the API call for maximum speed. When set to true,
       #   the API will skip time-consuming operations for faster response at the cost of
@@ -37,7 +46,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(email:, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(email:, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BrandRetrieveByEmailParams} for more details.
       #
@@ -45,6 +54,8 @@ module ContextDev
       #
       #   @param force_language [Symbol, ContextDev::Models::BrandRetrieveByEmailParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
+      #   @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       #   @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th

data/lib/context_dev/models/brand_retrieve_by_isin_params.rb

@@ -21,6 +21,15 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::BrandRetrieveByIsinParams::ForceLanguage, nil]
       optional :force_language, enum: -> { ContextDev::BrandRetrieveByIsinParams::ForceLanguage }
 
+      # @!attribute max_age_ms
+      #   Maximum age in milliseconds for cached brand data before the API performs a hard
+      #   refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
+      #   are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
+      #   year.
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, Integer
+
       # @!attribute max_speed
       #   Optional parameter to optimize the API call for maximum speed. When set to true,
       #   the API will skip time-consuming operations for faster response at the cost of
@@ -37,7 +46,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(isin:, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(isin:, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BrandRetrieveByIsinParams} for more details.
       #
@@ -45,6 +54,8 @@ module ContextDev
       #
       #   @param force_language [Symbol, ContextDev::Models::BrandRetrieveByIsinParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
+      #   @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       #   @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th

data/lib/context_dev/models/brand_retrieve_by_name_params.rb

@@ -27,6 +27,15 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::BrandRetrieveByNameParams::ForceLanguage, nil]
       optional :force_language, enum: -> { ContextDev::BrandRetrieveByNameParams::ForceLanguage }
 
+      # @!attribute max_age_ms
+      #   Maximum age in milliseconds for cached brand data before the API performs a hard
+      #   refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
+      #   are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
+      #   year.
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, Integer
+
       # @!attribute max_speed
       #   Optional parameter to optimize the API call for maximum speed. When set to true,
       #   the API will skip time-consuming operations for faster response at the cost of
@@ -43,7 +52,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(name:, country_gl: nil, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(name:, country_gl: nil, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BrandRetrieveByNameParams} for more details.
       #
@@ -53,6 +62,8 @@ module ContextDev
       #
       #   @param force_language [Symbol, ContextDev::Models::BrandRetrieveByNameParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
+      #   @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       #   @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th

data/lib/context_dev/models/brand_retrieve_by_ticker_params.rb

@@ -20,6 +20,15 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::BrandRetrieveByTickerParams::ForceLanguage, nil]
       optional :force_language, enum: -> { ContextDev::BrandRetrieveByTickerParams::ForceLanguage }
 
+      # @!attribute max_age_ms
+      #   Maximum age in milliseconds for cached brand data before the API performs a hard
+      #   refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
+      #   are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
+      #   year.
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, Integer
+
       # @!attribute max_speed
       #   Optional parameter to optimize the API call for maximum speed. When set to true,
       #   the API will skip time-consuming operations for faster response at the cost of
@@ -42,7 +51,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(ticker:, force_language: nil, max_speed: nil, ticker_exchange: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(ticker:, force_language: nil, max_age_ms: nil, max_speed: nil, ticker_exchange: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BrandRetrieveByTickerParams} for more details.
       #
@@ -50,6 +59,8 @@ module ContextDev
       #
       #   @param force_language [Symbol, ContextDev::Models::BrandRetrieveByTickerParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
+      #   @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       #   @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
       #   @param ticker_exchange [Symbol, ContextDev::Models::BrandRetrieveByTickerParams::TickerExchange] Optional stock exchange for the ticker. Defaults to NASDAQ if not specified.

data/lib/context_dev/models/brand_retrieve_params.rb

@@ -20,6 +20,15 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::BrandRetrieveParams::ForceLanguage, nil]
       optional :force_language, enum: -> { ContextDev::BrandRetrieveParams::ForceLanguage }
 
+      # @!attribute max_age_ms
+      #   Maximum age in milliseconds for cached brand data before the API performs a hard
+      #   refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
+      #   are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
+      #   year.
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, Integer
+
       # @!attribute max_speed
       #   Optional parameter to optimize the API call for maximum speed. When set to true,
       #   the API will skip time-consuming operations for faster response at the cost of
@@ -36,7 +45,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(domain:, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(domain:, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BrandRetrieveParams} for more details.
       #
@@ -44,6 +53,8 @@ module ContextDev
       #
       #   @param force_language [Symbol, ContextDev::Models::BrandRetrieveParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
+      #   @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       #   @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th

data/lib/context_dev/models/brand_retrieve_simplified_params.rb

@@ -13,6 +13,15 @@ module ContextDev
       #   @return [String]
       required :domain, String
 
+      # @!attribute max_age_ms
+      #   Maximum age in milliseconds for cached brand data before the API performs a hard
+      #   refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
+      #   are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
+      #   year.
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, 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
@@ -21,12 +30,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(domain:, timeout_ms: nil, request_options: {})
+      # @!method initialize(domain:, max_age_ms: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::BrandRetrieveSimplifiedParams} for more details.
       #
       #   @param domain [String] Domain name to retrieve simplified brand data for
       #
+      #   @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       #   @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}]

data/lib/context_dev/models/web_screenshot_params.rb

@@ -31,6 +31,14 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot, nil]
       optional :full_screenshot, enum: -> { ContextDev::WebScreenshotParams::FullScreenshot }
 
+      # @!attribute max_age_ms
+      #   Return a cached screenshot if a prior screenshot for the same parameters exists
+      #   and is younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
+      #   omitted. Max is 30 days (2592000000 ms). Set to 0 to always capture fresh.
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, Integer
+
       # @!attribute page
       #   Optional parameter to specify which page type to screenshot. If provided, the
       #   system will scrape the domain's links and use heuristics to find the most
@@ -49,7 +57,13 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Prioritize, nil]
       optional :prioritize, enum: -> { ContextDev::WebScreenshotParams::Prioritize }
 
-      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, page: nil, prioritize: nil, request_options: {})
+      # @!attribute viewport
+      #   Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+      #
+      #   @return [ContextDev::Models::WebScreenshotParams::Viewport, nil]
+      optional :viewport, -> { ContextDev::WebScreenshotParams::Viewport }
+
+      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, max_age_ms: nil, page: nil, prioritize: nil, viewport: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebScreenshotParams} for more details.
       #
@@ -59,10 +73,14 @@ module ContextDev
       #
       #   @param full_screenshot [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot] Optional parameter to determine screenshot type. If 'true', takes a full page sc
       #
+      #   @param max_age_ms [Integer] Return a cached screenshot if a prior screenshot for the same parameters exists
+      #
       #   @param page [Symbol, ContextDev::Models::WebScreenshotParams::Page] Optional parameter to specify which page type to screenshot. If provided, the sy
       #
       #   @param prioritize [Symbol, ContextDev::Models::WebScreenshotParams::Prioritize] Optional parameter to prioritize screenshot capture. If 'speed', optimizes for f
       #
+      #   @param viewport [ContextDev::Models::WebScreenshotParams::Viewport] Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+      #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
       # Optional parameter to determine screenshot type. If 'true', takes a full page
@@ -111,6 +129,27 @@ module ContextDev
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      class Viewport < ContextDev::Internal::Type::BaseModel
+        # @!attribute height
+        #   Viewport height in pixels.
+        #
+        #   @return [Integer, nil]
+        optional :height, Integer
+
+        # @!attribute width
+        #   Viewport width in pixels.
+        #
+        #   @return [Integer, nil]
+        optional :width, Integer
+
+        # @!method initialize(height: nil, width: nil)
+        #   Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+        #
+        #   @param height [Integer] Viewport height in pixels.
+        #
+        #   @param width [Integer] Viewport width in pixels.
+      end
     end
   end
 end

data/lib/context_dev/models/web_screenshot_response.rb

@@ -16,6 +16,12 @@ module ContextDev
       #   @return [String, nil]
       optional :domain, String
 
+      # @!attribute height
+      #   Height in pixels of the returned screenshot image
+      #
+      #   @return [Integer, nil]
+      optional :height, Integer
+
       # @!attribute screenshot
       #   Public URL of the uploaded screenshot image
       #
@@ -36,16 +42,26 @@ module ContextDev
       #   @return [String, nil]
       optional :status, String
 
-      # @!method initialize(code: nil, domain: nil, screenshot: nil, screenshot_type: nil, status: nil)
+      # @!attribute width
+      #   Width in pixels of the returned screenshot image
+      #
+      #   @return [Integer, nil]
+      optional :width, Integer
+
+      # @!method initialize(code: nil, domain: nil, height: nil, screenshot: nil, screenshot_type: nil, status: nil, width: nil)
       #   @param code [Integer] HTTP status code
       #
       #   @param domain [String] The normalized domain that was processed
       #
+      #   @param height [Integer] Height in pixels of the returned screenshot image
+      #
       #   @param screenshot [String] Public URL of the uploaded screenshot image
       #
       #   @param screenshot_type [Symbol, ContextDev::Models::WebScreenshotResponse::ScreenshotType] Type of screenshot that was captured
       #
       #   @param status [String] Status of the response, e.g., 'ok'
+      #
+      #   @param width [Integer] Width in pixels of the returned screenshot image
 
       # Type of screenshot that was captured
       #

data/lib/context_dev/models/web_web_scrape_images_params.rb

@@ -54,7 +54,7 @@ module ContextDev
         optional :hosted_url, ContextDev::Internal::Type::Boolean, api_name: :hostedUrl
 
         # @!attribute max_time_per_ms
-        #   Per-image enrichment timeout in milliseconds. Default: 6000. Maximum: 60000.
+        #   Per-image enrichment timeout in milliseconds. Default: 30000. Maximum: 60000.
         #
         #   @return [Integer, nil]
         optional :max_time_per_ms, Integer, api_name: :maxTimePerMs
@@ -76,7 +76,7 @@ module ContextDev
         #
         #   @param hosted_url [Boolean] Host materializable images on the Brand.dev CDN and return their URL and MIME ty
         #
-        #   @param max_time_per_ms [Integer] Per-image enrichment timeout in milliseconds. Default: 6000. Maximum: 60000.
+        #   @param max_time_per_ms [Integer] Per-image enrichment timeout in milliseconds. Default: 30000. Maximum: 60000.
         #
         #   @param resolution [Boolean] Measure image width and height when possible.
       end

data/lib/context_dev/resources/brand.rb

@@ -9,12 +9,14 @@ module ContextDev
       # Retrieve logos, backdrops, colors, industry, description, and more from any
       # domain
       #
-      # @overload retrieve(domain:, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
+      # @overload retrieve(domain:, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
       #
       # @param domain [String] Domain name to retrieve brand data for (e.g., 'example.com', 'google.com'). Cann
       #
       # @param force_language [Symbol, ContextDev::Models::BrandRetrieveParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
+      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
@@ -30,7 +32,7 @@ module ContextDev
         @client.request(
           method: :get,
           path: "brand/retrieve",
-          query: query.transform_keys(max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
+          query: query.transform_keys(max_age_ms: "maxAgeMs", max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
           model: ContextDev::Models::BrandRetrieveResponse,
           options: options
         )
@@ -86,12 +88,14 @@ module ContextDev
       # free email addresses. Disposable and free email addresses (like gmail.com,
       # yahoo.com) will throw a 422 error.
       #
-      # @overload retrieve_by_email(email:, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
+      # @overload retrieve_by_email(email:, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
       #
       # @param email [String] Email address to retrieve brand data for (e.g., 'contact@example.com'). The doma
       #
       # @param force_language [Symbol, ContextDev::Models::BrandRetrieveByEmailParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
+      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
@@ -107,7 +111,7 @@ module ContextDev
         @client.request(
           method: :get,
           path: "brand/retrieve-by-email",
-          query: query.transform_keys(max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
+          query: query.transform_keys(max_age_ms: "maxAgeMs", max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
           model: ContextDev::Models::BrandRetrieveByEmailResponse,
           options: options
         )
@@ -119,12 +123,14 @@ module ContextDev
       # Retrieve brand information using an ISIN (International Securities
       # Identification Number).
       #
-      # @overload retrieve_by_isin(isin:, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
+      # @overload retrieve_by_isin(isin:, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
       #
       # @param isin [String] ISIN (International Securities Identification Number) to retrieve brand data for
       #
       # @param force_language [Symbol, ContextDev::Models::BrandRetrieveByIsinParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
+      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
@@ -140,7 +146,7 @@ module ContextDev
         @client.request(
           method: :get,
           path: "brand/retrieve-by-isin",
-          query: query.transform_keys(max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
+          query: query.transform_keys(max_age_ms: "maxAgeMs", max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
           model: ContextDev::Models::BrandRetrieveByIsinResponse,
           options: options
         )
@@ -151,7 +157,7 @@ module ContextDev
       #
       # Retrieve brand information using a company name.
       #
-      # @overload retrieve_by_name(name:, country_gl: nil, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
+      # @overload retrieve_by_name(name:, country_gl: nil, force_language: nil, max_age_ms: nil, max_speed: nil, timeout_ms: nil, request_options: {})
       #
       # @param name [String] Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft Corporati
       #
@@ -159,6 +165,8 @@ module ContextDev
       #
       # @param force_language [Symbol, ContextDev::Models::BrandRetrieveByNameParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
+      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
@@ -174,7 +182,7 @@ module ContextDev
         @client.request(
           method: :get,
           path: "brand/retrieve-by-name",
-          query: query.transform_keys(max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
+          query: query.transform_keys(max_age_ms: "maxAgeMs", max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
           model: ContextDev::Models::BrandRetrieveByNameResponse,
           options: options
         )
@@ -185,12 +193,14 @@ module ContextDev
       #
       # Retrieve brand information using a stock ticker symbol.
       #
-      # @overload retrieve_by_ticker(ticker:, force_language: nil, max_speed: nil, ticker_exchange: nil, timeout_ms: nil, request_options: {})
+      # @overload retrieve_by_ticker(ticker:, force_language: nil, max_age_ms: nil, max_speed: nil, ticker_exchange: nil, timeout_ms: nil, request_options: {})
       #
       # @param ticker [String] Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A').
       #
       # @param force_language [Symbol, ContextDev::Models::BrandRetrieveByTickerParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
+      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
       # @param ticker_exchange [Symbol, ContextDev::Models::BrandRetrieveByTickerParams::TickerExchange] Optional stock exchange for the ticker. Defaults to NASDAQ if not specified.
@@ -208,7 +218,7 @@ module ContextDev
         @client.request(
           method: :get,
           path: "brand/retrieve-by-ticker",
-          query: query.transform_keys(max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
+          query: query.transform_keys(max_age_ms: "maxAgeMs", max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
           model: ContextDev::Models::BrandRetrieveByTickerResponse,
           options: options
         )
@@ -221,10 +231,12 @@ module ContextDev
       # information: domain, title, colors, logos, and backdrops. Optimized for faster
       # responses and reduced data transfer.
       #
-      # @overload retrieve_simplified(domain:, timeout_ms: nil, request_options: {})
+      # @overload retrieve_simplified(domain:, max_age_ms: nil, timeout_ms: nil, request_options: {})
       #
       # @param domain [String] Domain name to retrieve simplified brand data for
       #
+      # @param max_age_ms [Integer] Maximum age in milliseconds for cached brand data before the API performs a hard
+      #
       # @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]
@@ -238,7 +250,7 @@ module ContextDev
         @client.request(
           method: :get,
           path: "brand/retrieve-simplified",
-          query: query.transform_keys(timeout_ms: "timeoutMS"),
+          query: query.transform_keys(max_age_ms: "maxAgeMs", timeout_ms: "timeoutMS"),
           model: ContextDev::Models::BrandRetrieveSimplifiedResponse,
           options: options
         )

data/lib/context_dev/resources/web.rb

@@ -70,7 +70,7 @@ module ContextDev
       #
       # Capture a screenshot of a website.
       #
-      # @overload screenshot(direct_url: nil, domain: nil, full_screenshot: nil, page: nil, prioritize: nil, request_options: {})
+      # @overload screenshot(direct_url: nil, domain: nil, full_screenshot: nil, max_age_ms: nil, page: nil, prioritize: nil, viewport: nil, request_options: {})
       #
       # @param direct_url [String] A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https
       #
@@ -78,10 +78,14 @@ module ContextDev
       #
       # @param full_screenshot [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot] Optional parameter to determine screenshot type. If 'true', takes a full page sc
       #
+      # @param max_age_ms [Integer] Return a cached screenshot if a prior screenshot for the same parameters exists
+      #
       # @param page [Symbol, ContextDev::Models::WebScreenshotParams::Page] Optional parameter to specify which page type to screenshot. If provided, the sy
       #
       # @param prioritize [Symbol, ContextDev::Models::WebScreenshotParams::Prioritize] Optional parameter to prioritize screenshot capture. If 'speed', optimizes for f
       #
+      # @param viewport [ContextDev::Models::WebScreenshotParams::Viewport] Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebScreenshotResponse]
@@ -93,7 +97,11 @@ module ContextDev
         @client.request(
           method: :get,
           path: "web/screenshot",
-          query: query.transform_keys(direct_url: "directUrl", full_screenshot: "fullScreenshot"),
+          query: query.transform_keys(
+            direct_url: "directUrl",
+            full_screenshot: "fullScreenshot",
+            max_age_ms: "maxAgeMs"
+          ),
           model: ContextDev::Models::WebScreenshotResponse,
           options: options
         )

data/lib/context_dev/version.rb

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

data/rbi/context_dev/models/brand_retrieve_by_email_params.rbi

@@ -38,6 +38,16 @@ module ContextDev
       end
       attr_writer :force_language
 
+      # Maximum age in milliseconds for cached brand data before the API performs a hard
+      # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
+      # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
+      # year.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :max_age_ms
+
+      sig { params(max_age_ms: Integer).void }
+      attr_writer :max_age_ms
+
       # Optional parameter to optimize the API call for maximum speed. When set to true,
       # the API will skip time-consuming operations for faster response at the cost of
       # less comprehensive data.
@@ -61,6 +71,7 @@ module ContextDev
           email: String,
           force_language:
             ContextDev::BrandRetrieveByEmailParams::ForceLanguage::OrSymbol,
+          max_age_ms: Integer,
           max_speed: T::Boolean,
           timeout_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
@@ -73,6 +84,11 @@ module ContextDev
         email:,
         # Optional parameter to force the language of the retrieved brand data.
         force_language: nil,
+        # Maximum age in milliseconds for cached brand data before the API performs a hard
+        # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
+        # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
+        # year.
+        max_age_ms: nil,
         # Optional parameter to optimize the API call for maximum speed. When set to true,
         # the API will skip time-consuming operations for faster response at the cost of
         # less comprehensive data.
@@ -91,6 +107,7 @@ module ContextDev
             email: String,
             force_language:
               ContextDev::BrandRetrieveByEmailParams::ForceLanguage::OrSymbol,
+            max_age_ms: Integer,
             max_speed: T::Boolean,
             timeout_ms: Integer,
             request_options: ContextDev::RequestOptions