brand.dev 0.9.1 → 0.12.0

package/src/resources/brand.ts

@@ -6,8 +6,8 @@ import { RequestOptions } from '../internal/request-options';
 
 export class Brand extends APIResource {
   /**
-   * Retrieve brand information using one of three methods: domain name, company
-   * name, or stock ticker symbol. Exactly one of these parameters must be provided.
+   * Retrieve logos, backdrops, colors, industry, description, and more from any
+   * domain
    */
   retrieve(
     query: BrandRetrieveParams | null | undefined = {},
@@ -46,6 +46,41 @@ export class Brand extends APIResource {
     return this._client.post('/brand/prefetch', { body, ...options });
   }
 
+  /**
+   * Retrieve brand information using an email address while detecting disposable and
+   * free email addresses. This endpoint extracts the domain from the email address
+   * and returns brand data for that domain. Disposable and free email addresses
+   * (like gmail.com, yahoo.com) will throw a 422 error.
+   */
+  retrieveByEmail(
+    query: BrandRetrieveByEmailParams,
+    options?: RequestOptions,
+  ): APIPromise<BrandRetrieveByEmailResponse> {
+    return this._client.get('/brand/retrieve-by-email', { query, ...options });
+  }
+
+  /**
+   * Retrieve brand information using a company name. This endpoint searches for the
+   * company by name and returns its brand data.
+   */
+  retrieveByName(
+    query: BrandRetrieveByNameParams,
+    options?: RequestOptions,
+  ): APIPromise<BrandRetrieveByNameResponse> {
+    return this._client.get('/brand/retrieve-by-name', { query, ...options });
+  }
+
+  /**
+   * Retrieve brand information using a stock ticker symbol. This endpoint looks up
+   * the company associated with the ticker and returns its brand data.
+   */
+  retrieveByTicker(
+    query: BrandRetrieveByTickerParams,
+    options?: RequestOptions,
+  ): APIPromise<BrandRetrieveByTickerResponse> {
+    return this._client.get('/brand/retrieve-by-ticker', { query, ...options });
+  }
+
   /**
    * Endpoint to classify any brand into a 2022 NAICS code.
    */
@@ -1339,84 +1374,99 @@ export interface BrandPrefetchResponse {
   status?: string;
 }
 
-export interface BrandRetrieveNaicsResponse {
+export interface BrandRetrieveByEmailResponse {
   /**
-   * Array of NAICS codes and titles.
+   * Detailed brand information
    */
-  codes?: Array<BrandRetrieveNaicsResponse.Code>;
+  brand?: BrandRetrieveByEmailResponse.Brand;
 
   /**
-   * Domain found for the brand
+   * HTTP status code
    */
-  domain?: string;
+  code?: number;
 
   /**
    * Status of the response, e.g., 'ok'
    */
   status?: string;
+}
 
+export namespace BrandRetrieveByEmailResponse {
   /**
-   * Industry classification type, for naics api it will be `naics`
+   * Detailed brand information
    */
-  type?: string;
-}
+  export interface Brand {
+    /**
+     * Physical address of the brand
+     */
+    address?: Brand.Address;
 
-export namespace BrandRetrieveNaicsResponse {
-  export interface Code {
     /**
-     * NAICS code
+     * An array of backdrop images for the brand
      */
-    code?: string;
+    backdrops?: Array<Brand.Backdrop>;
 
     /**
-     * NAICS title
+     * An array of brand colors
      */
-    title?: string;
-  }
-}
+    colors?: Array<Brand.Color>;
 
-export interface BrandRetrieveSimplifiedResponse {
-  /**
-   * Simplified brand information
-   */
-  brand?: BrandRetrieveSimplifiedResponse.Brand;
+    /**
+     * A brief description of the brand
+     */
+    description?: string;
 
-  /**
-   * HTTP status code of the response
-   */
-  code?: number;
+    /**
+     * The domain name of the brand
+     */
+    domain?: string;
 
-  /**
-   * Status of the response, e.g., 'ok'
-   */
-  status?: string;
-}
+    /**
+     * Company email address
+     */
+    email?: string;
 
-export namespace BrandRetrieveSimplifiedResponse {
-  /**
-   * Simplified brand information
-   */
-  export interface Brand {
     /**
-     * An array of backdrop images for the brand
+     * Industry classification information for the brand
      */
-    backdrops?: Array<Brand.Backdrop>;
+    industries?: Brand.Industries;
 
     /**
-     * An array of brand colors
+     * Indicates whether the brand content is not safe for work (NSFW)
      */
-    colors?: Array<Brand.Color>;
+    is_nsfw?: boolean;
 
     /**
-     * The domain name of the brand
+     * Important website links for the brand
      */
-    domain?: string;
+    links?: Brand.Links;
 
     /**
      * An array of logos associated with the brand
      */
     logos?: Array<Brand.Logo>;
 
+    /**
+     * Company phone number
+     */
+    phone?: string;
+
+    /**
+     * The brand's slogan
+     */
+    slogan?: string;
+
+    /**
+     * An array of social media links for the brand
+     */
+    socials?: Array<Brand.Social>;
+
+    /**
+     * Stock market information for this brand (will be null if not a publicly traded
+     * company)
+     */
+    stock?: Brand.Stock;
+
     /**
      * The title or name of the brand
      */
@@ -1424,6 +1474,46 @@ export namespace BrandRetrieveSimplifiedResponse {
   }
 
   export namespace Brand {
+    /**
+     * Physical address of the brand
+     */
+    export interface Address {
+      /**
+       * City name
+       */
+      city?: string;
+
+      /**
+       * Country name
+       */
+      country?: string;
+
+      /**
+       * Country code
+       */
+      country_code?: string;
+
+      /**
+       * Postal or ZIP code
+       */
+      postal_code?: string;
+
+      /**
+       * State or province code
+       */
+      state_code?: string;
+
+      /**
+       * State or province name
+       */
+      state_province?: string;
+
+      /**
+       * Street address
+       */
+      street?: string;
+    }
+
     export interface Backdrop {
       /**
        * Array of colors in the backdrop image
@@ -1487,87 +1577,1829 @@ export namespace BrandRetrieveSimplifiedResponse {
       name?: string;
     }
 
-    export interface Logo {
-      /**
-       * Array of colors in the logo
-       */
-      colors?: Array<Logo.Color>;
-
-      /**
-       * Indicates when this logo is best used: 'light' = best for light mode, 'dark' =
-       * best for dark mode, 'has_opaque_background' = can be used for either as image
-       * has its own background
-       */
-      mode?: 'light' | 'dark' | 'has_opaque_background';
-
-      /**
-       * Resolution of the logo image
-       */
-      resolution?: Logo.Resolution;
-
-      /**
-       * Type of the logo based on resolution (e.g., 'icon', 'logo')
-       */
-      type?: 'icon' | 'logo';
-
+    /**
+     * Industry classification information for the brand
+     */
+    export interface Industries {
       /**
-       * CDN hosted url of the logo (ready for display)
+       * Easy Industry Classification - array of industry and subindustry pairs
        */
-      url?: string;
+      eic?: Array<Industries.Eic>;
     }
 
-    export namespace Logo {
-      export interface Color {
-        /**
-         * Color in hexadecimal format
-         */
-        hex?: string;
-
-        /**
-         * Name of the color
-         */
-        name?: string;
-      }
-
-      /**
-       * Resolution of the logo image
-       */
-      export interface Resolution {
-        /**
-         * Aspect ratio of the image (width/height)
-         */
-        aspect_ratio?: number;
-
+    export namespace Industries {
+      export interface Eic {
         /**
-         * Height of the image in pixels
+         * Industry classification enum
          */
-        height?: number;
+        industry:
+          | 'Aerospace & Defense'
+          | 'Technology'
+          | 'Finance'
+          | 'Healthcare'
+          | 'Retail & E-commerce'
+          | 'Entertainment'
+          | 'Education'
+          | 'Government & Nonprofit'
+          | 'Industrial & Energy'
+          | 'Automotive & Transportation'
+          | 'Lifestyle & Leisure'
+          | 'Luxury & Fashion'
+          | 'News & Media'
+          | 'Sports'
+          | 'Real Estate & PropTech'
+          | 'Legal & Compliance'
+          | 'Telecommunications'
+          | 'Agriculture & Food'
+          | 'Professional Services & Agencies'
+          | 'Chemicals & Materials'
+          | 'Logistics & Supply Chain'
+          | 'Hospitality & Tourism'
+          | 'Construction & Built Environment'
+          | 'Consumer Packaged Goods (CPG)';
 
         /**
-         * Width of the image in pixels
+         * Subindustry classification enum
          */
-        width?: number;
-      }
-    }
-  }
-}
-
-export interface BrandScreenshotResponse {
-  /**
-   * HTTP status code
-   */
-  code?: number;
-
-  /**
-   * The normalized domain that was processed
-   */
-  domain?: string;
-
-  /**
-   * Public URL of the uploaded screenshot image
-   */
-  screenshot?: string;
-
+        subindustry:
+          | 'Defense Systems & Military Hardware'
+          | 'Aerospace Manufacturing'
+          | 'Avionics & Navigation Technology'
+          | 'Subsea & Naval Defense Systems'
+          | 'Space & Satellite Technology'
+          | 'Defense IT & Systems Integration'
+          | 'Software (B2B)'
+          | 'Software (B2C)'
+          | 'Cloud Infrastructure & DevOps'
+          | 'Cybersecurity'
+          | 'Artificial Intelligence & Machine Learning'
+          | 'Data Infrastructure & Analytics'
+          | 'Hardware & Semiconductors'
+          | 'Fintech Infrastructure'
+          | 'eCommerce & Marketplace Platforms'
+          | 'Developer Tools & APIs'
+          | 'Web3 & Blockchain'
+          | 'XR & Spatial Computing'
+          | 'Banking & Lending'
+          | 'Investment Management & WealthTech'
+          | 'Insurance & InsurTech'
+          | 'Payments & Money Movement'
+          | 'Accounting, Tax & Financial Planning Tools'
+          | 'Capital Markets & Trading Platforms'
+          | 'Financial Infrastructure & APIs'
+          | 'Credit Scoring & Risk Management'
+          | 'Cryptocurrency & Digital Assets'
+          | 'BNPL & Alternative Financing'
+          | 'Healthcare Providers & Services'
+          | 'Pharmaceuticals & Drug Development'
+          | 'Medical Devices & Diagnostics'
+          | 'Biotechnology & Genomics'
+          | 'Digital Health & Telemedicine'
+          | 'Health Insurance & Benefits Tech'
+          | 'Clinical Trials & Research Platforms'
+          | 'Mental Health & Wellness'
+          | 'Healthcare IT & EHR Systems'
+          | 'Consumer Health & Wellness Products'
+          | 'Online Marketplaces'
+          | 'Direct-to-Consumer (DTC) Brands'
+          | 'Retail Tech & Point-of-Sale Systems'
+          | 'Omnichannel & In-Store Retail'
+          | 'E-commerce Enablement & Infrastructure'
+          | 'Subscription & Membership Commerce'
+          | 'Social Commerce & Influencer Platforms'
+          | 'Fashion & Apparel Retail'
+          | 'Food, Beverage & Grocery E-commerce'
+          | 'Streaming Platforms (Video, Music, Audio)'
+          | 'Gaming & Interactive Entertainment'
+          | 'Creator Economy & Influencer Platforms'
+          | 'Advertising, Adtech & Media Buying'
+          | 'Film, TV & Production Studios'
+          | 'Events, Venues & Live Entertainment'
+          | 'Virtual Worlds & Metaverse Experiences'
+          | 'K-12 Education Platforms & Tools'
+          | 'Higher Education & University Tech'
+          | 'Online Learning & MOOCs'
+          | 'Test Prep & Certification'
+          | 'Corporate Training & Upskilling'
+          | 'Tutoring & Supplemental Learning'
+          | 'Education Management Systems (LMS/SIS)'
+          | 'Language Learning'
+          | 'Creator-Led & Cohort-Based Courses'
+          | 'Special Education & Accessibility Tools'
+          | 'Government Technology & Digital Services'
+          | 'Civic Engagement & Policy Platforms'
+          | 'International Development & Humanitarian Aid'
+          | 'Philanthropy & Grantmaking'
+          | 'Nonprofit Operations & Fundraising Tools'
+          | 'Public Health & Social Services'
+          | 'Education & Youth Development Programs'
+          | 'Environmental & Climate Action Organizations'
+          | 'Legal Aid & Social Justice Advocacy'
+          | 'Municipal & Infrastructure Services'
+          | 'Manufacturing & Industrial Automation'
+          | 'Energy Production (Oil, Gas, Nuclear)'
+          | 'Renewable Energy & Cleantech'
+          | 'Utilities & Grid Infrastructure'
+          | 'Industrial IoT & Monitoring Systems'
+          | 'Construction & Heavy Equipment'
+          | 'Mining & Natural Resources'
+          | 'Environmental Engineering & Sustainability'
+          | 'Energy Storage & Battery Technology'
+          | 'Automotive OEMs & Vehicle Manufacturing'
+          | 'Electric Vehicles (EVs) & Charging Infrastructure'
+          | 'Mobility-as-a-Service (MaaS)'
+          | 'Fleet Management'
+          | 'Public Transit & Urban Mobility'
+          | 'Autonomous Vehicles & ADAS'
+          | 'Aftermarket Parts & Services'
+          | 'Telematics & Vehicle Connectivity'
+          | 'Aviation & Aerospace Transport'
+          | 'Maritime Shipping'
+          | 'Fitness & Wellness'
+          | 'Beauty & Personal Care'
+          | 'Home & Living'
+          | 'Dating & Relationships'
+          | 'Hobbies, Crafts & DIY'
+          | 'Outdoor & Recreational Gear'
+          | 'Events, Experiences & Ticketing Platforms'
+          | 'Designer & Luxury Apparel'
+          | 'Accessories, Jewelry & Watches'
+          | 'Footwear & Leather Goods'
+          | 'Beauty, Fragrance & Skincare'
+          | 'Fashion Marketplaces & Retail Platforms'
+          | 'Sustainable & Ethical Fashion'
+          | 'Resale, Vintage & Circular Fashion'
+          | 'Fashion Tech & Virtual Try-Ons'
+          | 'Streetwear & Emerging Luxury'
+          | 'Couture & Made-to-Measure'
+          | 'News Publishing & Journalism'
+          | 'Digital Media & Content Platforms'
+          | 'Broadcasting (TV & Radio)'
+          | 'Podcasting & Audio Media'
+          | 'News Aggregators & Curation Tools'
+          | 'Independent & Creator-Led Media'
+          | 'Newsletters & Substack-Style Platforms'
+          | 'Political & Investigative Media'
+          | 'Trade & Niche Publications'
+          | 'Media Monitoring & Analytics'
+          | 'Professional Teams & Leagues'
+          | 'Sports Media & Broadcasting'
+          | 'Sports Betting & Fantasy Sports'
+          | 'Fitness & Athletic Training Platforms'
+          | 'Sportswear & Equipment'
+          | 'Esports & Competitive Gaming'
+          | 'Sports Venues & Event Management'
+          | 'Athlete Management & Talent Agencies'
+          | 'Sports Tech & Performance Analytics'
+          | 'Youth, Amateur & Collegiate Sports'
+          | 'Real Estate Marketplaces'
+          | 'Property Management Software'
+          | 'Rental Platforms'
+          | 'Mortgage & Lending Tech'
+          | 'Real Estate Investment Platforms'
+          | 'Law Firms & Legal Services'
+          | 'Legal Tech & Automation'
+          | 'Regulatory Compliance'
+          | 'E-Discovery & Litigation Tools'
+          | 'Contract Management'
+          | 'Governance, Risk & Compliance (GRC)'
+          | 'IP & Trademark Management'
+          | 'Legal Research & Intelligence'
+          | 'Compliance Training & Certification'
+          | 'Whistleblower & Ethics Reporting'
+          | 'Mobile & Wireless Networks (3G/4G/5G)'
+          | 'Broadband & Fiber Internet'
+          | 'Satellite & Space-Based Communications'
+          | 'Network Equipment & Infrastructure'
+          | 'Telecom Billing & OSS/BSS Systems'
+          | 'VoIP & Unified Communications'
+          | 'Internet Service Providers (ISPs)'
+          | 'Edge Computing & Network Virtualization'
+          | 'IoT Connectivity Platforms'
+          | 'Precision Agriculture & AgTech'
+          | 'Crop & Livestock Production'
+          | 'Food & Beverage Manufacturing & Processing'
+          | 'Food Distribution'
+          | 'Restaurants & Food Service'
+          | 'Agricultural Inputs & Equipment'
+          | 'Sustainable & Regenerative Agriculture'
+          | 'Seafood & Aquaculture'
+          | 'Management Consulting'
+          | 'Marketing & Advertising Agencies'
+          | 'Design, Branding & Creative Studios'
+          | 'IT Services & Managed Services'
+          | 'Staffing, Recruiting & Talent'
+          | 'Accounting & Tax Firms'
+          | 'Public Relations & Communications'
+          | 'Business Process Outsourcing (BPO)'
+          | 'Professional Training & Coaching'
+          | 'Specialty Chemicals'
+          | 'Commodity & Petrochemicals'
+          | 'Polymers, Plastics & Rubber'
+          | 'Coatings, Adhesives & Sealants'
+          | 'Industrial Gases'
+          | 'Advanced Materials & Composites'
+          | 'Battery Materials & Energy Storage'
+          | 'Electronic Materials & Semiconductor Chemicals'
+          | 'Agrochemicals & Fertilizers'
+          | 'Freight & Transportation Tech'
+          | 'Last-Mile Delivery'
+          | 'Warehouse Automation'
+          | 'Supply Chain Visibility Platforms'
+          | 'Logistics Marketplaces'
+          | 'Shipping & Freight Forwarding'
+          | 'Cold Chain Logistics'
+          | 'Reverse Logistics & Returns'
+          | 'Cross-Border Trade Tech'
+          | 'Transportation Management Systems (TMS)'
+          | 'Hotels & Accommodation'
+          | 'Vacation Rentals & Short-Term Stays'
+          | 'Restaurant Tech & Management'
+          | 'Travel Booking Platforms'
+          | 'Tourism Experiences & Activities'
+          | 'Cruise Lines & Marine Tourism'
+          | 'Hospitality Management Systems'
+          | 'Event & Venue Management'
+          | 'Corporate Travel Management'
+          | 'Travel Insurance & Protection'
+          | 'Construction Management Software'
+          | 'BIM/CAD & Design Tools'
+          | 'Construction Marketplaces'
+          | 'Equipment Rental & Management'
+          | 'Building Materials & Procurement'
+          | 'Construction Workforce Management'
+          | 'Project Estimation & Bidding'
+          | 'Modular & Prefab Construction'
+          | 'Construction Safety & Compliance'
+          | 'Smart Building Technology'
+          | 'Food & Beverage CPG'
+          | 'Home & Personal Care CPG'
+          | 'CPG Analytics & Insights'
+          | 'Direct-to-Consumer CPG Brands'
+          | 'CPG Supply Chain & Distribution'
+          | 'Private Label Manufacturing'
+          | 'CPG Retail Intelligence'
+          | 'Sustainable CPG & Packaging'
+          | 'Beauty & Cosmetics CPG'
+          | 'Health & Wellness CPG';
+      }
+    }
+
+    /**
+     * Important website links for the brand
+     */
+    export interface Links {
+      /**
+       * URL to the brand's blog or news page
+       */
+      blog?: string | null;
+
+      /**
+       * URL to the brand's careers or job opportunities page
+       */
+      careers?: string | null;
+
+      /**
+       * URL to the brand's contact or contact us page
+       */
+      contact?: string | null;
+
+      /**
+       * URL to the brand's pricing or plans page
+       */
+      pricing?: string | null;
+
+      /**
+       * URL to the brand's privacy policy page
+       */
+      privacy?: string | null;
+
+      /**
+       * URL to the brand's terms of service or terms and conditions page
+       */
+      terms?: string | null;
+    }
+
+    export interface Logo {
+      /**
+       * Array of colors in the logo
+       */
+      colors?: Array<Logo.Color>;
+
+      /**
+       * Indicates when this logo is best used: 'light' = best for light mode, 'dark' =
+       * best for dark mode, 'has_opaque_background' = can be used for either as image
+       * has its own background
+       */
+      mode?: 'light' | 'dark' | 'has_opaque_background';
+
+      /**
+       * Resolution of the logo image
+       */
+      resolution?: Logo.Resolution;
+
+      /**
+       * Type of the logo based on resolution (e.g., 'icon', 'logo')
+       */
+      type?: 'icon' | 'logo';
+
+      /**
+       * CDN hosted url of the logo (ready for display)
+       */
+      url?: string;
+    }
+
+    export namespace Logo {
+      export interface Color {
+        /**
+         * Color in hexadecimal format
+         */
+        hex?: string;
+
+        /**
+         * Name of the color
+         */
+        name?: string;
+      }
+
+      /**
+       * Resolution of the logo image
+       */
+      export interface Resolution {
+        /**
+         * Aspect ratio of the image (width/height)
+         */
+        aspect_ratio?: number;
+
+        /**
+         * Height of the image in pixels
+         */
+        height?: number;
+
+        /**
+         * Width of the image in pixels
+         */
+        width?: number;
+      }
+    }
+
+    export interface Social {
+      /**
+       * Type of social media, e.g., 'facebook', 'twitter'
+       */
+      type?: string;
+
+      /**
+       * URL of the social media page
+       */
+      url?: string;
+    }
+
+    /**
+     * Stock market information for this brand (will be null if not a publicly traded
+     * company)
+     */
+    export interface Stock {
+      /**
+       * Stock exchange name
+       */
+      exchange?: string;
+
+      /**
+       * Stock ticker symbol
+       */
+      ticker?: string;
+    }
+  }
+}
+
+export interface BrandRetrieveByNameResponse {
+  /**
+   * Detailed brand information
+   */
+  brand?: BrandRetrieveByNameResponse.Brand;
+
+  /**
+   * HTTP status code
+   */
+  code?: number;
+
+  /**
+   * Status of the response, e.g., 'ok'
+   */
+  status?: string;
+}
+
+export namespace BrandRetrieveByNameResponse {
+  /**
+   * Detailed brand information
+   */
+  export interface Brand {
+    /**
+     * Physical address of the brand
+     */
+    address?: Brand.Address;
+
+    /**
+     * An array of backdrop images for the brand
+     */
+    backdrops?: Array<Brand.Backdrop>;
+
+    /**
+     * An array of brand colors
+     */
+    colors?: Array<Brand.Color>;
+
+    /**
+     * A brief description of the brand
+     */
+    description?: string;
+
+    /**
+     * The domain name of the brand
+     */
+    domain?: string;
+
+    /**
+     * Company email address
+     */
+    email?: string;
+
+    /**
+     * Industry classification information for the brand
+     */
+    industries?: Brand.Industries;
+
+    /**
+     * Indicates whether the brand content is not safe for work (NSFW)
+     */
+    is_nsfw?: boolean;
+
+    /**
+     * Important website links for the brand
+     */
+    links?: Brand.Links;
+
+    /**
+     * An array of logos associated with the brand
+     */
+    logos?: Array<Brand.Logo>;
+
+    /**
+     * Company phone number
+     */
+    phone?: string;
+
+    /**
+     * The brand's slogan
+     */
+    slogan?: string;
+
+    /**
+     * An array of social media links for the brand
+     */
+    socials?: Array<Brand.Social>;
+
+    /**
+     * Stock market information for this brand (will be null if not a publicly traded
+     * company)
+     */
+    stock?: Brand.Stock;
+
+    /**
+     * The title or name of the brand
+     */
+    title?: string;
+  }
+
+  export namespace Brand {
+    /**
+     * Physical address of the brand
+     */
+    export interface Address {
+      /**
+       * City name
+       */
+      city?: string;
+
+      /**
+       * Country name
+       */
+      country?: string;
+
+      /**
+       * Country code
+       */
+      country_code?: string;
+
+      /**
+       * Postal or ZIP code
+       */
+      postal_code?: string;
+
+      /**
+       * State or province code
+       */
+      state_code?: string;
+
+      /**
+       * State or province name
+       */
+      state_province?: string;
+
+      /**
+       * Street address
+       */
+      street?: string;
+    }
+
+    export interface Backdrop {
+      /**
+       * Array of colors in the backdrop image
+       */
+      colors?: Array<Backdrop.Color>;
+
+      /**
+       * Resolution of the backdrop image
+       */
+      resolution?: Backdrop.Resolution;
+
+      /**
+       * URL of the backdrop image
+       */
+      url?: string;
+    }
+
+    export namespace Backdrop {
+      export interface Color {
+        /**
+         * Color in hexadecimal format
+         */
+        hex?: string;
+
+        /**
+         * Name of the color
+         */
+        name?: string;
+      }
+
+      /**
+       * Resolution of the backdrop image
+       */
+      export interface Resolution {
+        /**
+         * Aspect ratio of the image (width/height)
+         */
+        aspect_ratio?: number;
+
+        /**
+         * Height of the image in pixels
+         */
+        height?: number;
+
+        /**
+         * Width of the image in pixels
+         */
+        width?: number;
+      }
+    }
+
+    export interface Color {
+      /**
+       * Color in hexadecimal format
+       */
+      hex?: string;
+
+      /**
+       * Name of the color
+       */
+      name?: string;
+    }
+
+    /**
+     * Industry classification information for the brand
+     */
+    export interface Industries {
+      /**
+       * Easy Industry Classification - array of industry and subindustry pairs
+       */
+      eic?: Array<Industries.Eic>;
+    }
+
+    export namespace Industries {
+      export interface Eic {
+        /**
+         * Industry classification enum
+         */
+        industry:
+          | 'Aerospace & Defense'
+          | 'Technology'
+          | 'Finance'
+          | 'Healthcare'
+          | 'Retail & E-commerce'
+          | 'Entertainment'
+          | 'Education'
+          | 'Government & Nonprofit'
+          | 'Industrial & Energy'
+          | 'Automotive & Transportation'
+          | 'Lifestyle & Leisure'
+          | 'Luxury & Fashion'
+          | 'News & Media'
+          | 'Sports'
+          | 'Real Estate & PropTech'
+          | 'Legal & Compliance'
+          | 'Telecommunications'
+          | 'Agriculture & Food'
+          | 'Professional Services & Agencies'
+          | 'Chemicals & Materials'
+          | 'Logistics & Supply Chain'
+          | 'Hospitality & Tourism'
+          | 'Construction & Built Environment'
+          | 'Consumer Packaged Goods (CPG)';
+
+        /**
+         * Subindustry classification enum
+         */
+        subindustry:
+          | 'Defense Systems & Military Hardware'
+          | 'Aerospace Manufacturing'
+          | 'Avionics & Navigation Technology'
+          | 'Subsea & Naval Defense Systems'
+          | 'Space & Satellite Technology'
+          | 'Defense IT & Systems Integration'
+          | 'Software (B2B)'
+          | 'Software (B2C)'
+          | 'Cloud Infrastructure & DevOps'
+          | 'Cybersecurity'
+          | 'Artificial Intelligence & Machine Learning'
+          | 'Data Infrastructure & Analytics'
+          | 'Hardware & Semiconductors'
+          | 'Fintech Infrastructure'
+          | 'eCommerce & Marketplace Platforms'
+          | 'Developer Tools & APIs'
+          | 'Web3 & Blockchain'
+          | 'XR & Spatial Computing'
+          | 'Banking & Lending'
+          | 'Investment Management & WealthTech'
+          | 'Insurance & InsurTech'
+          | 'Payments & Money Movement'
+          | 'Accounting, Tax & Financial Planning Tools'
+          | 'Capital Markets & Trading Platforms'
+          | 'Financial Infrastructure & APIs'
+          | 'Credit Scoring & Risk Management'
+          | 'Cryptocurrency & Digital Assets'
+          | 'BNPL & Alternative Financing'
+          | 'Healthcare Providers & Services'
+          | 'Pharmaceuticals & Drug Development'
+          | 'Medical Devices & Diagnostics'
+          | 'Biotechnology & Genomics'
+          | 'Digital Health & Telemedicine'
+          | 'Health Insurance & Benefits Tech'
+          | 'Clinical Trials & Research Platforms'
+          | 'Mental Health & Wellness'
+          | 'Healthcare IT & EHR Systems'
+          | 'Consumer Health & Wellness Products'
+          | 'Online Marketplaces'
+          | 'Direct-to-Consumer (DTC) Brands'
+          | 'Retail Tech & Point-of-Sale Systems'
+          | 'Omnichannel & In-Store Retail'
+          | 'E-commerce Enablement & Infrastructure'
+          | 'Subscription & Membership Commerce'
+          | 'Social Commerce & Influencer Platforms'
+          | 'Fashion & Apparel Retail'
+          | 'Food, Beverage & Grocery E-commerce'
+          | 'Streaming Platforms (Video, Music, Audio)'
+          | 'Gaming & Interactive Entertainment'
+          | 'Creator Economy & Influencer Platforms'
+          | 'Advertising, Adtech & Media Buying'
+          | 'Film, TV & Production Studios'
+          | 'Events, Venues & Live Entertainment'
+          | 'Virtual Worlds & Metaverse Experiences'
+          | 'K-12 Education Platforms & Tools'
+          | 'Higher Education & University Tech'
+          | 'Online Learning & MOOCs'
+          | 'Test Prep & Certification'
+          | 'Corporate Training & Upskilling'
+          | 'Tutoring & Supplemental Learning'
+          | 'Education Management Systems (LMS/SIS)'
+          | 'Language Learning'
+          | 'Creator-Led & Cohort-Based Courses'
+          | 'Special Education & Accessibility Tools'
+          | 'Government Technology & Digital Services'
+          | 'Civic Engagement & Policy Platforms'
+          | 'International Development & Humanitarian Aid'
+          | 'Philanthropy & Grantmaking'
+          | 'Nonprofit Operations & Fundraising Tools'
+          | 'Public Health & Social Services'
+          | 'Education & Youth Development Programs'
+          | 'Environmental & Climate Action Organizations'
+          | 'Legal Aid & Social Justice Advocacy'
+          | 'Municipal & Infrastructure Services'
+          | 'Manufacturing & Industrial Automation'
+          | 'Energy Production (Oil, Gas, Nuclear)'
+          | 'Renewable Energy & Cleantech'
+          | 'Utilities & Grid Infrastructure'
+          | 'Industrial IoT & Monitoring Systems'
+          | 'Construction & Heavy Equipment'
+          | 'Mining & Natural Resources'
+          | 'Environmental Engineering & Sustainability'
+          | 'Energy Storage & Battery Technology'
+          | 'Automotive OEMs & Vehicle Manufacturing'
+          | 'Electric Vehicles (EVs) & Charging Infrastructure'
+          | 'Mobility-as-a-Service (MaaS)'
+          | 'Fleet Management'
+          | 'Public Transit & Urban Mobility'
+          | 'Autonomous Vehicles & ADAS'
+          | 'Aftermarket Parts & Services'
+          | 'Telematics & Vehicle Connectivity'
+          | 'Aviation & Aerospace Transport'
+          | 'Maritime Shipping'
+          | 'Fitness & Wellness'
+          | 'Beauty & Personal Care'
+          | 'Home & Living'
+          | 'Dating & Relationships'
+          | 'Hobbies, Crafts & DIY'
+          | 'Outdoor & Recreational Gear'
+          | 'Events, Experiences & Ticketing Platforms'
+          | 'Designer & Luxury Apparel'
+          | 'Accessories, Jewelry & Watches'
+          | 'Footwear & Leather Goods'
+          | 'Beauty, Fragrance & Skincare'
+          | 'Fashion Marketplaces & Retail Platforms'
+          | 'Sustainable & Ethical Fashion'
+          | 'Resale, Vintage & Circular Fashion'
+          | 'Fashion Tech & Virtual Try-Ons'
+          | 'Streetwear & Emerging Luxury'
+          | 'Couture & Made-to-Measure'
+          | 'News Publishing & Journalism'
+          | 'Digital Media & Content Platforms'
+          | 'Broadcasting (TV & Radio)'
+          | 'Podcasting & Audio Media'
+          | 'News Aggregators & Curation Tools'
+          | 'Independent & Creator-Led Media'
+          | 'Newsletters & Substack-Style Platforms'
+          | 'Political & Investigative Media'
+          | 'Trade & Niche Publications'
+          | 'Media Monitoring & Analytics'
+          | 'Professional Teams & Leagues'
+          | 'Sports Media & Broadcasting'
+          | 'Sports Betting & Fantasy Sports'
+          | 'Fitness & Athletic Training Platforms'
+          | 'Sportswear & Equipment'
+          | 'Esports & Competitive Gaming'
+          | 'Sports Venues & Event Management'
+          | 'Athlete Management & Talent Agencies'
+          | 'Sports Tech & Performance Analytics'
+          | 'Youth, Amateur & Collegiate Sports'
+          | 'Real Estate Marketplaces'
+          | 'Property Management Software'
+          | 'Rental Platforms'
+          | 'Mortgage & Lending Tech'
+          | 'Real Estate Investment Platforms'
+          | 'Law Firms & Legal Services'
+          | 'Legal Tech & Automation'
+          | 'Regulatory Compliance'
+          | 'E-Discovery & Litigation Tools'
+          | 'Contract Management'
+          | 'Governance, Risk & Compliance (GRC)'
+          | 'IP & Trademark Management'
+          | 'Legal Research & Intelligence'
+          | 'Compliance Training & Certification'
+          | 'Whistleblower & Ethics Reporting'
+          | 'Mobile & Wireless Networks (3G/4G/5G)'
+          | 'Broadband & Fiber Internet'
+          | 'Satellite & Space-Based Communications'
+          | 'Network Equipment & Infrastructure'
+          | 'Telecom Billing & OSS/BSS Systems'
+          | 'VoIP & Unified Communications'
+          | 'Internet Service Providers (ISPs)'
+          | 'Edge Computing & Network Virtualization'
+          | 'IoT Connectivity Platforms'
+          | 'Precision Agriculture & AgTech'
+          | 'Crop & Livestock Production'
+          | 'Food & Beverage Manufacturing & Processing'
+          | 'Food Distribution'
+          | 'Restaurants & Food Service'
+          | 'Agricultural Inputs & Equipment'
+          | 'Sustainable & Regenerative Agriculture'
+          | 'Seafood & Aquaculture'
+          | 'Management Consulting'
+          | 'Marketing & Advertising Agencies'
+          | 'Design, Branding & Creative Studios'
+          | 'IT Services & Managed Services'
+          | 'Staffing, Recruiting & Talent'
+          | 'Accounting & Tax Firms'
+          | 'Public Relations & Communications'
+          | 'Business Process Outsourcing (BPO)'
+          | 'Professional Training & Coaching'
+          | 'Specialty Chemicals'
+          | 'Commodity & Petrochemicals'
+          | 'Polymers, Plastics & Rubber'
+          | 'Coatings, Adhesives & Sealants'
+          | 'Industrial Gases'
+          | 'Advanced Materials & Composites'
+          | 'Battery Materials & Energy Storage'
+          | 'Electronic Materials & Semiconductor Chemicals'
+          | 'Agrochemicals & Fertilizers'
+          | 'Freight & Transportation Tech'
+          | 'Last-Mile Delivery'
+          | 'Warehouse Automation'
+          | 'Supply Chain Visibility Platforms'
+          | 'Logistics Marketplaces'
+          | 'Shipping & Freight Forwarding'
+          | 'Cold Chain Logistics'
+          | 'Reverse Logistics & Returns'
+          | 'Cross-Border Trade Tech'
+          | 'Transportation Management Systems (TMS)'
+          | 'Hotels & Accommodation'
+          | 'Vacation Rentals & Short-Term Stays'
+          | 'Restaurant Tech & Management'
+          | 'Travel Booking Platforms'
+          | 'Tourism Experiences & Activities'
+          | 'Cruise Lines & Marine Tourism'
+          | 'Hospitality Management Systems'
+          | 'Event & Venue Management'
+          | 'Corporate Travel Management'
+          | 'Travel Insurance & Protection'
+          | 'Construction Management Software'
+          | 'BIM/CAD & Design Tools'
+          | 'Construction Marketplaces'
+          | 'Equipment Rental & Management'
+          | 'Building Materials & Procurement'
+          | 'Construction Workforce Management'
+          | 'Project Estimation & Bidding'
+          | 'Modular & Prefab Construction'
+          | 'Construction Safety & Compliance'
+          | 'Smart Building Technology'
+          | 'Food & Beverage CPG'
+          | 'Home & Personal Care CPG'
+          | 'CPG Analytics & Insights'
+          | 'Direct-to-Consumer CPG Brands'
+          | 'CPG Supply Chain & Distribution'
+          | 'Private Label Manufacturing'
+          | 'CPG Retail Intelligence'
+          | 'Sustainable CPG & Packaging'
+          | 'Beauty & Cosmetics CPG'
+          | 'Health & Wellness CPG';
+      }
+    }
+
+    /**
+     * Important website links for the brand
+     */
+    export interface Links {
+      /**
+       * URL to the brand's blog or news page
+       */
+      blog?: string | null;
+
+      /**
+       * URL to the brand's careers or job opportunities page
+       */
+      careers?: string | null;
+
+      /**
+       * URL to the brand's contact or contact us page
+       */
+      contact?: string | null;
+
+      /**
+       * URL to the brand's pricing or plans page
+       */
+      pricing?: string | null;
+
+      /**
+       * URL to the brand's privacy policy page
+       */
+      privacy?: string | null;
+
+      /**
+       * URL to the brand's terms of service or terms and conditions page
+       */
+      terms?: string | null;
+    }
+
+    export interface Logo {
+      /**
+       * Array of colors in the logo
+       */
+      colors?: Array<Logo.Color>;
+
+      /**
+       * Indicates when this logo is best used: 'light' = best for light mode, 'dark' =
+       * best for dark mode, 'has_opaque_background' = can be used for either as image
+       * has its own background
+       */
+      mode?: 'light' | 'dark' | 'has_opaque_background';
+
+      /**
+       * Resolution of the logo image
+       */
+      resolution?: Logo.Resolution;
+
+      /**
+       * Type of the logo based on resolution (e.g., 'icon', 'logo')
+       */
+      type?: 'icon' | 'logo';
+
+      /**
+       * CDN hosted url of the logo (ready for display)
+       */
+      url?: string;
+    }
+
+    export namespace Logo {
+      export interface Color {
+        /**
+         * Color in hexadecimal format
+         */
+        hex?: string;
+
+        /**
+         * Name of the color
+         */
+        name?: string;
+      }
+
+      /**
+       * Resolution of the logo image
+       */
+      export interface Resolution {
+        /**
+         * Aspect ratio of the image (width/height)
+         */
+        aspect_ratio?: number;
+
+        /**
+         * Height of the image in pixels
+         */
+        height?: number;
+
+        /**
+         * Width of the image in pixels
+         */
+        width?: number;
+      }
+    }
+
+    export interface Social {
+      /**
+       * Type of social media, e.g., 'facebook', 'twitter'
+       */
+      type?: string;
+
+      /**
+       * URL of the social media page
+       */
+      url?: string;
+    }
+
+    /**
+     * Stock market information for this brand (will be null if not a publicly traded
+     * company)
+     */
+    export interface Stock {
+      /**
+       * Stock exchange name
+       */
+      exchange?: string;
+
+      /**
+       * Stock ticker symbol
+       */
+      ticker?: string;
+    }
+  }
+}
+
+export interface BrandRetrieveByTickerResponse {
+  /**
+   * Detailed brand information
+   */
+  brand?: BrandRetrieveByTickerResponse.Brand;
+
+  /**
+   * HTTP status code
+   */
+  code?: number;
+
+  /**
+   * Status of the response, e.g., 'ok'
+   */
+  status?: string;
+}
+
+export namespace BrandRetrieveByTickerResponse {
+  /**
+   * Detailed brand information
+   */
+  export interface Brand {
+    /**
+     * Physical address of the brand
+     */
+    address?: Brand.Address;
+
+    /**
+     * An array of backdrop images for the brand
+     */
+    backdrops?: Array<Brand.Backdrop>;
+
+    /**
+     * An array of brand colors
+     */
+    colors?: Array<Brand.Color>;
+
+    /**
+     * A brief description of the brand
+     */
+    description?: string;
+
+    /**
+     * The domain name of the brand
+     */
+    domain?: string;
+
+    /**
+     * Company email address
+     */
+    email?: string;
+
+    /**
+     * Industry classification information for the brand
+     */
+    industries?: Brand.Industries;
+
+    /**
+     * Indicates whether the brand content is not safe for work (NSFW)
+     */
+    is_nsfw?: boolean;
+
+    /**
+     * Important website links for the brand
+     */
+    links?: Brand.Links;
+
+    /**
+     * An array of logos associated with the brand
+     */
+    logos?: Array<Brand.Logo>;
+
+    /**
+     * Company phone number
+     */
+    phone?: string;
+
+    /**
+     * The brand's slogan
+     */
+    slogan?: string;
+
+    /**
+     * An array of social media links for the brand
+     */
+    socials?: Array<Brand.Social>;
+
+    /**
+     * Stock market information for this brand (will be null if not a publicly traded
+     * company)
+     */
+    stock?: Brand.Stock;
+
+    /**
+     * The title or name of the brand
+     */
+    title?: string;
+  }
+
+  export namespace Brand {
+    /**
+     * Physical address of the brand
+     */
+    export interface Address {
+      /**
+       * City name
+       */
+      city?: string;
+
+      /**
+       * Country name
+       */
+      country?: string;
+
+      /**
+       * Country code
+       */
+      country_code?: string;
+
+      /**
+       * Postal or ZIP code
+       */
+      postal_code?: string;
+
+      /**
+       * State or province code
+       */
+      state_code?: string;
+
+      /**
+       * State or province name
+       */
+      state_province?: string;
+
+      /**
+       * Street address
+       */
+      street?: string;
+    }
+
+    export interface Backdrop {
+      /**
+       * Array of colors in the backdrop image
+       */
+      colors?: Array<Backdrop.Color>;
+
+      /**
+       * Resolution of the backdrop image
+       */
+      resolution?: Backdrop.Resolution;
+
+      /**
+       * URL of the backdrop image
+       */
+      url?: string;
+    }
+
+    export namespace Backdrop {
+      export interface Color {
+        /**
+         * Color in hexadecimal format
+         */
+        hex?: string;
+
+        /**
+         * Name of the color
+         */
+        name?: string;
+      }
+
+      /**
+       * Resolution of the backdrop image
+       */
+      export interface Resolution {
+        /**
+         * Aspect ratio of the image (width/height)
+         */
+        aspect_ratio?: number;
+
+        /**
+         * Height of the image in pixels
+         */
+        height?: number;
+
+        /**
+         * Width of the image in pixels
+         */
+        width?: number;
+      }
+    }
+
+    export interface Color {
+      /**
+       * Color in hexadecimal format
+       */
+      hex?: string;
+
+      /**
+       * Name of the color
+       */
+      name?: string;
+    }
+
+    /**
+     * Industry classification information for the brand
+     */
+    export interface Industries {
+      /**
+       * Easy Industry Classification - array of industry and subindustry pairs
+       */
+      eic?: Array<Industries.Eic>;
+    }
+
+    export namespace Industries {
+      export interface Eic {
+        /**
+         * Industry classification enum
+         */
+        industry:
+          | 'Aerospace & Defense'
+          | 'Technology'
+          | 'Finance'
+          | 'Healthcare'
+          | 'Retail & E-commerce'
+          | 'Entertainment'
+          | 'Education'
+          | 'Government & Nonprofit'
+          | 'Industrial & Energy'
+          | 'Automotive & Transportation'
+          | 'Lifestyle & Leisure'
+          | 'Luxury & Fashion'
+          | 'News & Media'
+          | 'Sports'
+          | 'Real Estate & PropTech'
+          | 'Legal & Compliance'
+          | 'Telecommunications'
+          | 'Agriculture & Food'
+          | 'Professional Services & Agencies'
+          | 'Chemicals & Materials'
+          | 'Logistics & Supply Chain'
+          | 'Hospitality & Tourism'
+          | 'Construction & Built Environment'
+          | 'Consumer Packaged Goods (CPG)';
+
+        /**
+         * Subindustry classification enum
+         */
+        subindustry:
+          | 'Defense Systems & Military Hardware'
+          | 'Aerospace Manufacturing'
+          | 'Avionics & Navigation Technology'
+          | 'Subsea & Naval Defense Systems'
+          | 'Space & Satellite Technology'
+          | 'Defense IT & Systems Integration'
+          | 'Software (B2B)'
+          | 'Software (B2C)'
+          | 'Cloud Infrastructure & DevOps'
+          | 'Cybersecurity'
+          | 'Artificial Intelligence & Machine Learning'
+          | 'Data Infrastructure & Analytics'
+          | 'Hardware & Semiconductors'
+          | 'Fintech Infrastructure'
+          | 'eCommerce & Marketplace Platforms'
+          | 'Developer Tools & APIs'
+          | 'Web3 & Blockchain'
+          | 'XR & Spatial Computing'
+          | 'Banking & Lending'
+          | 'Investment Management & WealthTech'
+          | 'Insurance & InsurTech'
+          | 'Payments & Money Movement'
+          | 'Accounting, Tax & Financial Planning Tools'
+          | 'Capital Markets & Trading Platforms'
+          | 'Financial Infrastructure & APIs'
+          | 'Credit Scoring & Risk Management'
+          | 'Cryptocurrency & Digital Assets'
+          | 'BNPL & Alternative Financing'
+          | 'Healthcare Providers & Services'
+          | 'Pharmaceuticals & Drug Development'
+          | 'Medical Devices & Diagnostics'
+          | 'Biotechnology & Genomics'
+          | 'Digital Health & Telemedicine'
+          | 'Health Insurance & Benefits Tech'
+          | 'Clinical Trials & Research Platforms'
+          | 'Mental Health & Wellness'
+          | 'Healthcare IT & EHR Systems'
+          | 'Consumer Health & Wellness Products'
+          | 'Online Marketplaces'
+          | 'Direct-to-Consumer (DTC) Brands'
+          | 'Retail Tech & Point-of-Sale Systems'
+          | 'Omnichannel & In-Store Retail'
+          | 'E-commerce Enablement & Infrastructure'
+          | 'Subscription & Membership Commerce'
+          | 'Social Commerce & Influencer Platforms'
+          | 'Fashion & Apparel Retail'
+          | 'Food, Beverage & Grocery E-commerce'
+          | 'Streaming Platforms (Video, Music, Audio)'
+          | 'Gaming & Interactive Entertainment'
+          | 'Creator Economy & Influencer Platforms'
+          | 'Advertising, Adtech & Media Buying'
+          | 'Film, TV & Production Studios'
+          | 'Events, Venues & Live Entertainment'
+          | 'Virtual Worlds & Metaverse Experiences'
+          | 'K-12 Education Platforms & Tools'
+          | 'Higher Education & University Tech'
+          | 'Online Learning & MOOCs'
+          | 'Test Prep & Certification'
+          | 'Corporate Training & Upskilling'
+          | 'Tutoring & Supplemental Learning'
+          | 'Education Management Systems (LMS/SIS)'
+          | 'Language Learning'
+          | 'Creator-Led & Cohort-Based Courses'
+          | 'Special Education & Accessibility Tools'
+          | 'Government Technology & Digital Services'
+          | 'Civic Engagement & Policy Platforms'
+          | 'International Development & Humanitarian Aid'
+          | 'Philanthropy & Grantmaking'
+          | 'Nonprofit Operations & Fundraising Tools'
+          | 'Public Health & Social Services'
+          | 'Education & Youth Development Programs'
+          | 'Environmental & Climate Action Organizations'
+          | 'Legal Aid & Social Justice Advocacy'
+          | 'Municipal & Infrastructure Services'
+          | 'Manufacturing & Industrial Automation'
+          | 'Energy Production (Oil, Gas, Nuclear)'
+          | 'Renewable Energy & Cleantech'
+          | 'Utilities & Grid Infrastructure'
+          | 'Industrial IoT & Monitoring Systems'
+          | 'Construction & Heavy Equipment'
+          | 'Mining & Natural Resources'
+          | 'Environmental Engineering & Sustainability'
+          | 'Energy Storage & Battery Technology'
+          | 'Automotive OEMs & Vehicle Manufacturing'
+          | 'Electric Vehicles (EVs) & Charging Infrastructure'
+          | 'Mobility-as-a-Service (MaaS)'
+          | 'Fleet Management'
+          | 'Public Transit & Urban Mobility'
+          | 'Autonomous Vehicles & ADAS'
+          | 'Aftermarket Parts & Services'
+          | 'Telematics & Vehicle Connectivity'
+          | 'Aviation & Aerospace Transport'
+          | 'Maritime Shipping'
+          | 'Fitness & Wellness'
+          | 'Beauty & Personal Care'
+          | 'Home & Living'
+          | 'Dating & Relationships'
+          | 'Hobbies, Crafts & DIY'
+          | 'Outdoor & Recreational Gear'
+          | 'Events, Experiences & Ticketing Platforms'
+          | 'Designer & Luxury Apparel'
+          | 'Accessories, Jewelry & Watches'
+          | 'Footwear & Leather Goods'
+          | 'Beauty, Fragrance & Skincare'
+          | 'Fashion Marketplaces & Retail Platforms'
+          | 'Sustainable & Ethical Fashion'
+          | 'Resale, Vintage & Circular Fashion'
+          | 'Fashion Tech & Virtual Try-Ons'
+          | 'Streetwear & Emerging Luxury'
+          | 'Couture & Made-to-Measure'
+          | 'News Publishing & Journalism'
+          | 'Digital Media & Content Platforms'
+          | 'Broadcasting (TV & Radio)'
+          | 'Podcasting & Audio Media'
+          | 'News Aggregators & Curation Tools'
+          | 'Independent & Creator-Led Media'
+          | 'Newsletters & Substack-Style Platforms'
+          | 'Political & Investigative Media'
+          | 'Trade & Niche Publications'
+          | 'Media Monitoring & Analytics'
+          | 'Professional Teams & Leagues'
+          | 'Sports Media & Broadcasting'
+          | 'Sports Betting & Fantasy Sports'
+          | 'Fitness & Athletic Training Platforms'
+          | 'Sportswear & Equipment'
+          | 'Esports & Competitive Gaming'
+          | 'Sports Venues & Event Management'
+          | 'Athlete Management & Talent Agencies'
+          | 'Sports Tech & Performance Analytics'
+          | 'Youth, Amateur & Collegiate Sports'
+          | 'Real Estate Marketplaces'
+          | 'Property Management Software'
+          | 'Rental Platforms'
+          | 'Mortgage & Lending Tech'
+          | 'Real Estate Investment Platforms'
+          | 'Law Firms & Legal Services'
+          | 'Legal Tech & Automation'
+          | 'Regulatory Compliance'
+          | 'E-Discovery & Litigation Tools'
+          | 'Contract Management'
+          | 'Governance, Risk & Compliance (GRC)'
+          | 'IP & Trademark Management'
+          | 'Legal Research & Intelligence'
+          | 'Compliance Training & Certification'
+          | 'Whistleblower & Ethics Reporting'
+          | 'Mobile & Wireless Networks (3G/4G/5G)'
+          | 'Broadband & Fiber Internet'
+          | 'Satellite & Space-Based Communications'
+          | 'Network Equipment & Infrastructure'
+          | 'Telecom Billing & OSS/BSS Systems'
+          | 'VoIP & Unified Communications'
+          | 'Internet Service Providers (ISPs)'
+          | 'Edge Computing & Network Virtualization'
+          | 'IoT Connectivity Platforms'
+          | 'Precision Agriculture & AgTech'
+          | 'Crop & Livestock Production'
+          | 'Food & Beverage Manufacturing & Processing'
+          | 'Food Distribution'
+          | 'Restaurants & Food Service'
+          | 'Agricultural Inputs & Equipment'
+          | 'Sustainable & Regenerative Agriculture'
+          | 'Seafood & Aquaculture'
+          | 'Management Consulting'
+          | 'Marketing & Advertising Agencies'
+          | 'Design, Branding & Creative Studios'
+          | 'IT Services & Managed Services'
+          | 'Staffing, Recruiting & Talent'
+          | 'Accounting & Tax Firms'
+          | 'Public Relations & Communications'
+          | 'Business Process Outsourcing (BPO)'
+          | 'Professional Training & Coaching'
+          | 'Specialty Chemicals'
+          | 'Commodity & Petrochemicals'
+          | 'Polymers, Plastics & Rubber'
+          | 'Coatings, Adhesives & Sealants'
+          | 'Industrial Gases'
+          | 'Advanced Materials & Composites'
+          | 'Battery Materials & Energy Storage'
+          | 'Electronic Materials & Semiconductor Chemicals'
+          | 'Agrochemicals & Fertilizers'
+          | 'Freight & Transportation Tech'
+          | 'Last-Mile Delivery'
+          | 'Warehouse Automation'
+          | 'Supply Chain Visibility Platforms'
+          | 'Logistics Marketplaces'
+          | 'Shipping & Freight Forwarding'
+          | 'Cold Chain Logistics'
+          | 'Reverse Logistics & Returns'
+          | 'Cross-Border Trade Tech'
+          | 'Transportation Management Systems (TMS)'
+          | 'Hotels & Accommodation'
+          | 'Vacation Rentals & Short-Term Stays'
+          | 'Restaurant Tech & Management'
+          | 'Travel Booking Platforms'
+          | 'Tourism Experiences & Activities'
+          | 'Cruise Lines & Marine Tourism'
+          | 'Hospitality Management Systems'
+          | 'Event & Venue Management'
+          | 'Corporate Travel Management'
+          | 'Travel Insurance & Protection'
+          | 'Construction Management Software'
+          | 'BIM/CAD & Design Tools'
+          | 'Construction Marketplaces'
+          | 'Equipment Rental & Management'
+          | 'Building Materials & Procurement'
+          | 'Construction Workforce Management'
+          | 'Project Estimation & Bidding'
+          | 'Modular & Prefab Construction'
+          | 'Construction Safety & Compliance'
+          | 'Smart Building Technology'
+          | 'Food & Beverage CPG'
+          | 'Home & Personal Care CPG'
+          | 'CPG Analytics & Insights'
+          | 'Direct-to-Consumer CPG Brands'
+          | 'CPG Supply Chain & Distribution'
+          | 'Private Label Manufacturing'
+          | 'CPG Retail Intelligence'
+          | 'Sustainable CPG & Packaging'
+          | 'Beauty & Cosmetics CPG'
+          | 'Health & Wellness CPG';
+      }
+    }
+
+    /**
+     * Important website links for the brand
+     */
+    export interface Links {
+      /**
+       * URL to the brand's blog or news page
+       */
+      blog?: string | null;
+
+      /**
+       * URL to the brand's careers or job opportunities page
+       */
+      careers?: string | null;
+
+      /**
+       * URL to the brand's contact or contact us page
+       */
+      contact?: string | null;
+
+      /**
+       * URL to the brand's pricing or plans page
+       */
+      pricing?: string | null;
+
+      /**
+       * URL to the brand's privacy policy page
+       */
+      privacy?: string | null;
+
+      /**
+       * URL to the brand's terms of service or terms and conditions page
+       */
+      terms?: string | null;
+    }
+
+    export interface Logo {
+      /**
+       * Array of colors in the logo
+       */
+      colors?: Array<Logo.Color>;
+
+      /**
+       * Indicates when this logo is best used: 'light' = best for light mode, 'dark' =
+       * best for dark mode, 'has_opaque_background' = can be used for either as image
+       * has its own background
+       */
+      mode?: 'light' | 'dark' | 'has_opaque_background';
+
+      /**
+       * Resolution of the logo image
+       */
+      resolution?: Logo.Resolution;
+
+      /**
+       * Type of the logo based on resolution (e.g., 'icon', 'logo')
+       */
+      type?: 'icon' | 'logo';
+
+      /**
+       * CDN hosted url of the logo (ready for display)
+       */
+      url?: string;
+    }
+
+    export namespace Logo {
+      export interface Color {
+        /**
+         * Color in hexadecimal format
+         */
+        hex?: string;
+
+        /**
+         * Name of the color
+         */
+        name?: string;
+      }
+
+      /**
+       * Resolution of the logo image
+       */
+      export interface Resolution {
+        /**
+         * Aspect ratio of the image (width/height)
+         */
+        aspect_ratio?: number;
+
+        /**
+         * Height of the image in pixels
+         */
+        height?: number;
+
+        /**
+         * Width of the image in pixels
+         */
+        width?: number;
+      }
+    }
+
+    export interface Social {
+      /**
+       * Type of social media, e.g., 'facebook', 'twitter'
+       */
+      type?: string;
+
+      /**
+       * URL of the social media page
+       */
+      url?: string;
+    }
+
+    /**
+     * Stock market information for this brand (will be null if not a publicly traded
+     * company)
+     */
+    export interface Stock {
+      /**
+       * Stock exchange name
+       */
+      exchange?: string;
+
+      /**
+       * Stock ticker symbol
+       */
+      ticker?: string;
+    }
+  }
+}
+
+export interface BrandRetrieveNaicsResponse {
+  /**
+   * Array of NAICS codes and titles.
+   */
+  codes?: Array<BrandRetrieveNaicsResponse.Code>;
+
+  /**
+   * Domain found for the brand
+   */
+  domain?: string;
+
+  /**
+   * Status of the response, e.g., 'ok'
+   */
+  status?: string;
+
+  /**
+   * Industry classification type, for naics api it will be `naics`
+   */
+  type?: string;
+}
+
+export namespace BrandRetrieveNaicsResponse {
+  export interface Code {
+    /**
+     * NAICS code
+     */
+    code?: string;
+
+    /**
+     * NAICS title
+     */
+    title?: string;
+  }
+}
+
+export interface BrandRetrieveSimplifiedResponse {
+  /**
+   * Simplified brand information
+   */
+  brand?: BrandRetrieveSimplifiedResponse.Brand;
+
+  /**
+   * HTTP status code of the response
+   */
+  code?: number;
+
+  /**
+   * Status of the response, e.g., 'ok'
+   */
+  status?: string;
+}
+
+export namespace BrandRetrieveSimplifiedResponse {
+  /**
+   * Simplified brand information
+   */
+  export interface Brand {
+    /**
+     * An array of backdrop images for the brand
+     */
+    backdrops?: Array<Brand.Backdrop>;
+
+    /**
+     * An array of brand colors
+     */
+    colors?: Array<Brand.Color>;
+
+    /**
+     * The domain name of the brand
+     */
+    domain?: string;
+
+    /**
+     * An array of logos associated with the brand
+     */
+    logos?: Array<Brand.Logo>;
+
+    /**
+     * The title or name of the brand
+     */
+    title?: string;
+  }
+
+  export namespace Brand {
+    export interface Backdrop {
+      /**
+       * Array of colors in the backdrop image
+       */
+      colors?: Array<Backdrop.Color>;
+
+      /**
+       * Resolution of the backdrop image
+       */
+      resolution?: Backdrop.Resolution;
+
+      /**
+       * URL of the backdrop image
+       */
+      url?: string;
+    }
+
+    export namespace Backdrop {
+      export interface Color {
+        /**
+         * Color in hexadecimal format
+         */
+        hex?: string;
+
+        /**
+         * Name of the color
+         */
+        name?: string;
+      }
+
+      /**
+       * Resolution of the backdrop image
+       */
+      export interface Resolution {
+        /**
+         * Aspect ratio of the image (width/height)
+         */
+        aspect_ratio?: number;
+
+        /**
+         * Height of the image in pixels
+         */
+        height?: number;
+
+        /**
+         * Width of the image in pixels
+         */
+        width?: number;
+      }
+    }
+
+    export interface Color {
+      /**
+       * Color in hexadecimal format
+       */
+      hex?: string;
+
+      /**
+       * Name of the color
+       */
+      name?: string;
+    }
+
+    export interface Logo {
+      /**
+       * Array of colors in the logo
+       */
+      colors?: Array<Logo.Color>;
+
+      /**
+       * Indicates when this logo is best used: 'light' = best for light mode, 'dark' =
+       * best for dark mode, 'has_opaque_background' = can be used for either as image
+       * has its own background
+       */
+      mode?: 'light' | 'dark' | 'has_opaque_background';
+
+      /**
+       * Resolution of the logo image
+       */
+      resolution?: Logo.Resolution;
+
+      /**
+       * Type of the logo based on resolution (e.g., 'icon', 'logo')
+       */
+      type?: 'icon' | 'logo';
+
+      /**
+       * CDN hosted url of the logo (ready for display)
+       */
+      url?: string;
+    }
+
+    export namespace Logo {
+      export interface Color {
+        /**
+         * Color in hexadecimal format
+         */
+        hex?: string;
+
+        /**
+         * Name of the color
+         */
+        name?: string;
+      }
+
+      /**
+       * Resolution of the logo image
+       */
+      export interface Resolution {
+        /**
+         * Aspect ratio of the image (width/height)
+         */
+        aspect_ratio?: number;
+
+        /**
+         * Height of the image in pixels
+         */
+        height?: number;
+
+        /**
+         * Width of the image in pixels
+         */
+        width?: number;
+      }
+    }
+  }
+}
+
+export interface BrandScreenshotResponse {
+  /**
+   * HTTP status code
+   */
+  code?: number;
+
+  /**
+   * The normalized domain that was processed
+   */
+  domain?: string;
+
+  /**
+   * Public URL of the uploaded screenshot image
+   */
+  screenshot?: string;
+
   /**
    * Type of screenshot that was captured
    */
@@ -1881,91 +3713,435 @@ export namespace BrandStyleguideResponse {
       export interface Headings {
         h1?: Headings.H1;
 
-        h2?: Headings.H2;
+        h2?: Headings.H2;
+
+        h3?: Headings.H3;
+
+        h4?: Headings.H4;
+      }
+
+      export namespace Headings {
+        export interface H1 {
+          fontFamily?: string;
+
+          fontSize?: string;
+
+          fontWeight?: number;
+
+          letterSpacing?: string;
+
+          lineHeight?: string;
+        }
+
+        export interface H2 {
+          fontFamily?: string;
+
+          fontSize?: string;
+
+          fontWeight?: number;
+
+          letterSpacing?: string;
+
+          lineHeight?: string;
+        }
+
+        export interface H3 {
+          fontFamily?: string;
+
+          fontSize?: string;
+
+          fontWeight?: number;
+
+          letterSpacing?: string;
+
+          lineHeight?: string;
+        }
+
+        export interface H4 {
+          fontFamily?: string;
+
+          fontSize?: string;
+
+          fontWeight?: number;
+
+          letterSpacing?: string;
+
+          lineHeight?: string;
+        }
+      }
+
+      /**
+       * Paragraph text styles
+       */
+      export interface P {
+        fontFamily?: string;
+
+        fontSize?: string;
+
+        fontWeight?: number;
+
+        letterSpacing?: string;
+
+        lineHeight?: string;
+      }
+    }
+  }
+}
+
+export interface BrandRetrieveParams {
+  /**
+   * Domain name to retrieve brand data for (e.g., 'example.com', 'google.com').
+   * Cannot be used with name or ticker parameters.
+   */
+  domain?: string;
+
+  /**
+   * Optional parameter to force the language of the retrieved brand data. Works with
+   * all three lookup methods.
+   */
+  force_language?:
+    | 'albanian'
+    | 'arabic'
+    | 'azeri'
+    | 'bengali'
+    | 'bulgarian'
+    | 'cebuano'
+    | 'croatian'
+    | 'czech'
+    | 'danish'
+    | 'dutch'
+    | 'english'
+    | 'estonian'
+    | 'farsi'
+    | 'finnish'
+    | 'french'
+    | 'german'
+    | 'hausa'
+    | 'hawaiian'
+    | 'hindi'
+    | 'hungarian'
+    | 'icelandic'
+    | 'indonesian'
+    | 'italian'
+    | 'kazakh'
+    | 'kyrgyz'
+    | 'latin'
+    | 'latvian'
+    | 'lithuanian'
+    | 'macedonian'
+    | 'mongolian'
+    | 'nepali'
+    | 'norwegian'
+    | 'pashto'
+    | 'pidgin'
+    | 'polish'
+    | 'portuguese'
+    | 'romanian'
+    | 'russian'
+    | 'serbian'
+    | 'slovak'
+    | 'slovene'
+    | 'somali'
+    | 'spanish'
+    | 'swahili'
+    | 'swedish'
+    | 'tagalog'
+    | 'turkish'
+    | 'ukrainian'
+    | 'urdu'
+    | 'uzbek'
+    | 'vietnamese'
+    | 'welsh';
+
+  /**
+   * 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. Works with all three lookup methods.
+   */
+  maxSpeed?: boolean;
 
-        h3?: Headings.H3;
+  /**
+   * 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).
+   */
+  timeoutMS?: number;
+}
 
-        h4?: Headings.H4;
-      }
+export interface BrandAIQueryParams {
+  /**
+   * Array of data points to extract from the website
+   */
+  data_to_extract: Array<BrandAIQueryParams.DataToExtract>;
 
-      export namespace Headings {
-        export interface H1 {
-          fontFamily?: string;
+  /**
+   * The domain name to analyze
+   */
+  domain: string;
 
-          fontSize?: string;
+  /**
+   * Optional object specifying which pages to analyze
+   */
+  specific_pages?: BrandAIQueryParams.SpecificPages;
 
-          fontWeight?: number;
+  /**
+   * 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).
+   */
+  timeoutMS?: number;
+}
 
-          letterSpacing?: string;
+export namespace BrandAIQueryParams {
+  export interface DataToExtract {
+    /**
+     * Description of what to extract
+     */
+    datapoint_description: string;
 
-          lineHeight?: string;
-        }
+    /**
+     * Example of the expected value
+     */
+    datapoint_example: string;
 
-        export interface H2 {
-          fontFamily?: string;
+    /**
+     * Name of the data point to extract
+     */
+    datapoint_name: string;
 
-          fontSize?: string;
+    /**
+     * Type of the data point
+     */
+    datapoint_type: 'text' | 'number' | 'date' | 'boolean' | 'list' | 'url';
+  }
 
-          fontWeight?: number;
+  /**
+   * Optional object specifying which pages to analyze
+   */
+  export interface SpecificPages {
+    /**
+     * Whether to analyze the about us page
+     */
+    about_us?: boolean;
 
-          letterSpacing?: string;
+    /**
+     * Whether to analyze the blog
+     */
+    blog?: boolean;
 
-          lineHeight?: string;
-        }
+    /**
+     * Whether to analyze the careers page
+     */
+    careers?: boolean;
 
-        export interface H3 {
-          fontFamily?: string;
+    /**
+     * Whether to analyze the contact us page
+     */
+    contact_us?: boolean;
 
-          fontSize?: string;
+    /**
+     * Whether to analyze the FAQ page
+     */
+    faq?: boolean;
 
-          fontWeight?: number;
+    /**
+     * Whether to analyze the home page
+     */
+    home_page?: boolean;
 
-          letterSpacing?: string;
+    /**
+     * Whether to analyze the privacy policy page
+     */
+    privacy_policy?: boolean;
 
-          lineHeight?: string;
-        }
+    /**
+     * Whether to analyze the terms and conditions page
+     */
+    terms_and_conditions?: boolean;
+  }
+}
 
-        export interface H4 {
-          fontFamily?: string;
+export interface BrandIdentifyFromTransactionParams {
+  /**
+   * Transaction information to identify the brand
+   */
+  transaction_info: string;
 
-          fontSize?: string;
+  /**
+   * Optional parameter to force the language of the retrieved brand data.
+   */
+  force_language?:
+    | 'albanian'
+    | 'arabic'
+    | 'azeri'
+    | 'bengali'
+    | 'bulgarian'
+    | 'cebuano'
+    | 'croatian'
+    | 'czech'
+    | 'danish'
+    | 'dutch'
+    | 'english'
+    | 'estonian'
+    | 'farsi'
+    | 'finnish'
+    | 'french'
+    | 'german'
+    | 'hausa'
+    | 'hawaiian'
+    | 'hindi'
+    | 'hungarian'
+    | 'icelandic'
+    | 'indonesian'
+    | 'italian'
+    | 'kazakh'
+    | 'kyrgyz'
+    | 'latin'
+    | 'latvian'
+    | 'lithuanian'
+    | 'macedonian'
+    | 'mongolian'
+    | 'nepali'
+    | 'norwegian'
+    | 'pashto'
+    | 'pidgin'
+    | 'polish'
+    | 'portuguese'
+    | 'romanian'
+    | 'russian'
+    | 'serbian'
+    | 'slovak'
+    | 'slovene'
+    | 'somali'
+    | 'spanish'
+    | 'swahili'
+    | 'swedish'
+    | 'tagalog'
+    | 'turkish'
+    | 'ukrainian'
+    | 'urdu'
+    | 'uzbek'
+    | 'vietnamese'
+    | 'welsh';
 
-          fontWeight?: number;
+  /**
+   * 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.
+   */
+  maxSpeed?: boolean;
 
-          letterSpacing?: string;
+  /**
+   * 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).
+   */
+  timeoutMS?: number;
+}
 
-          lineHeight?: string;
-        }
-      }
+export interface BrandPrefetchParams {
+  /**
+   * Domain name to prefetch brand data for
+   */
+  domain: string;
 
-      /**
-       * Paragraph text styles
-       */
-      export interface P {
-        fontFamily?: string;
+  /**
+   * 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).
+   */
+  timeoutMS?: number;
+}
 
-        fontSize?: string;
+export interface BrandRetrieveByEmailParams {
+  /**
+   * Email address to retrieve brand data for (e.g., 'contact@example.com'). The
+   * domain will be extracted from the email. Free email providers (gmail.com,
+   * yahoo.com, etc.) and disposable email addresses are not allowed.
+   */
+  email: string;
 
-        fontWeight?: number;
+  /**
+   * Optional parameter to force the language of the retrieved brand data.
+   */
+  force_language?:
+    | 'albanian'
+    | 'arabic'
+    | 'azeri'
+    | 'bengali'
+    | 'bulgarian'
+    | 'cebuano'
+    | 'croatian'
+    | 'czech'
+    | 'danish'
+    | 'dutch'
+    | 'english'
+    | 'estonian'
+    | 'farsi'
+    | 'finnish'
+    | 'french'
+    | 'german'
+    | 'hausa'
+    | 'hawaiian'
+    | 'hindi'
+    | 'hungarian'
+    | 'icelandic'
+    | 'indonesian'
+    | 'italian'
+    | 'kazakh'
+    | 'kyrgyz'
+    | 'latin'
+    | 'latvian'
+    | 'lithuanian'
+    | 'macedonian'
+    | 'mongolian'
+    | 'nepali'
+    | 'norwegian'
+    | 'pashto'
+    | 'pidgin'
+    | 'polish'
+    | 'portuguese'
+    | 'romanian'
+    | 'russian'
+    | 'serbian'
+    | 'slovak'
+    | 'slovene'
+    | 'somali'
+    | 'spanish'
+    | 'swahili'
+    | 'swedish'
+    | 'tagalog'
+    | 'turkish'
+    | 'ukrainian'
+    | 'urdu'
+    | 'uzbek'
+    | 'vietnamese'
+    | 'welsh';
 
-        letterSpacing?: string;
+  /**
+   * 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.
+   */
+  maxSpeed?: boolean;
 
-        lineHeight?: string;
-      }
-    }
-  }
+  /**
+   * 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).
+   */
+  timeoutMS?: number;
 }
 
-export interface BrandRetrieveParams {
+export interface BrandRetrieveByNameParams {
   /**
-   * Domain name to retrieve brand data for (e.g., 'example.com', 'google.com').
-   * Cannot be used with name or ticker parameters.
+   * Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft
+   * Corporation'). Must be 3-30 characters.
    */
-  domain?: string;
+  name: string;
 
   /**
-   * 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.
    */
   force_language?:
     | 'albanian'
@@ -2024,27 +4200,91 @@ export interface BrandRetrieveParams {
   /**
    * 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. Works with all three lookup methods.
+   * less comprehensive data.
    */
   maxSpeed?: boolean;
 
   /**
-   * Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft
-   * Corporation'). Must be 3-30 characters. Cannot be used with domain or ticker
-   * parameters.
+   * 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).
    */
-  name?: string;
+  timeoutMS?: number;
+}
 
+export interface BrandRetrieveByTickerParams {
   /**
    * Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A').
-   * Must be 1-15 characters, letters/numbers/dots only. Cannot be used with domain
-   * or name parameters.
+   * Must be 1-15 characters, letters/numbers/dots only.
+   */
+  ticker: string;
+
+  /**
+   * Optional parameter to force the language of the retrieved brand data.
+   */
+  force_language?:
+    | 'albanian'
+    | 'arabic'
+    | 'azeri'
+    | 'bengali'
+    | 'bulgarian'
+    | 'cebuano'
+    | 'croatian'
+    | 'czech'
+    | 'danish'
+    | 'dutch'
+    | 'english'
+    | 'estonian'
+    | 'farsi'
+    | 'finnish'
+    | 'french'
+    | 'german'
+    | 'hausa'
+    | 'hawaiian'
+    | 'hindi'
+    | 'hungarian'
+    | 'icelandic'
+    | 'indonesian'
+    | 'italian'
+    | 'kazakh'
+    | 'kyrgyz'
+    | 'latin'
+    | 'latvian'
+    | 'lithuanian'
+    | 'macedonian'
+    | 'mongolian'
+    | 'nepali'
+    | 'norwegian'
+    | 'pashto'
+    | 'pidgin'
+    | 'polish'
+    | 'portuguese'
+    | 'romanian'
+    | 'russian'
+    | 'serbian'
+    | 'slovak'
+    | 'slovene'
+    | 'somali'
+    | 'spanish'
+    | 'swahili'
+    | 'swedish'
+    | 'tagalog'
+    | 'turkish'
+    | 'ukrainian'
+    | 'urdu'
+    | 'uzbek'
+    | 'vietnamese'
+    | 'welsh';
+
+  /**
+   * 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.
    */
-  ticker?: string;
+  maxSpeed?: boolean;
 
   /**
-   * Optional stock exchange for the ticker. Only used when ticker parameter is
-   * provided. Defaults to assume ticker is American if not specified.
+   * Optional stock exchange for the ticker. Defaults to NASDAQ if not specified.
    */
   ticker_exchange?:
     | 'AMEX'
@@ -2128,127 +4368,6 @@ export interface BrandRetrieveParams {
   timeoutMS?: number;
 }
 
-export interface BrandAIQueryParams {
-  /**
-   * Array of data points to extract from the website
-   */
-  data_to_extract: Array<BrandAIQueryParams.DataToExtract>;
-
-  /**
-   * The domain name to analyze
-   */
-  domain: string;
-
-  /**
-   * Optional object specifying which pages to analyze
-   */
-  specific_pages?: BrandAIQueryParams.SpecificPages;
-
-  /**
-   * 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).
-   */
-  timeoutMS?: number;
-}
-
-export namespace BrandAIQueryParams {
-  export interface DataToExtract {
-    /**
-     * Description of what to extract
-     */
-    datapoint_description: string;
-
-    /**
-     * Example of the expected value
-     */
-    datapoint_example: string;
-
-    /**
-     * Name of the data point to extract
-     */
-    datapoint_name: string;
-
-    /**
-     * Type of the data point
-     */
-    datapoint_type: 'text' | 'number' | 'date' | 'boolean' | 'list' | 'url';
-  }
-
-  /**
-   * Optional object specifying which pages to analyze
-   */
-  export interface SpecificPages {
-    /**
-     * Whether to analyze the about us page
-     */
-    about_us?: boolean;
-
-    /**
-     * Whether to analyze the blog
-     */
-    blog?: boolean;
-
-    /**
-     * Whether to analyze the careers page
-     */
-    careers?: boolean;
-
-    /**
-     * Whether to analyze the contact us page
-     */
-    contact_us?: boolean;
-
-    /**
-     * Whether to analyze the FAQ page
-     */
-    faq?: boolean;
-
-    /**
-     * Whether to analyze the home page
-     */
-    home_page?: boolean;
-
-    /**
-     * Whether to analyze the privacy policy page
-     */
-    privacy_policy?: boolean;
-
-    /**
-     * Whether to analyze the terms and conditions page
-     */
-    terms_and_conditions?: boolean;
-  }
-}
-
-export interface BrandIdentifyFromTransactionParams {
-  /**
-   * Transaction information to identify the brand
-   */
-  transaction_info: string;
-
-  /**
-   * 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).
-   */
-  timeoutMS?: number;
-}
-
-export interface BrandPrefetchParams {
-  /**
-   * Domain name to prefetch brand data for
-   */
-  domain: string;
-
-  /**
-   * 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).
-   */
-  timeoutMS?: number;
-}
-
 export interface BrandRetrieveNaicsParams {
   /**
    * Brand domain or title to retrieve NAICS code for. If a valid domain is provided
@@ -2338,6 +4457,9 @@ export declare namespace Brand {
     type BrandAIQueryResponse as BrandAIQueryResponse,
     type BrandIdentifyFromTransactionResponse as BrandIdentifyFromTransactionResponse,
     type BrandPrefetchResponse as BrandPrefetchResponse,
+    type BrandRetrieveByEmailResponse as BrandRetrieveByEmailResponse,
+    type BrandRetrieveByNameResponse as BrandRetrieveByNameResponse,
+    type BrandRetrieveByTickerResponse as BrandRetrieveByTickerResponse,
     type BrandRetrieveNaicsResponse as BrandRetrieveNaicsResponse,
     type BrandRetrieveSimplifiedResponse as BrandRetrieveSimplifiedResponse,
     type BrandScreenshotResponse as BrandScreenshotResponse,
@@ -2346,6 +4468,9 @@ export declare namespace Brand {
     type BrandAIQueryParams as BrandAIQueryParams,
     type BrandIdentifyFromTransactionParams as BrandIdentifyFromTransactionParams,
     type BrandPrefetchParams as BrandPrefetchParams,
+    type BrandRetrieveByEmailParams as BrandRetrieveByEmailParams,
+    type BrandRetrieveByNameParams as BrandRetrieveByNameParams,
+    type BrandRetrieveByTickerParams as BrandRetrieveByTickerParams,
     type BrandRetrieveNaicsParams as BrandRetrieveNaicsParams,
     type BrandRetrieveSimplifiedParams as BrandRetrieveSimplifiedParams,
     type BrandScreenshotParams as BrandScreenshotParams,