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 keyAuthentication
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), awwwhost 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 a logo
GET https://cdn.brandkit.superlabs.co/logo/{domain}?key=pk_…&theme=dark&type=logo&format=svgAnswers 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:
darkreturns a light or colourful logo,lighta dark or colourful one. - type
logo(wordmark),symbol(square mark) oricon(favicon, app icon). When a brand has no file of that type,symbolfalls back to the icon,iconto the symbol, and both to the logo;logofalls 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-Keyheader 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.