Docs/Brand colors, fonts and logo

Guide

Logo API: get any company's logo, colors and fonts from its URL

Give MiroMiro a domain and get the brand back: the primary and accent colours with names, the full palette, the fonts, the logo, the social share image and the social profiles. It also tells you how sure it is - whether the site declared those colours itself or MiroMiro had to infer them.

What you get

  • Colour roles: primary, accent, background and text, as hex, with human names like "Royal Blue" (colors, colorNames).
  • The brand palette, up to 12 colours, brand colours first (palette).
  • The fonts, split into the main text face and the monospace face (fonts, typography).
  • The best logo URL plus every logo and icon candidate (logo, logos), and the og:image (ogImage).
  • Social profiles found on the page, one per platform (socials).
  • A confidence score and a plain-English explanation of where each answer came from (confidence, signals).

Ask your AI

Not connected yet? Add MiroMiro to ChatGPT, Claude, Cursor or Codex in a minute - see Install MCP. It needs no code, and the free plan includes 300 credits a month.

Authorization: Bearer mm_live_…
Paste into ChatGPT, Claude or Cursor

Asking whether the colours were declared matters: the answer includes a ready sentence (signals.explanation) that says so, and the assistant should repeat it rather than present a guess as the official palette.

Or call the API

https://miromiro.app/api/v1/extract?url=stripe.com&access_key=mm_live_…
curl

One call costs 15 credits. Only need the logo? Add fields=logo,logos to get a smaller answer - the cost stays the same, the response is shorter.

Reading the result

colors.primaryThe brand colour. Taken, in order of trust, from the site's own brand CSS variable, its theme-color, the colours of its logo, or - weakest - the most-used vivid colour.
signals.primarySourceWhich of those it came from: css-var, theme-color, logo or usage. usage means it is an educated guess.
confidenceFrom 0 to 1. Around 0.8 or more means the site declared its identity; 0.4 or less means most of it was inferred. Check it before applying a brand automatically.
logoThe best single logo or icon. logos lists every candidate with its source (icon, apple-touch-icon, mask-icon, og) and size.

If it does not work

The primary colour is empty or looks wrong.

Check signals.primarySource. If it says usage, the site declares no brand colour and the result is a guess. If colours are missing entirely on a JavaScript-heavy site, ask again with render=true.

The logo is a small favicon, not the full logo.

Many sites only declare icons in their HTML. Look through logos for the largest apple-touch-icon or a mask-icon, or use the images and SVG endpoints to find the logo file on the page.

Can I run this on a list of companies?

Yes. Call it once per domain; identical calls within 24 hours are free. Filter on confidence to decide which results to apply automatically and which to review.

Try it on your own site first: the free plan includes 300 credits a month, no card needed.

Get a free key