context.dev 1.2.0 → 1.4.0

data/lib/context_dev/models/brand_retrieve_by_ticker_response.rb

@@ -100,6 +100,15 @@ module ContextDev
         #   @return [String, nil]
         optional :phone, String
 
+        # @!attribute primary_language
+        #   The primary language of the brand's website content. Detected from the HTML lang
+        #   tag, page content analysis, or social media descriptions.
+        #
+        #   @return [Symbol, ContextDev::Models::BrandRetrieveByTickerResponse::Brand::PrimaryLanguage, nil]
+        optional :primary_language,
+                 enum: -> { ContextDev::Models::BrandRetrieveByTickerResponse::Brand::PrimaryLanguage },
+                 nil?: true
+
         # @!attribute slogan
         #   The brand's slogan
         #
@@ -126,7 +135,7 @@ module ContextDev
         #   @return [String, nil]
         optional :title, String
 
-        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, email: nil, industries: nil, is_nsfw: nil, links: nil, logos: nil, phone: nil, slogan: nil, socials: nil, stock: nil, title: nil)
+        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, email: nil, industries: nil, is_nsfw: nil, links: nil, logos: nil, phone: nil, primary_language: nil, slogan: nil, socials: nil, stock: nil, title: nil)
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::BrandRetrieveByTickerResponse::Brand} for more details.
         #
@@ -154,6 +163,8 @@ module ContextDev
         #
         #   @param phone [String] Company phone number
         #
+        #   @param primary_language [Symbol, ContextDev::Models::BrandRetrieveByTickerResponse::Brand::PrimaryLanguage, nil] The primary language of the brand's website content. Detected from the HTML lang
+        #
         #   @param slogan [String] The brand's slogan
         #
         #   @param socials [Array<ContextDev::Models::BrandRetrieveByTickerResponse::Brand::Social>] An array of social media links for the brand
@@ -805,12 +816,144 @@ module ContextDev
           end
         end
 
