> ## Documentation Index > Fetch the complete documentation index at: https://docs.context.dev/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve brand data by domain > Retrieve logos, backdrops, colors, industry, description, and more from any domain 10 Credits ## OpenAPI ````yaml https://app.stainless.com/api/spec/documented/context.dev/openapi.documented.yml get /brand/retrieve openapi: 3.0.0 info: title: Context API description: API for retrieving context data from any website version: 1.0.0 servers: - url: https://api.context.dev/v1 security: [] paths: /brand/retrieve: get: tags: - Brand Intelligence summary: Retrieve brand data by domain description: >- Retrieve logos, backdrops, colors, industry, description, and more from any domain parameters: - name: domain in: query required: true schema: type: string description: >- Domain name to retrieve brand data for (e.g., 'example.com', 'google.com'). Cannot be used with name or ticker parameters. - $ref: '#/components/parameters/ForceLanguage' - name: maxSpeed in: query required: false schema: type: boolean description: >- 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. - $ref: '#/components/parameters/BrandRetrieveMaxAgeMs' - $ref: '#/components/parameters/TimeoutMS' responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/BrandResponse' '400': description: Bad Request content: application/json: schema: type: object properties: message: type: string description: Error message error_code: type: string enum: - INTERNAL_ERROR - VALID - NOT_FOUND - FORBIDDEN - USAGE_EXCEEDED - RATE_LIMITED - UNAUTHORIZED - DISABLED - INSUFFICIENT_PERMISSIONS - TIMEOUT_EXCEEDS_MAXIMUM - WEBSITE_ACCESS_ERROR - INPUT_VALIDATION_ERROR description: Error code indicating the type of error '401': description: Unauthorized content: application/json: schema: type: object properties: error_code: type: string enum: - INTERNAL_ERROR - VALID - NOT_FOUND - FORBIDDEN - USAGE_EXCEEDED - RATE_LIMITED - UNAUTHORIZED - DISABLED - INSUFFICIENT_PERMISSIONS - TIMEOUT_EXCEEDS_MAXIMUM - WEBSITE_ACCESS_ERROR - INPUT_VALIDATION_ERROR description: Error code indicating the type of error '408': description: Request Timeout content: application/json: schema: type: object properties: message: type: string description: Timeout error message error_code: type: string enum: - REQUEST_TIMEOUT description: Error code indicating request timeout security: - bearerAuth: [] x-codeSamples: - lang: JavaScript source: |- import ContextDev from 'context.dev'; const client = new ContextDev({ apiKey: process.env['CONTEXT_DEV_API_KEY'], // This is the default and can be omitted }); const brand = await client.brand.retrieve({ domain: 'domain' }); console.log(brand.brand); - lang: Python source: |- import os from context.dev import ContextDev client = ContextDev( api_key=os.environ.get("CONTEXT_DEV_API_KEY"), # This is the default and can be omitted ) brand = client.brand.retrieve( domain="domain", ) print(brand.brand) - lang: Ruby source: |- require "context_dev" context_dev = ContextDev::Client.new(api_key: "My API Key") brand = context_dev.brand.retrieve(domain: "domain") puts(brand) components: parameters: ForceLanguage: name: force_language in: query required: false schema: $ref: '#/components/schemas/SupportedLanguage' description: Optional parameter to force the language of the retrieved brand data. BrandRetrieveMaxAgeMs: name: maxAgeMs in: query required: false schema: type: integer minimum: 86400000 maximum: 31536000000 default: 7776000000 description: >- Maximum age in milliseconds for cached brand data before the API performs a hard refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms) are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1 year. TimeoutMS: name: timeoutMS in: query required: false schema: $ref: '#/components/schemas/TimeoutMS' description: >- 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). schemas: BrandResponse: type: object properties: status: type: string description: Status of the response, e.g., 'ok' brand: type: object description: Detailed brand information properties: domain: type: string description: The domain name of the brand title: type: string description: The title or name of the brand description: type: string description: A brief description of the brand slogan: type: string description: The brand's slogan colors: type: array description: An array of brand colors items: type: object properties: hex: type: string description: Color in hexadecimal format name: type: string description: Name of the color logos: type: array description: An array of logos associated with the brand items: type: object properties: url: type: string description: CDN hosted url of the logo (ready for display) mode: type: string enum: - light - dark - has_opaque_background description: >- 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 colors: type: array description: Array of colors in the logo items: type: object properties: hex: type: string description: Color in hexadecimal format name: type: string description: Name of the color resolution: type: object description: Resolution of the logo image properties: width: type: integer description: Width of the image in pixels height: type: integer description: Height of the image in pixels aspect_ratio: type: number description: Aspect ratio of the image (width/height) type: type: string enum: - icon - logo description: >- Type of the logo based on resolution (e.g., 'icon', 'logo') backdrops: type: array description: An array of backdrop images for the brand items: type: object properties: url: type: string description: URL of the backdrop image colors: type: array description: Array of colors in the backdrop image items: type: object properties: hex: type: string description: Color in hexadecimal format name: type: string description: Name of the color resolution: type: object description: Resolution of the backdrop image properties: width: type: integer description: Width of the image in pixels height: type: integer description: Height of the image in pixels aspect_ratio: type: number description: Aspect ratio of the image (width/height) socials: type: array description: An array of social media links for the brand items: type: object properties: type: type: string description: Type of social media platform enum: - x - facebook - instagram - linkedin - youtube - pinterest - tiktok - dribbble - github - behance - snapchat - whatsapp - telegram - line - discord - twitch - vimeo - imdb - tumblr - flickr - giphy - medium - spotify - soundcloud - tripadvisor - yelp - producthunt - reddit - crunchbase - appstore - playstore url: type: string description: URL of the social media page address: type: object description: Physical address of the brand properties: street: type: string description: Street address city: type: string description: City name country: type: string description: Country name country_code: type: string description: Country code state_province: type: string description: State or province name state_code: type: string description: State or province code postal_code: type: string description: Postal or ZIP code stock: type: object description: >- Stock market information for this brand (will be null if not a publicly traded company) properties: ticker: type: string description: Stock ticker symbol exchange: type: string description: Stock exchange name is_nsfw: type: boolean description: Indicates whether the brand content is not safe for work (NSFW) email: type: string description: Company email address phone: type: string description: Company phone number industries: type: object description: Industry classification information for the brand properties: eic: type: array description: >- Easy Industry Classification - array of industry and subindustry pairs items: type: object properties: industry: $ref: '#/components/schemas/Industry' subindustry: $ref: '#/components/schemas/Subindustry' required: - industry - subindustry links: type: object description: Important website links for the brand properties: careers: type: string nullable: true description: URL to the brand's careers or job opportunities page privacy: type: string nullable: true description: URL to the brand's privacy policy page terms: type: string nullable: true description: >- URL to the brand's terms of service or terms and conditions page contact: type: string nullable: true description: URL to the brand's contact or contact us page blog: type: string nullable: true description: URL to the brand's blog or news page pricing: type: string nullable: true description: URL to the brand's pricing or plans page primary_language: allOf: - $ref: '#/components/schemas/SupportedLanguage' nullable: true description: >- The primary language of the brand's website content. Detected from the HTML lang tag, page content analysis, or social media descriptions. code: type: integer description: HTTP status code SupportedLanguage: type: string enum: - afrikaans - albanian - amharic - arabic - armenian - assamese - aymara - azeri - basque - belarusian - bengali - bosnian - bulgarian - burmese - cantonese - catalan - cebuano - chinese - corsican - croatian - czech - danish - dutch - english - esperanto - estonian - farsi - fijian - finnish - french - galician - georgian - german - greek - guarani - gujarati - haitian-creole - hausa - hawaiian - hebrew - hindi - hmong - hungarian - icelandic - igbo - indonesian - irish - italian - japanese - javanese - kannada - kazakh - khmer - kinyarwanda - korean - kurdish - kyrgyz - lao - latin - latvian - lingala - lithuanian - luxembourgish - macedonian - malagasy - malay - malayalam - maltese - maori - marathi - mongolian - nepali - norwegian - odia - oromo - pashto - pidgin - polish - portuguese - punjabi - quechua - romanian - russian - samoan - scottish-gaelic - serbian - sesotho - shona - sindhi - sinhala - slovak - slovene - somali - spanish - sundanese - swahili - swedish - tagalog - tajik - tamil - tatar - telugu - thai - tibetan - tigrinya - tongan - tswana - turkish - turkmen - ukrainian - urdu - uyghur - uzbek - vietnamese - welsh - wolof - xhosa - yiddish - yoruba - zulu TimeoutMS: type: integer minimum: 1000 maximum: 300000 description: >- 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). Industry: type: string enum: - 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) description: Industry classification enum Subindustry: type: string enum: - 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 description: Subindustry classification enum securitySchemes: bearerAuth: type: http scheme: bearer ````