1
Send one URL
One GET request with the page’s address. No browser to run, no scraper to write.
Design Extraction API
Brand API
GET /v1/brand15 credits/callTurn any URL into its brand kit
The brand colors API: extract the colors from any website as named roles and a full palette, with its fonts, every logo, the og image and social profiles in one call.
- 300 free credits a month
- Failed and repeat calls are free
- Works from ChatGPT, Claude and Cursor
Named roles
primary · accent · bg · text
Logos · fonts · socials
the whole brand
~1s
per URL
How it works
From a URL to data you can use
2
MiroMiro reads the live page
It reads the page’s HTML and CSS as a visitor’s browser would, and collects what the page really uses.
3
Get it back, ready to use
Typed JSON, for 15 credits. A repeat call within 24 hours is free.
One call
The API is the demo
One authenticated GET against any live URL. Typed JSON back.
Terminal
GET /v1/brand$
⠿ fetching stripe.com…
{
"colors": {"primary":"#635bff",
"accent":"#00d4ff","text":"#0a2540"},
"palette":[+5],
"fonts": ["Sohne"],
"logo": "https://…/logo.svg"
}
200 OK · 1.2s · 15 credits
Named roles
Primary
#635bffAccent
#00d4ffBackground
#ffffffText
#0a2540Logo & type
S
logo.svgAaSohneReal output
What it actually returns
A real response for stripe.com, captured from the live API - not a mock.
Stripe
stripe.com
Description
Stripe is a financial services platform that helps all types of businesses accept payments, build flexible billing models, and manage money movement.
Colors
Primary · Royal Blue#533afd
Accent · Sandy Brown#ffcc55
Background · White#ffffff
Text · Midnight Blue#0d1738
#ffcc55
#533afd
#1e2064
#ff6118
#9966ff
#7232f1
#d4dee9
#fb76fa
#ea2261
#1318c1
#f363f3
#6b59fe
Typography
Aaprimary
sohne-var
The quick brown fox jumps over
Aamono
SourceCodePro
The quick brown fox jumps over
Logos
apple
icon
icon
icon
og
Social profiles
@stripe x @stripe youtube @stripe linkedin @StripeHQ facebook @stripe crunchbase @stripe github @stripehq instagram
Coverage
What it captures
Found on the page
- primary / accent roles
- full palette
- brand fonts
- logos + favicon
- og image
- social profiles
- usage counts
Why this one
Returns named color roles and the logo, not just a flat list of hex codes - the opinionated brand view.
Compare alternativesParameters
What you can pass
Only url is required. Everything else narrows or reshapes the result.
urlrequired
any public URL
The page to extract from. With or without protocol (https:// is assumed).
fields
field names
Comma-separated list of fields to return (e.g. fields=logo,palette).
render
true · false (default)
Load the page in a real browser and run its JavaScript before extracting.
fresh
true · false (default)
Skip the 24-hour cache and re-extract from the live page.
screenshot
true · full · false (default)
Requires render=true. The same real browser that renders the page also captures a screenshot - true for the 1440x900 viewport, full for the entire page height.
Every parameter, the response fields and the error codes are in the reference.
Agent-ready
Your agent can call this
“Match stripe.com’s brand - pull its palette, fonts and logo and theme my app.”
Step-by-step setup for your agent
ChatGPT
Claude
Claude Code
Codex
Cursor
Grok Bot
OpenAI dots
MuseUse cases
What you can build
Auto-branded onboarding
Pull a new customer’s brand colors at signup for an instantly themed workspace.
Brand enrichment
Enrich a CRM or directory with each company’s real palette.
Theme generation
Generate a matching theme from any reference URL.
FAQ
Before you integrate
How is this different from the design tokens endpoint?
This returns the curated, opinionated brand view - named color roles, a clean palette, logos and social profiles - rather than the full raw token firehose. Start here when you want "the brand".
What does it cost?
Brand extraction is 15 credits per call - it does the most curation of any endpoint. Cached and failed calls are free.
Do I need a credit card to try it?
No. A free key includes 300 credits a month - 20 brand extractions - and the playground needs no signup at all.
Does it work on sites built with JavaScript?
Yes. The page’s HTML and CSS are read first, which is enough for most sites. When a page only builds itself with JavaScript, or refuses a plain request, it is re-read in a real browser automatically at no extra cost. Add render=true to force the browser, for example for images that load on scroll: that costs 5 extra credits, on every plan including the free key.
Can it read pages behind a login?
No. It reads public pages the way a visitor without an account would see them. Pages that need a sign-in, and addresses on your own machine such as localhost, are out of reach.
Can my AI agent call it without code?
Yes. The same call is the extract_brand tool on the MiroMiro MCP server. Connect ChatGPT, Claude, Cursor, Codex or another agent once, with a sign-in and no API key, and ask in plain language.
More about the Website Color Palette API
Extract a brand from any URL
The MiroMiro Website Color Palette & Brand API resolves a site into its full brand identity: named color roles (primary, accent, background, text), the deduplicated palette with usage counts, the brand fonts, every logo the page declares (icons, apple-touch, og image), the site title and description, and its social profiles - one GET request, clean structured JSON.
Auto-brand onboarding and enrichment
Pull a new customer’s brand colors at signup for an instantly themed workspace, enrich a CRM or directory with each company’s real palette, or generate a matching theme from any reference URL. This is the curated “give me the brand” view - for the raw firehose of every token, use the Design Tokens API.
Get your free API key
300 free credits every month, no credit card. One key unlocks every endpoint - brand, tokens, images, SVGs, fonts, and Lottie. Upgrade only when you outgrow the free tier.