+        # The primary language of the brand's website content. Detected from the HTML lang
+        # tag, page content analysis, or social media descriptions.
+        #
+        # @see ContextDev::Models::BrandRetrieveByTickerResponse::Brand#primary_language
+        module PrimaryLanguage
+          extend ContextDev::Internal::Type::Enum
+
+          AFRIKAANS = :afrikaans
+          ALBANIAN = :albanian
+          AMHARIC = :amharic
+          ARABIC = :arabic
+          ARMENIAN = :armenian
+          ASSAMESE = :assamese
+          AYMARA = :aymara
+          AZERI = :azeri
+          BASQUE = :basque
+          BELARUSIAN = :belarusian
+          BENGALI = :bengali
+          BOSNIAN = :bosnian
+          BULGARIAN = :bulgarian
+          BURMESE = :burmese
+          CANTONESE = :cantonese
+          CATALAN = :catalan
+          CEBUANO = :cebuano
+          CHINESE = :chinese
+          CORSICAN = :corsican
+          CROATIAN = :croatian
+          CZECH = :czech
+          DANISH = :danish
+          DUTCH = :dutch
+          ENGLISH = :english
+          ESPERANTO = :esperanto
+          ESTONIAN = :estonian
+          FARSI = :farsi
+          FIJIAN = :fijian
+          FINNISH = :finnish
+          FRENCH = :french
+          GALICIAN = :galician
+          GEORGIAN = :georgian
+          GERMAN = :german
+          GREEK = :greek
+          GUARANI = :guarani
+          GUJARATI = :gujarati
+          HAITIAN_CREOLE = :"haitian-creole"
+          HAUSA = :hausa
+          HAWAIIAN = :hawaiian
+          HEBREW = :hebrew
+          HINDI = :hindi
+          HMONG = :hmong
+          HUNGARIAN = :hungarian
+          ICELANDIC = :icelandic
+          IGBO = :igbo
+          INDONESIAN = :indonesian
+          IRISH = :irish
+          ITALIAN = :italian
+          JAPANESE = :japanese
+          JAVANESE = :javanese
+          KANNADA = :kannada
+          KAZAKH = :kazakh
+          KHMER = :khmer
+          KINYARWANDA = :kinyarwanda
+          KOREAN = :korean
+          KURDISH = :kurdish
+          KYRGYZ = :kyrgyz
+          LAO = :lao
+          LATIN = :latin
+          LATVIAN = :latvian
+          LINGALA = :lingala
+          LITHUANIAN = :lithuanian
+          LUXEMBOURGISH = :luxembourgish
+          MACEDONIAN = :macedonian
+          MALAGASY = :malagasy
+          MALAY = :malay
+          MALAYALAM = :malayalam
+          MALTESE = :maltese
+          MAORI = :maori
+          MARATHI = :marathi
+          MONGOLIAN = :mongolian
+          NEPALI = :nepali
+          NORWEGIAN = :norwegian
+          ODIA = :odia
+          OROMO = :oromo
+          PASHTO = :pashto
+          PIDGIN = :pidgin
+          POLISH = :polish
+          PORTUGUESE = :portuguese
+          PUNJABI = :punjabi
+          QUECHUA = :quechua
+          ROMANIAN = :romanian
+          RUSSIAN = :russian
+          SAMOAN = :samoan
+          SCOTTISH_GAELIC = :"scottish-gaelic"
+          SERBIAN = :serbian
+          SESOTHO = :sesotho
+          SHONA = :shona
+          SINDHI = :sindhi
+          SINHALA = :sinhala
+          SLOVAK = :slovak
+          SLOVENE = :slovene
+          SOMALI = :somali
+          SPANISH = :spanish
+          SUNDANESE = :sundanese
+          SWAHILI = :swahili
+          SWEDISH = :swedish
+          TAGALOG = :tagalog
+          TAJIK = :tajik
+          TAMIL = :tamil
+          TATAR = :tatar
+          TELUGU = :telugu
+          THAI = :thai
+          TIBETAN = :tibetan
+          TIGRINYA = :tigrinya
+          TONGAN = :tongan
+          TSWANA = :tswana
+          TURKISH = :turkish
+          TURKMEN = :turkmen
+          UKRAINIAN = :ukrainian
+          URDU = :urdu
+          UYGHUR = :uyghur
+          UZBEK = :uzbek
+          VIETNAMESE = :vietnamese
+          WELSH = :welsh
+          WOLOF = :wolof
+          XHOSA = :xhosa
+          YIDDISH = :yiddish
+          YORUBA = :yoruba
+          ZULU = :zulu
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         class Social < ContextDev::Internal::Type::BaseModel
           # @!attribute type
-          #   Type of social media, e.g., 'facebook', 'twitter'
+          #   Type of social media platform
           #
-          #   @return [String, nil]
-          optional :type, String
+          #   @return [Symbol, ContextDev::Models::BrandRetrieveByTickerResponse::Brand::Social::Type, nil]
+          optional :type, enum: -> { ContextDev::Models::BrandRetrieveByTickerResponse::Brand::Social::Type }
 
           # @!attribute url
           #   URL of the social media page
@@ -819,9 +962,51 @@ module ContextDev
           optional :url, String
 
           # @!method initialize(type: nil, url: nil)
-          #   @param type [String] Type of social media, e.g., 'facebook', 'twitter'
+          #   @param type [Symbol, ContextDev::Models::BrandRetrieveByTickerResponse::Brand::Social::Type] Type of social media platform
           #
           #   @param url [String] URL of the social media page
+
+          # Type of social media platform
+          #
+          # @see ContextDev::Models::BrandRetrieveByTickerResponse::Brand::Social#type
+          module Type
+            extend ContextDev::Internal::Type::Enum
+
+            X = :x
+            FACEBOOK = :facebook
+            INSTAGRAM = :instagram
+            LINKEDIN = :linkedin
+            YOUTUBE = :youtube
+            PINTEREST = :pinterest
+            TIKTOK = :tiktok
+            DRIBBBLE = :dribbble
+            GITHUB = :github
+            BEHANCE = :behance
+            SNAPCHAT = :snapchat
+            WHATSAPP = :whatsapp
+            TELEGRAM = :telegram
+            LINE = :line
+            DISCORD = :discord
+            TWITCH = :twitch
+            VIMEO = :vimeo
+            IMDB = :imdb
+            TUMBLR = :tumblr
+            FLICKR = :flickr
+            GIPHY = :giphy
+            MEDIUM = :medium
+            SPOTIFY = :spotify
+            SOUNDCLOUD = :soundcloud
+            TRIPADVISOR = :tripadvisor
+            YELP = :yelp
+            PRODUCTHUNT = :producthunt
+            REDDIT = :reddit
+            CRUNCHBASE = :crunchbase
+            APPSTORE = :appstore
+            PLAYSTORE = :playstore
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
 
         # @see ContextDev::Models::BrandRetrieveByTickerResponse::Brand#stock

