Skip to content
BrandKit

API docs

One request returns a company’s logos, colours, fonts, social links and details. The first request for a brand builds it (10 to 40 seconds); after that it’s served from the cache.

Get an API key

Authentication

Create a key in the dashboard and send it in the X-API-Key header. Authorization: Bearer and a ?key= query parameter also work; prefer the header so keys stay out of logs.

curl -H "X-API-Key: bk_…" https://api.brandkit.superlabs.co/v1/brands/stripe.com

Get a brand

GET https://api.brandkit.superlabs.co/v1/brands/{domain}
domain
A bare domain (stripe.com), a www host or a URL-encoded full URL.
refresh=true
Rebuild the brand now instead of using the cache. At most once per 10 minutes per domain.

X-Cache: HIT means the brand came from the cache; MISS means it was just built.

{
  "domain": "stripe.com",
  "name": "Stripe",
  "description": "Stripe is a financial infrastructure platform for businesses.",
  "about": "Stripe is a financial services and software company that builds payment infrastructure…",
  "industry": "Online payments",
  "verified": true,
  "logos": [
    {
      "type": "logo",
      "theme": "dark",
      "source": "header-svg",
      "formats": [{ "src": "https://…/stripe.com/30fe….svg", "format": "svg", "width": 60, "height": 25, "size": 1460 }]
    }
  ],
  "colors": [{ "hex": "#635bff", "type": "brand", "brightness": 109, "sources": ["logo", "button"] }],
  "fonts": [{ "name": "Sohne", "type": "title", "origin": "custom" }],
  "display": { "background": "#533afd", "text": "#ffffff", "mutedText": "#d4cfff", "accent": "#ffffff", "tinted": false },
  "links": [{ "name": "twitter", "url": "https://twitter.com/stripe" }],
  "company": {
    "foundingDate": "2010",
    "headquarters": "South San Francisco",
    "revenue": { "amount": 5100000000, "currency": "USD", "year": "2024" }
  },
  "fetchedAt": "2026-11-21T06:28:14Z"
}
GET https://cdn.brandkit.superlabs.co/logo/{domain}?key=pk_…&theme=dark&type=logo&format=svg

Answers with the best matching image file itself, so the URL works as an <img> src. Responses carry an ETag and a one-day cache. Web pages are public, so never put your secret bk_ key in one: use your publishable key (pk_) from the dashboard instead. It can only load logos, and you can limit it to your own sites.

<img src="https://cdn.brandkit.superlabs.co/logo/stripe.com?key=pk_…&theme=light" alt="Stripe" />

With a publishable key, logos of brands already in BrandKit are free and don’t count towards your quota (up to 1,200 a minute per key). A brand built for the first time counts as one request. From a server, the same endpoint also takes your secret key, at /v1/brands/{domain}/logo.

theme
The mode you display it in: dark returns a light or colourful logo, light a dark or colourful one.
type
logo (wordmark), symbol (square mark) or icon (favicon, app icon). When a brand has no file of that type, symbol falls back to the icon, icon to the symbol, and both to the logo; logo falls back to the symbol, then the icon.
format
svg, png, ico, webp…
key
Your publishable key. Or send a secret key in the X-API-Key header from a server.

Response fields

logos[].type
logo, symbol or icon.
logos[].theme
The logo's own colour on transparency: light needs a dark background, dark the reverse. Omitted for opaque or multicolour files.
logos[].filled
true when the file paints its own background, like an app icon or a badge. Show it as it is; don't recolour it or place it on a matching colour.
logos[].source
Where the file was found, such as header-svg, favicon or manifest.
colors[].type
brand, accent, dark or light. brand requires evidence beyond CSS variables (the logo, theme colour or buttons).
fonts[].type
title, body or other; origin is google, custom or system.
display
Colours for showing the brand on a page of its own: background, text, mutedText and accent, all readable together. When the brand colour is too mid-tone for text, tinted is true, background is a pale tint of it and the brand colour becomes the accent.
about
A longer, neutral overview in two to four paragraphs, separated by a blank line.
verified
The site was confirmed as the brand's official site.
company
Legal name, founding date, headquarters, contact details and revenue when known. revenue is the latest annual total: amount, ISO currency and year. Figures more than three years old are left out.
rendered
true when the brand was read from the fully loaded page; false when only its HTML could be read.

MCP server

Use BrandKit from Claude, Cursor, VS Code or any agent that speaks the Model Context Protocol. It’s a remote server over streamable HTTP; authenticate with the same API key. Each tool call counts as one request.

https://api.brandkit.superlabs.co/mcp
get_brand
domain, refresh?: the full brand, exactly as the REST API returns it.
get_logo
domain, theme?, type?, format?: the URL of the best logo for the background it sits on.

Claude Code:

claude mcp add --transport http brandkit https://api.brandkit.superlabs.co/mcp --header "X-API-Key: bk_…"

Cursor, VS Code and other clients (mcp.json):

{
  "mcpServers": {
    "brandkit": {
      "url": "https://api.brandkit.superlabs.co/mcp",
      "headers": { "X-API-Key": "bk_…" }
    }
  }
}

The whole documentation is also available as Markdown for LLMs at /llms-full.txt.

Limits and quota

Every account gets 1,000 successful requests per calendar month (UTC), and each key 60 requests a minute. Failed requests don’t count. Every response says where you stand:

X-Quota-Limit: 1000
X-Quota-Remaining: 958
X-Quota-Reset: 1764547200

Need more? Tell us what you’re building and we’ll raise your limit.

Errors

Errors are JSON: {"error": "…", "code": "…"}.

401 missing_api_key
No key was sent.
401 invalid_api_key
The key doesn't exist, was deleted, or has expired.
429 rate_limited
More than 60 requests a minute on this key. Retry after the Retry-After seconds.
429 quota_exceeded
The account's monthly quota is used up.
403 origin_not_allowed
The publishable key is limited to other sites than the page showing the logo.
400
The domain isn't valid.
404
No logo matches the filters (logo endpoint).
502
The site couldn't be fetched or blocked automated access. Try again later.
503 unavailable
A temporary problem on our side. Retry shortly.