Migrate
Migrate from Brandfetch
Move a Brandfetch Brand API integration to Brand Identity API by changing the base URL and key. Field mapping and differences.
Brand Identity API answers Brandfetch's Brand API v2 paths with the same field names, so most integrations move over with two changes: the base URL and the key.
Change the base URL
- https://api.brandfetch.io/v2/brands/stripe.com
+ https://brandidentityapi.com/v2/brands/stripe.comThen send a Brand Identity API secret key (lh_sk_) as the bearer token, in the same Authorization header your client already sets:
const BASE_URL = "https://brandidentityapi.com/v2"; // was https://api.brandfetch.io/v2
const res = await fetch(`${BASE_URL}/brands/stripe.com`, {
headers: { Authorization: `Bearer ${process.env.BRAND_IDENTITY_API_KEY}` },
});
const brand = await res.json();Endpoint mapping
| Brandfetch | Brand Identity API | Notes |
|---|---|---|
| GET /v2/brands/{id} | GET /v2/brands/{id} | Same response. /v1/brands/{id} is the same handler. |
| GET /v2/brands/domain/{domain} | GET /v2/brands/domain/{domain} | Same response. |
| GET /v2/search/{name} | GET /v2/search/{name} | A bare array, as Brandfetch returns. |
| Logo Link CDN | GET /logo/{domain} | See Logo Link URLs below. |
Identifiers can be a domain, a URL or an email address. Brandfetch's own brand ids are not ours, so look brands up by domain.
Field mapping
Every field below has the same name and meaning in both APIs. Fields we add are listed after it; a client that does not know them ignores them.
| Field | Notes |
|---|---|
| name, domain, description, longDescription | Same. |
| claimed | Same meaning. |
| links[].name, links[].url | Same. |
| logos[].type, logos[].theme | Same values: icon, symbol, logo, other; light, dark or null. |
| logos[].formats[].src, format, background, width, height, size | Same. src points at our CDN. |
| logos[].tags | Same field. We add the generated tag for variants we drew. |
| colors[].hex, type, brightness | Same. |
| fonts[].name, type, origin, originId, weights | Same. origin can also be adobe, for Adobe Fonts, where Brandfetch says custom. |
| images[] | Same shape. |
| company.employees, foundedYear, kind, location, industries | Same shape. Industries come from our own taxonomy. |
| company.financialIdentifiers.ticker, isin | Same shape, never null. ticker holds the bare symbol; isin is always empty for now. |
| qualityScore, isNsfw, urn, id | Same names. Ids and URNs are ours. |
Additions: status, updatedAt, restriction (why an adult site's empty record is empty), company.ticker (the exchange and symbol, such as NASDAQ:AAPL, next to Brandfetch's financialIdentifiers) and the adobe font origin. Full definitions are in the Brand API reference.
Logo Link URLs
Brandfetch's Logo Link puts options in the path and a client id in the query. Ours puts options in the query and takes an optional publishable key:
- https://cdn.brandfetch.io/stripe.com/w/128/h/128/theme/dark/type/icon?c=YOUR_CLIENT_ID
+ https://brandidentityapi.com/logo/stripe.com?size=128&theme=dark&type=icon&key=lh_pk_your_key| Logo Link | Brand Identity API |
|---|---|
| /w/{n}/h/{n} | size={n} (the longest side) |
| /theme/light or /theme/dark | theme=light or theme=dark |
| /type/icon, /type/symbol, /type/logo | type=icon, type=symbol, type=logo |
| /fallback/lettermark | fallback=monogram |
| /fallback/transparent | fallback=transparent |
| /fallback/404 | fallback=404 |
| ?c={clientId} | key=lh_pk_... (optional for indexed brands) |
What is different
Brandfetch's terms as published on its own pages, as of October 2026. Check them before you decide.
- Caching. You may cache and store responses and logos forever. Brandfetch asks for Brand API data to be refreshed at least every 30 days, and allows caching its logo CDN only under a custom contract.
- Server-side logo fetches are allowed. Brandfetch's logo CDN is hotlink-only, with a Referer check; ours has no such rule.
- Metering. Only lookups that find a brand cost a credit, on every plan. Credits never expire, and when they run out the API answers 402 instead of charging overage.
- Your own API. Including the data in your own API responses is arranged on the Custom plan: see pricing.
- Coverage. Brandfetch has a larger, owner-curated index. Run a sample of your own domains through both before you switch, and compare what matters to you.
- Endpoints we do not have. Only the Brand API, search and the logo CDN are mirrored. If you use other Brandfetch products, keep them for now.
generated, so check logos[].theme rather than assuming a variant is missing.Checklist
- Create a secret key, and a publishable key if you embed logos.
- Swap the base URL and key in a staging build. Compare a few hundred of your real domains.
- Translate Logo Link URLs with the table above.
- Remove refresh jobs that existed only to meet the 30-day rule, or keep them on your own schedule with
?refresh=trueon a paid plan. - Ship, then watch your usage on the dashboard for the first week.