Backed by
Combinator
CombinatorBrand Colors {API}
Discover a brand color palette from any domain.
Get discovered colors as HEX with optional names and a site-or-logo source. Convert color spaces and assign semantic roles in your client.
Get API AccessNo card required
View DocumentationWhat You Get
Each API call returns structured color data ready for production use.
HEX colors
Compact values ready for client-side conversion
Observed source
Distinguish colors found on the site from logo pixels
Discovered palette
An array of colors observed for the brand
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
HEX, optional name, and site-or-logo source
API Response
Extracted brand data for linear.app
POST /v1/brand/retrieve { "type": "by_domain", "domain": "linear.app" }{
"status": "ok",
"brand": {
"domain": "linear.app",
"colors": [
{
"hex": "#839bfc",
"name": "Periwinkle Blue",
"source": "site"
},
{
"hex": "#040404",
"name": "Armor Wash",
"source": "site"
},
{
"hex": "#848484",
"name": "Dover Grey",
"source": "logo"
}
]
},
"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?
Colors can be observed from the website theme and from logo pixels. The source field is site or logo. Array position should not be treated as a documented semantic role or usage percentage.
How accurate is the brand color extraction?
Brand Retrieve may reuse cached data up to maxAgeMs. Its default maximum age is about 90 days and the accepted range is one day to one year. Inspect source and apply your own role-selection policy for your UI.
Is there a free brand color API tier?
Yes. Work-email signups get 1,000 free API credits every month at 30 req/min, enough for 100 full brand-color lookups. Paid plans unlock production volume on the same key.
How do I get a brand color palette from a domain?
POST the target domain and type by_domain to /v1/brand/retrieve. brand.colors is an optional array whose items can include hex, name, and source. The API does not return RGB/HSL values, semantic roles, or usage weights.
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?
Brand Retrieve combines discovered brand signals and reports whether a color came from the site or a logo. It does not return semantic color roles or usage-frequency weights; derive those client-side if your workflow needs them.
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.
How do I get a brand color palette from a domain?
POST the target domain and type by_domain to /v1/brand/retrieve. brand.colors is an optional array whose items can include hex, name, and source. The API does not return RGB/HSL values, semantic roles, or usage weights.
Where do the colors come from?
Colors can be observed from the website theme and from logo pixels. The source field is site or logo. Array position should not be treated as a documented semantic role or usage percentage.
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.
How accurate is the brand color extraction?
Brand Retrieve may reuse cached data up to maxAgeMs. Its default maximum age is about 90 days and the accepted range is one day to one year. Inspect source and apply your own role-selection policy for your UI.
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.
Is there a free brand color API tier?
Yes. Work-email signups get 1,000 free API credits every month at 30 req/min, enough for 100 full brand-color lookups. Paid plans unlock production volume on the same key.
How is this different from a generic color picker or image color extractor?
Brand Retrieve combines discovered brand signals and reports whether a color came from the site or a logo. It does not return semantic color roles or usage-frequency weights; derive those client-side if your workflow needs them.
Ship an agent that actually knows things.
Free tier, 10-minute integration, and the same API powering agents at Mintlify, daily.dev, and Propane. No credit card to start.