data/lib/context_dev/models/brand_retrieve_params.rb

@@ -15,8 +15,7 @@ module ContextDev
       required :domain, String
 
       # @!attribute force_language
-      #   Optional parameter to force the language of the retrieved brand data. Works with
-      #   all three lookup methods.
+      #   Optional parameter to force the language of the retrieved brand data.
       #
       #   @return [Symbol, ContextDev::Models::BrandRetrieveParams::ForceLanguage, nil]
       optional :force_language, enum: -> { ContextDev::BrandRetrieveParams::ForceLanguage }
@@ -43,7 +42,7 @@ module ContextDev
       #
       #   @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. Works with
+      #   @param force_language [Symbol, ContextDev::Models::BrandRetrieveParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
       #
       #   @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
       #
@@ -51,66 +50,130 @@ module ContextDev
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
-      # Optional parameter to force the language of the retrieved brand data. Works with
-      # all three lookup methods.
+      # Optional parameter to force the language of the retrieved brand data.
       module ForceLanguage
         extend ContextDev::Internal::Type::Enum
 
+        AFRIKAANS = :afrikaans
         ALBANIAN = :albanian
+        AMHARIC = :amharic
         ARABIC = :arabic
+        ARMENIAN = :armenian
+        ASSAMESE = :assamese
+        AYMARA = :aymara
         AZERI = :azeri
+        BASQUE = :basque
+        BELARUSIAN = :belarusian
         BENGALI = :bengali
+        BOSNIAN = :bosnian
         BULGARIAN = :bulgarian
+        BURMESE = :burmese
         CANTONESE = :cantonese
+        CATALAN = :catalan
         CEBUANO = :cebuano
+        CHINESE = :chinese
+        CORSICAN = :corsican
         CROATIAN = :croatian
         CZECH = :czech
         DANISH = :danish
         DUTCH = :dutch
         ENGLISH = :english
+        ESPERANTO = :esperanto
         ESTONIAN = :estonian
         FARSI = :farsi
+        FIJIAN = :fijian
         FINNISH = :finnish
         FRENCH = :french
+        GALICIAN = :galician
+        GEORGIAN = :georgian
         GERMAN = :german
+        GREEK = :greek
+        GUARANI = :guarani
+        GUJARATI = :gujarati
+        HAITIAN_CREOLE = :"haitian-creole"
         HAUSA = :hausa
         HAWAIIAN = :hawaiian
+        HEBREW = :hebrew
         HINDI = :hindi
+        HMONG = :hmong
         HUNGARIAN = :hungarian
         ICELANDIC = :icelandic
+        IGBO = :igbo
         INDONESIAN = :indonesian
+        IRISH = :irish
         ITALIAN = :italian
+        JAPANESE = :japanese
+        JAVANESE = :javanese
+        KANNADA = :kannada
         KAZAKH = :kazakh
+        KHMER = :khmer
+        KINYARWANDA = :kinyarwanda
         KOREAN = :korean
+        KURDISH = :kurdish
         KYRGYZ = :kyrgyz
+        LAO = :lao
         LATIN = :latin
         LATVIAN = :latvian
+        LINGALA = :lingala
         LITHUANIAN = :lithuanian
+        LUXEMBOURGISH = :luxembourgish
         MACEDONIAN = :macedonian
+        MALAGASY = :malagasy
+        MALAY = :malay
+        MALAYALAM = :malayalam
+        MALTESE = :maltese
+        MAORI = :maori
+        MARATHI = :marathi
         MONGOLIAN = :mongolian
         NEPALI = :nepali
         NORWEGIAN = :norwegian
+        ODIA = :odia
+        OROMO = :oromo
         PASHTO = :pashto
         PIDGIN = :pidgin
         POLISH = :polish
         PORTUGUESE = :portuguese
