Skip to content
Brand Identity API
Docs page

Start

Brand Identity API documentation

Get brand colors, fonts, logos and company data for any domain with one REST call, a logo CDN URL or an MCP tool.

Brand Identity API turns a domain into a brand: logos in each variant we find, brand colors, fonts, social links and company facts. Call the REST API from your server, put a logo URL in an img tag, or give an AI agent the MCP server. The JSON uses the same field names as Brandfetch's Brand API, so existing integrations move over with a base URL change.

Quick start

  1. Create a free account and copy a secret key (it starts with lh_sk_) from the API keys page. No card needed.
  2. Look up a brand. Only lookups that find a brand cost a credit, and every account starts with 50 free.
  3. Store the response for as long as you like. Caching is allowed on every plan.
bash
curl https://brandidentityapi.com/v1/brands/stripe.com \
  -H "Authorization: Bearer $BRAND_IDENTITY_API_KEY"

For a logo alone you do not even need a key: brands already in the index load straight from the logo CDN.

html
<img src="https://brandidentityapi.com/logo/stripe.com?size=64" alt="Stripe logo" width="64" height="64" />

Base URL

Every endpoint lives on https://brandidentityapi.com. Requests and responses are JSON over HTTPS, except the logo CDN and asset URLs, which return images.

Endpoints

EndpointWhat it doesKeyCounts as a lookup
GET /v1/brands/{domain}The full brand record for a domain, URL or email addressSecretYes, when a brand is found
POST /v1/brands/batchMany domains in one requestSecretOne per brand found
GET /v1/search?q=Brands by name or domain, for an autocompleteSecret or publishableNo
GET /v1/meYour plan, credits left, this month's usage and your limitsSecretNo
GET /logo/{domain}A logo image for an img tagNone for indexed brands, or publishableNo
GET /v2/brands/{domain}The Brandfetch-compatible alias of the Brand APISecretYes, when a brand is found
POST /mcpThe MCP server for AI agentsSecret for get_brand, any key for search, none for get_logo_urlOnly get_brand, like the Brand API
GET /v1/openapi.jsonThe OpenAPI documentNoneNo

Conventions

Send your key as Authorization: Bearer lh_sk_.... See Authentication for the two kinds of key.

Every error has the same shape, { "error": { "code", "message", "docs" } }, and every code has its own entry on the Errors page. Every response carries an X-Request-Id; include it when you write to us.

Rate limits and your remaining credits come back in headers on every call. See Rate limits and quotas.

All pages

Getting startedCreate a free key, make your first brand lookup in curl, JavaScript or Python, and cache the result.AuthenticationSecret keys (lh_sk_) for server calls, publishable keys (lh_pk_) for logos in the browser, and how to send them.Brand APIGET /v1/brands/{domain}: every field in the response (logos, brand colors, fonts, company data), the parameters, status codes and caching.BatchPOST /v1/brands/batch: look up many domains in one request. Only the brands that are found cost a credit.Search APIGET /v1/search: find brands by name or domain for an autocomplete. No credits: 250,000 searches a month free, more on paid plans.Logo APIPut /logo/{domain} in an img tag: type, size, format, theme, background and fallback parameters, keys and caching.MCP serverConnect Claude Desktop, Cursor or any MCP client to Brand Identity API and give your agent get_brand, search_brands and get_logo_url.OpenAPI specDownload the OpenAPI document at /v1/openapi.json and import it into Postman, Insomnia or a client generator.ErrorsThe error envelope and every error code the API returns, with what causes it and what to do next.Rate limitsCredits, requests per minute and monthly logo and search allowances for each plan, the headers that report them, and what happens at a limit.Data qualityHow often each brand field is filled across the Brand Identity API index, measured by a script, beside the coverage Brandfetch publishes.From BrandfetchMove a Brandfetch Brand API integration to Brand Identity API by changing the base URL and key. Field mapping and differences.From ClearbitReplace logo.clearbit.com URLs with the Brand Identity API logo CDN in one line, with the size and format parameters mapped.