Brand Colors API - Extract a Color Palette from Any Domain

What You Get

Each API call returns structured color data ready for production use.

Multiple formats

HEX values with RGB and HSL support

Color roles

Primary, secondary, background, and text colors identified

Usage weights

Frequency and importance analysis included

Color names

Human-readable descriptive names for each color

How It Works

We extract colors from CSS, meta tags, images, and brand assets.

— step 01 —

Pass a domain

Like linear.app or any company website

— step 02 —

We crawl the site & socials

Homepage, logos, stylesheets, and visual elements analyzed

— step 03 —

Colors extracted

From CSS, meta tags, images, and brand assets

— step 04 —

Palette returned

Ranked by usage, labeled by role, named for readability

API Response

Extracted brand data for linear.app

GET /v1/brand/retrieve?domain=linear.app

Try in API Playground

{
  "status": "ok",
  "brand": {
    "domain": "linear.app",
    "colors": [
      {
        "hex": "#839bfc",
        "name": "Periwinkle Blue"
      },
      {
        "hex": "#040404",
        "name": "Armor Wash"
      },
      {
        "hex": "#848484",
        "name": "Dover Grey"
      }
    ]
  },
  "code": 200
}

Frequently asked questions

Common questions about the Brand Colors API.

Am I billed for failed requests?

No. You are not billed for failed requests or requests where we are blocked (rarely happens). Credits are only consumed on successful responses.

Where do the colors come from?

We crawl the homepage, logos, stylesheets, manifests, OpenGraph imagery, and rendered DOM. Colors are deduped, clustered, and ranked by usage frequency and visual prominence — not just CSS variable names — so you get the palette as users actually see it.

How accurate is the brand color extraction?

We re-index millions of brands quarterly with continuous rebrand monitoring. Visual ranking algorithms weight prominence (logo, hero, CTA) over noise (footer, ad slots), so the top colors in the response are reliably the brand palette — not the analytics widget.

Is there a free brand color API tier?

Yes. Sign up and you get a free tier covering thousands of monthly lookups, more than enough to prototype or run small dashboards. Paid plans unlock production volume on the same key.

How do I get a brand color palette from a domain?

Send a GET request to /v1/brand/retrieve with the target domain. The Brand Colors API returns an ordered array of HEX values, each with a human-readable name (e.g. "Periwinkle Blue"), usage weight, and inferred role (primary, secondary, background, text). HSL/RGB conversions are trivial from the HEX in your client.

Are HEX, RGB, and HSL formats supported?

The API returns HEX. Both RGB and HSL are derivable in any frontend or backend with one line of code. We standardize on HEX so the response stays compact for high-volume use and you keep full control over color-space conversions.

Can I use the Brand Colors API for white-label dashboards or marketing tools?

Yes — that's the most common use case. Pair the colors with the Logo API and Font API to render a fully branded page from just a domain. CDN-cached responses keep latency low at scale.

How is this different from a generic color picker or image color extractor?

A naive image extractor returns the average pixel color of a screenshot. Context.dev resolves the canonical brand palette by combining design tokens, logo colors, and rendered DOM, then ranks them by usage — so you get the brand colors marketing teams actually publish, not muddy averages.