+        PUNJABI = :punjabi
+        QUECHUA = :quechua
         ROMANIAN = :romanian
         RUSSIAN = :russian
+        SAMOAN = :samoan
+        SCOTTISH_GAELIC = :"scottish-gaelic"
         SERBIAN = :serbian
+        SESOTHO = :sesotho
+        SHONA = :shona
+        SINDHI = :sindhi
+        SINHALA = :sinhala
         SLOVAK = :slovak
         SLOVENE = :slovene
         SOMALI = :somali
         SPANISH = :spanish
+        SUNDANESE = :sundanese
         SWAHILI = :swahili
         SWEDISH = :swedish
         TAGALOG = :tagalog
+        TAJIK = :tajik
+        TAMIL = :tamil
+        TATAR = :tatar
+        TELUGU = :telugu
         THAI = :thai
+        TIBETAN = :tibetan
+        TIGRINYA = :tigrinya
+        TONGAN = :tongan
+        TSWANA = :tswana
         TURKISH = :turkish
+        TURKMEN = :turkmen
         UKRAINIAN = :ukrainian
         URDU = :urdu
+        UYGHUR = :uyghur
         UZBEK = :uzbek
         VIETNAMESE = :vietnamese
         WELSH = :welsh
+        WOLOF = :wolof
+        XHOSA = :xhosa
+        YIDDISH = :yiddish
+        YORUBA = :yoruba
+        ZULU = :zulu
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/context_dev/models/brand_retrieve_response.rb

@@ -100,6 +100,15 @@ module ContextDev
         #   @return [String, nil]
         optional :phone, String
 
+        # @!attribute primary_language
+        #   The primary language of the brand's website content. Detected from the HTML lang
+        #   tag, page content analysis, or social media descriptions.
+        #
+        #   @return [Symbol, ContextDev::Models::BrandRetrieveResponse::Brand::PrimaryLanguage, nil]
+        optional :primary_language,
+                 enum: -> { ContextDev::Models::BrandRetrieveResponse::Brand::PrimaryLanguage },
+                 nil?: true
+
         # @!attribute slogan
         #   The brand's slogan
         #
@@ -126,7 +135,7 @@ module ContextDev
         #   @return [String, nil]
         optional :title, String
 
-        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, email: nil, industries: nil, is_nsfw: nil, links: nil, logos: nil, phone: nil, slogan: nil, socials: nil, stock: nil, title: nil)
+        # @!method initialize(address: nil, backdrops: nil, colors: nil, description: nil, domain: nil, email: nil, industries: nil, is_nsfw: nil, links: nil, logos: nil, phone: nil, primary_language: nil, slogan: nil, socials: nil, stock: nil, title: nil)
         #   Some parameter documentations has been truncated, see
         #   {ContextDev::Models::BrandRetrieveResponse::Brand} for more details.
         #
@@ -154,6 +163,8 @@ module ContextDev
         #
         #   @param phone [String] Company phone number
         #
+        #   @param primary_language [Symbol, ContextDev::Models::BrandRetrieveResponse::Brand::PrimaryLanguage, nil] The primary language of the brand's website content. Detected from the HTML lang
+        #
         #   @param slogan [String] The brand's slogan
         #
         #   @param socials [Array<ContextDev::Models::BrandRetrieveResponse::Brand::Social>] An array of social media links for the brand
@@ -803,12 +814,144 @@ module ContextDev
           end
         end
 
