brand.dev 0.9.1 → 0.11.0

package/resources/brand.d.mts

@@ -3,8 +3,8 @@ import { APIPromise } from "../core/api-promise.mjs";
 import { RequestOptions } from "../internal/request-options.mjs";
 export declare 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, options?: RequestOptions): APIPromise<BrandRetrieveResponse>;
     /**
@@ -25,6 +25,23 @@ export declare class Brand extends APIResource {
      * endpoint]
      */
     prefetch(body: BrandPrefetchParams, options?: RequestOptions): APIPromise<BrandPrefetchResponse>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
     /**
      * Endpoint to classify any brand into a 2022 NAICS code.
      */
@@ -49,11 +66,946 @@ export declare class Brand extends APIResource {
      */
     styleguide(query: BrandStyleguideParams, options?: RequestOptions): APIPromise<BrandStyleguideResponse>;
 }
-export interface BrandRetrieveResponse {
+export interface BrandRetrieveResponse {
+    /**
+     * Detailed brand information
+     */
+    brand?: BrandRetrieveResponse.Brand;
+    /**
+     * HTTP status code
+     */
+    code?: number;
+    /**
+     * Status of the response, e.g., 'ok'
+     */
+    status?: string;
+}
+export declare namespace BrandRetrieveResponse {
+    /**
+     * Detailed brand information
+     */
+    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;
+    }
+    namespace Brand {
+        /**
+         * Physical address of the brand
+         */
+        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;
+        }
+        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;
+        }
+        namespace Backdrop {
+            interface Color {
+                /**
+                 * Color in hexadecimal format
+                 */
+                hex?: string;
+                /**
+                 * Name of the color
+                 */
+                name?: string;
+            }
+            /**
+             * Resolution of the backdrop image
+             */
+            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;
+            }
+        }
+        interface Color {
+            /**
+             * Color in hexadecimal format
+             */
+            hex?: string;
+            /**
+             * Name of the color
+             */
+            name?: string;
+        }
+        /**
+         * Industry classification information for the brand
+         */
+        interface Industries {
+            /**
+             * Easy Industry Classification - array of industry and subindustry pairs
+             */
+            eic?: Array<Industries.Eic>;
+        }
+        namespace Industries {
+            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
+         */
+        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;
+        }
+        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;
+        }
+        namespace Logo {
+            interface Color {
+                /**
+                 * Color in hexadecimal format
+                 */
+                hex?: string;
+                /**
+                 * Name of the color
+                 */
+                name?: string;
+            }
+            /**
+             * Resolution of the logo image
+             */
+            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;
+            }
+        }
+        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)
+         */
+        interface Stock {
+            /**
+             * Stock exchange name
+             */
+            exchange?: string;
+            /**
+             * Stock ticker symbol
+             */
+            ticker?: string;
+        }
+    }
+}
+export interface BrandAIQueryResponse {
+    /**
+     * Array of extracted data points
+     */
+    data_extracted?: Array<BrandAIQueryResponse.DataExtracted>;
+    /**
+     * The domain that was analyzed
+     */
+    domain?: string;
+    /**
+     * Status of the response, e.g., 'ok'
+     */
+    status?: string;
+    /**
+     * List of URLs that were analyzed
+     */
+    urls_analyzed?: Array<string>;
+}
+export declare namespace BrandAIQueryResponse {
+    interface DataExtracted {
+        /**
+         * Name of the extracted data point
+         */
+        datapoint_name?: string;
+        /**
+         * Value of the extracted data point
+         */
+        datapoint_value?: string | number | boolean | Array<string> | Array<number>;
+    }
+}
+export interface BrandIdentifyFromTransactionResponse {
+    /**
+     * Detailed brand information
+     */
+    brand?: BrandIdentifyFromTransactionResponse.Brand;
+    /**
+     * HTTP status code
+     */
+    code?: number;
+    /**
+     * Status of the response, e.g., 'ok'
+     */
+    status?: string;
+}
+export declare namespace BrandIdentifyFromTransactionResponse {
+    /**
+     * Detailed brand information
+     */
+    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;
+    }
+    namespace Brand {
+        /**
+         * Physical address of the brand
+         */
+        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;
+        }
+        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;
+        }
+        namespace Backdrop {
+            interface Color {
+                /**
+                 * Color in hexadecimal format
+                 */
+                hex?: string;
+                /**
+                 * Name of the color
+                 */
+                name?: string;
+            }
+            /**
+             * Resolution of the backdrop image
+             */
+            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;
+            }
+        }
+        interface Color {
+            /**
+             * Color in hexadecimal format
+             */
+            hex?: string;
+            /**
+             * Name of the color
+             */
+            name?: string;
+        }
+        /**
+         * Industry classification information for the brand
+         */
+        interface Industries {
+            /**
+             * Easy Industry Classification - array of industry and subindustry pairs
+             */
+            eic?: Array<Industries.Eic>;
+        }
+        namespace Industries {
+            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
+         */
+        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;
+        }
+        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;
+        }
+        namespace Logo {
+            interface Color {
+                /**
+                 * Color in hexadecimal format
+                 */
+                hex?: string;
+                /**
+                 * Name of the color
+                 */
+                name?: string;
+            }
+            /**
+             * Resolution of the logo image
+             */
+            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;
+            }
+        }
+        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)
+         */
+        interface Stock {
+            /**
+             * Stock exchange name
+             */
+            exchange?: string;
+            /**
+             * Stock ticker symbol
+             */
+            ticker?: string;
+        }
+    }
+}
+export interface BrandPrefetchResponse {
+    /**
+     * The domain that was queued for prefetching
+     */
+    domain?: string;
+    /**
+     * Success message
+     */
+    message?: string;
+    /**
+     * Status of the response, e.g., 'ok'
+     */
+    status?: string;
+}
+export interface BrandRetrieveByEmailResponse {
+    /**
+     * Detailed brand information
+     */
+    brand?: BrandRetrieveByEmailResponse.Brand;
+    /**
+     * HTTP status code
+     */
+    code?: number;
+    /**
+     * Status of the response, e.g., 'ok'
+     */
+    status?: string;
+}
+export declare namespace BrandRetrieveByEmailResponse {
+    /**
+     * Detailed brand information
+     */
+    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;
+    }
+    namespace Brand {
+        /**
+         * Physical address of the brand
+         */
+        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;
+        }
+        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;
+        }
+        namespace Backdrop {
+            interface Color {
+                /**
+                 * Color in hexadecimal format
+                 */
+                hex?: string;
+                /**
+                 * Name of the color
+                 */
+                name?: string;
+            }
+            /**
+             * Resolution of the backdrop image
+             */
+            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;
+            }
+        }
+        interface Color {
+            /**
+             * Color in hexadecimal format
+             */
+            hex?: string;
+            /**
+             * Name of the color
+             */
+            name?: string;
+        }
+        /**
+         * Industry classification information for the brand
+         */
+        interface Industries {
+            /**
+             * Easy Industry Classification - array of industry and subindustry pairs
+             */
+            eic?: Array<Industries.Eic>;
+        }
+        namespace Industries {
+            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
+         */
+        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;
+        }
+        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;
+        }
+        namespace Logo {
+            interface Color {
+                /**
+                 * Color in hexadecimal format
+                 */
+                hex?: string;
+                /**
+                 * Name of the color
+                 */
+                name?: string;
+            }
+            /**
+             * Resolution of the logo image
+             */
+            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;
+            }
+        }
+        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)
+         */
+        interface Stock {
+            /**
+             * Stock exchange name
+             */
+            exchange?: string;
+            /**
+             * Stock ticker symbol
+             */
+            ticker?: string;
+        }
+    }
+}
+export interface BrandRetrieveByNameResponse {
     /**
      * Detailed brand information
      */
-    brand?: BrandRetrieveResponse.Brand;
+    brand?: BrandRetrieveByNameResponse.Brand;
     /**
      * HTTP status code
      */
@@ -63,7 +1015,7 @@ export interface BrandRetrieveResponse {
      */
     status?: string;
 }
-export declare namespace BrandRetrieveResponse {
+export declare namespace BrandRetrieveByNameResponse {
     /**
      * Detailed brand information
      */
@@ -346,41 +1298,11 @@ export declare namespace BrandRetrieveResponse {
         }
     }
 }
-export interface BrandAIQueryResponse {
-    /**
-     * Array of extracted data points
-     */
-    data_extracted?: Array<BrandAIQueryResponse.DataExtracted>;
-    /**
-     * The domain that was analyzed
-     */
-    domain?: string;
-    /**
-     * Status of the response, e.g., 'ok'
-     */
-    status?: string;
-    /**
-     * List of URLs that were analyzed
-     */
-    urls_analyzed?: Array<string>;
-}
-export declare namespace BrandAIQueryResponse {
-    interface DataExtracted {
-        /**
-         * Name of the extracted data point
-         */
-        datapoint_name?: string;
-        /**
-         * Value of the extracted data point
-         */
-        datapoint_value?: string | number | boolean | Array<string> | Array<number>;
-    }
-}
-export interface BrandIdentifyFromTransactionResponse {
+export interface BrandRetrieveByTickerResponse {
     /**
      * Detailed brand information
      */
-    brand?: BrandIdentifyFromTransactionResponse.Brand;
+    brand?: BrandRetrieveByTickerResponse.Brand;
     /**
      * HTTP status code
      */
@@ -390,7 +1312,7 @@ export interface BrandIdentifyFromTransactionResponse {
      */
     status?: string;
 }
-export declare namespace BrandIdentifyFromTransactionResponse {
+export declare namespace BrandRetrieveByTickerResponse {
     /**
      * Detailed brand information
      */
@@ -673,20 +1595,6 @@ export declare namespace BrandIdentifyFromTransactionResponse {
         }
     }
 }
-export interface BrandPrefetchResponse {
-    /**
-     * The domain that was queued for prefetching
-     */
-    domain?: string;
-    /**
-     * Success message
-     */
-    message?: string;
-    /**
-     * Status of the response, e.g., 'ok'
-     */
-    status?: string;
-}
 export interface BrandRetrieveNaicsResponse {
     /**
      * Array of NAICS codes and titles.
@@ -1182,23 +2090,6 @@ export interface BrandRetrieveParams {
      * less comprehensive data. Works with all three lookup methods.
      */
     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.
-     */
-    name?: string;
-    /**
-     * 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.
-     */
-    ticker?: string;
-    /**
-     * Optional stock exchange for the ticker. Only used when ticker parameter is
-     * provided. Defaults to assume ticker is American if not specified.
-     */
-    ticker_exchange?: 'AMEX' | 'AMS' | 'AQS' | 'ASX' | 'ATH' | 'BER' | 'BME' | 'BRU' | 'BSE' | 'BUD' | 'BUE' | 'BVC' | 'CBOE' | 'CNQ' | 'CPH' | 'DFM' | 'DOH' | 'DUB' | 'DUS' | 'DXE' | 'EGX' | 'FSX' | 'HAM' | 'HEL' | 'HKSE' | 'HOSE' | 'ICE' | 'IOB' | 'IST' | 'JKT' | 'JNB' | 'JPX' | 'KLS' | 'KOE' | 'KSC' | 'KUW' | 'LIS' | 'LSE' | 'MCX' | 'MEX' | 'MIL' | 'MUN' | 'NASDAQ' | 'NEO' | 'NSE' | 'NYSE' | 'NZE' | 'OSL' | 'OTC' | 'PAR' | 'PNK' | 'PRA' | 'RIS' | 'SAO' | 'SAU' | 'SES' | 'SET' | 'SGO' | 'SHH' | 'SHZ' | 'SIX' | 'STO' | 'STU' | 'TAI' | 'TAL' | 'TLV' | 'TSX' | 'TSXV' | 'TWO' | 'VIE' | 'WSE' | 'XETRA';
     /**
      * 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
@@ -1288,6 +2179,16 @@ export interface BrandIdentifyFromTransactionParams {
      * Transaction information to identify the brand
      */
     transaction_info: 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.
+     */
+    maxSpeed?: boolean;
     /**
      * 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
@@ -1307,6 +2208,80 @@ export interface BrandPrefetchParams {
      */
     timeoutMS?: number;
 }
+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;
+    /**
+     * 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.
+     */
+    maxSpeed?: boolean;
+    /**
+     * 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 BrandRetrieveByNameParams {
+    /**
+     * Company name to retrieve brand data for (e.g., 'Apple Inc', 'Microsoft
+     * Corporation'). Must be 3-30 characters.
+     */
+    name: 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.
+     */
+    maxSpeed?: boolean;
+    /**
+     * 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 BrandRetrieveByTickerParams {
+    /**
+     * Stock ticker symbol to retrieve brand data for (e.g., 'AAPL', 'GOOGL', 'BRK.A').
+     * 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.
+     */
+    maxSpeed?: boolean;
+    /**
+     * Optional stock exchange for the ticker. Defaults to NASDAQ if not specified.
+     */
+    ticker_exchange?: 'AMEX' | 'AMS' | 'AQS' | 'ASX' | 'ATH' | 'BER' | 'BME' | 'BRU' | 'BSE' | 'BUD' | 'BUE' | 'BVC' | 'CBOE' | 'CNQ' | 'CPH' | 'DFM' | 'DOH' | 'DUB' | 'DUS' | 'DXE' | 'EGX' | 'FSX' | 'HAM' | 'HEL' | 'HKSE' | 'HOSE' | 'ICE' | 'IOB' | 'IST' | 'JKT' | 'JNB' | 'JPX' | 'KLS' | 'KOE' | 'KSC' | 'KUW' | 'LIS' | 'LSE' | 'MCX' | 'MEX' | 'MIL' | 'MUN' | 'NASDAQ' | 'NEO' | 'NSE' | 'NYSE' | 'NZE' | 'OSL' | 'OTC' | 'PAR' | 'PNK' | 'PRA' | 'RIS' | 'SAO' | 'SAU' | 'SES' | 'SET' | 'SGO' | 'SHH' | 'SHZ' | 'SIX' | 'STO' | 'STU' | 'TAI' | 'TAL' | 'TLV' | 'TSX' | 'TSXV' | 'TWO' | 'VIE' | 'WSE' | 'XETRA';
+    /**
+     * 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
@@ -1380,6 +2355,6 @@ export interface BrandStyleguideParams {
     timeoutMS?: number;
 }
 export declare namespace Brand {
-    export { type BrandRetrieveResponse as BrandRetrieveResponse, type BrandAIQueryResponse as BrandAIQueryResponse, type BrandIdentifyFromTransactionResponse as BrandIdentifyFromTransactionResponse, type BrandPrefetchResponse as BrandPrefetchResponse, type BrandRetrieveNaicsResponse as BrandRetrieveNaicsResponse, type BrandRetrieveSimplifiedResponse as BrandRetrieveSimplifiedResponse, type BrandScreenshotResponse as BrandScreenshotResponse, type BrandStyleguideResponse as BrandStyleguideResponse, type BrandRetrieveParams as BrandRetrieveParams, type BrandAIQueryParams as BrandAIQueryParams, type BrandIdentifyFromTransactionParams as BrandIdentifyFromTransactionParams, type BrandPrefetchParams as BrandPrefetchParams, type BrandRetrieveNaicsParams as BrandRetrieveNaicsParams, type BrandRetrieveSimplifiedParams as BrandRetrieveSimplifiedParams, type BrandScreenshotParams as BrandScreenshotParams, type BrandStyleguideParams as BrandStyleguideParams, };
+    export { type BrandRetrieveResponse as BrandRetrieveResponse, 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, type BrandStyleguideResponse as BrandStyleguideResponse, type BrandRetrieveParams as BrandRetrieveParams, 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, type BrandStyleguideParams as BrandStyleguideParams, };
 }
 //# sourceMappingURL=brand.d.mts.map