+        # The primary language of the brand's website content. Detected from the HTML lang
+        # tag, page content analysis, or social media descriptions.
+        #
+        # @see ContextDev::Models::BrandRetrieveResponse::Brand#primary_language
+        module PrimaryLanguage
+          extend ContextDev::Internal::Type::Enum
+
+          AFRIKAANS = :afrikaans
+          ALBANIAN = :albanian
+          AMHARIC = :amharic
+          ARABIC = :arabic
+          ARMENIAN = :armenian
+          ASSAMESE = :assamese
+          AYMARA = :aymara
+          AZERI = :azeri
+          BASQUE = :basque
+          BELARUSIAN = :belarusian
+          BENGALI = :bengali
+          BOSNIAN = :bosnian
+          BULGARIAN = :bulgarian
+          BURMESE = :burmese
+          CANTONESE = :cantonese
+          CATALAN = :catalan
+          CEBUANO = :cebuano
+          CHINESE = :chinese
+          CORSICAN = :corsican
+          CROATIAN = :croatian
+          CZECH = :czech
+          DANISH = :danish
+          DUTCH = :dutch
+          ENGLISH = :english
+          ESPERANTO = :esperanto
+          ESTONIAN = :estonian
+          FARSI = :farsi
+          FIJIAN = :fijian
+          FINNISH = :finnish
+          FRENCH = :french
+          GALICIAN = :galician
+          GEORGIAN = :georgian
+          GERMAN = :german
+          GREEK = :greek
+          GUARANI = :guarani
+          GUJARATI = :gujarati
+          HAITIAN_CREOLE = :"haitian-creole"
+          HAUSA = :hausa
+          HAWAIIAN = :hawaiian
+          HEBREW = :hebrew
+          HINDI = :hindi
+          HMONG = :hmong
+          HUNGARIAN = :hungarian
+          ICELANDIC = :icelandic
+          IGBO = :igbo
+          INDONESIAN = :indonesian
+          IRISH = :irish
+          ITALIAN = :italian
+          JAPANESE = :japanese
+          JAVANESE = :javanese
+          KANNADA = :kannada
+          KAZAKH = :kazakh
+          KHMER = :khmer
+          KINYARWANDA = :kinyarwanda
+          KOREAN = :korean
+          KURDISH = :kurdish
+          KYRGYZ = :kyrgyz
+          LAO = :lao
+          LATIN = :latin
+          LATVIAN = :latvian
+          LINGALA = :lingala
+          LITHUANIAN = :lithuanian
+          LUXEMBOURGISH = :luxembourgish
+          MACEDONIAN = :macedonian
+          MALAGASY = :malagasy
+          MALAY = :malay
+          MALAYALAM = :malayalam
+          MALTESE = :maltese
+          MAORI = :maori
+          MARATHI = :marathi
+          MONGOLIAN = :mongolian
+          NEPALI = :nepali
+          NORWEGIAN = :norwegian
+          ODIA = :odia
+          OROMO = :oromo
+          PASHTO = :pashto
+          PIDGIN = :pidgin
+          POLISH = :polish
+          PORTUGUESE = :portuguese
+          PUNJABI = :punjabi
+          QUECHUA = :quechua
+          ROMANIAN = :romanian
+          RUSSIAN = :russian
+          SAMOAN = :samoan
+          SCOTTISH_GAELIC = :"scottish-gaelic"
+          SERBIAN = :serbian
+          SESOTHO = :sesotho
+          SHONA = :shona
+          SINDHI = :sindhi
+          SINHALA = :sinhala
+          SLOVAK = :slovak
+          SLOVENE = :slovene
+          SOMALI = :somali
+          SPANISH = :spanish
+          SUNDANESE = :sundanese
+          SWAHILI = :swahili
+          SWEDISH = :swedish
+          TAGALOG = :tagalog
+          TAJIK = :tajik
+          TAMIL = :tamil
+          TATAR = :tatar
+          TELUGU = :telugu
+          THAI = :thai
+          TIBETAN = :tibetan
+          TIGRINYA = :tigrinya
+          TONGAN = :tongan
+          TSWANA = :tswana
+          TURKISH = :turkish
+          TURKMEN = :turkmen
+          UKRAINIAN = :ukrainian
+          URDU = :urdu
+          UYGHUR = :uyghur
+          UZBEK = :uzbek
+          VIETNAMESE = :vietnamese
+          WELSH = :welsh
+          WOLOF = :wolof
+          XHOSA = :xhosa
+          YIDDISH = :yiddish
+          YORUBA = :yoruba
+          ZULU = :zulu
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         class Social < ContextDev::Internal::Type::BaseModel
           # @!attribute type
-          #   Type of social media, e.g., 'facebook', 'twitter'
+          #   Type of social media platform
           #
-          #   @return [String, nil]
-          optional :type, String
+          #   @return [Symbol, ContextDev::Models::BrandRetrieveResponse::Brand::Social::Type, nil]
+          optional :type, enum: -> { ContextDev::Models::BrandRetrieveResponse::Brand::Social::Type }
 
           # @!attribute url
           #   URL of the social media page
@@ -817,9 +960,51 @@ module ContextDev
           optional :url, String
 
           # @!method initialize(type: nil, url: nil)
-          #   @param type [String] Type of social media, e.g., 'facebook', 'twitter'
+          #   @param type [Symbol, ContextDev::Models::BrandRetrieveResponse::Brand::Social::Type] Type of social media platform
           #
           #   @param url [String] URL of the social media page
+
+          # Type of social media platform
+          #
+          # @see ContextDev::Models::BrandRetrieveResponse::Brand::Social#type
+          module Type
+            extend ContextDev::Internal::Type::Enum
+
+            X = :x
+            FACEBOOK = :facebook
+            INSTAGRAM = :instagram
+            LINKEDIN = :linkedin
+            YOUTUBE = :youtube
+            PINTEREST = :pinterest
+            TIKTOK = :tiktok
+            DRIBBBLE = :dribbble
+            GITHUB = :github
+            BEHANCE = :behance
+            SNAPCHAT = :snapchat
+            WHATSAPP = :whatsapp
+            TELEGRAM = :telegram
+            LINE = :line
+            DISCORD = :discord
+            TWITCH = :twitch
+            VIMEO = :vimeo
+            IMDB = :imdb
+            TUMBLR = :tumblr
+            FLICKR = :flickr
+            GIPHY = :giphy
+            MEDIUM = :medium
+            SPOTIFY = :spotify
+            SOUNDCLOUD = :soundcloud
+            TRIPADVISOR = :tripadvisor
+            YELP = :yelp
+            PRODUCTHUNT = :producthunt
+            REDDIT = :reddit
+            CRUNCHBASE = :crunchbase
+            APPSTORE = :appstore
+            PLAYSTORE = :playstore
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
 
         # @see ContextDev::Models::BrandRetrieveResponse::Brand#stock

data/lib/context_dev/models/web_screenshot_params.rb

@@ -7,12 +7,20 @@ module ContextDev
       extend ContextDev::Internal::Type::RequestParameters::Converter
       include ContextDev::Internal::Type::RequestParameters
 
+      # @!attribute direct_url
+      #   A specific URL to screenshot directly, bypassing domain resolution (e.g.,
+      #   'https://example.com/pricing'). When provided, the screenshot is taken of this
+      #   exact URL.
+      #
+      #   @return [String, nil]
+      optional :direct_url, String
+
       # @!attribute domain
       #   Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The
       #   domain will be automatically normalized and validated.
       #
-      #   @return [String]
-      required :domain, String
+      #   @return [String, nil]
+      optional :domain, String
 
       # @!attribute full_screenshot
       #   Optional parameter to determine screenshot type. If 'true', takes a full page
@@ -26,7 +34,8 @@ module ContextDev
       #   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
       #   appropriate URL for the specified page type (30 supported languages). If not
-      #   provided, screenshots the main domain landing page.
+      #   provided, screenshots the main domain landing page. Only applicable when using
+      #   'domain', not 'directUrl'.
       #
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Page, nil]
       optional :page, enum: -> { ContextDev::WebScreenshotParams::Page }
@@ -39,10 +48,12 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Prioritize, nil]
       optional :prioritize, enum: -> { ContextDev::WebScreenshotParams::Prioritize }
 
-      # @!method initialize(domain:, full_screenshot: nil, page: nil, prioritize: nil, request_options: {})
+      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, page: nil, prioritize: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebScreenshotParams} for more details.
       #
+      #   @param direct_url [String] A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https
+      #
       #   @param domain [String] Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The domai
       #
       #   @param full_screenshot [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot] Optional parameter to determine screenshot type. If 'true', takes a full page sc
@@ -69,7 +80,8 @@ module ContextDev
       # 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
       # appropriate URL for the specified page type (30 supported languages). If not
-      # provided, screenshots the main domain landing page.
+      # provided, screenshots the main domain landing page. Only applicable when using
+      # 'domain', not 'directUrl'.
       module Page
         extend ContextDev::Internal::Type::Enum