Make your first request
Create a free account in the developer dashboard to get an API key, then call the API from your server:brandfetch.com are free, so you can build your integration without spending quota. Swap in any other identifier when you are ready.
What it returns
Here is the response for
brandfetch.com, shortened:
Shortcut fields
Most integrations show one image of each kind, so every response carries four shortcut fields:logo, symbol, icon, and banner. Each one holds the address of the best match from logos or images, or null when the brand has no image of that kind. Put the address straight into an <img> tag.
Logos and images explains how each best match is picked, the image sizes, and how to cache them.
Go further
Batch lookups
Look up to 100 brands in one request.
Real-time indexing
Prefetch brands ahead of time, or skip the crawl with
cachedOnly.Color palette
Color roles, themes, contrast pairs, and CSS tokens.
Typography
Font roles, fallbacks, licenses, and the type scale.
Webhooks
Get notified when a brand you follow changes.
Quotas and usage
The Brand API, Brand Context API, and Transaction API share one quota, counted in brand fetches. The free plan includes 100. See limits and billing for quotas, throughput, and overage.Errors
When the Brand API refuses a request, the response says why in two places. Thex-bf-error header carries one code. The JSON body repeats that code as error, beside the message you have always received and a docs link to this table. Branch on the code, not on the message text.
402 is the exception, whether no credential was sent or a payment was not accepted: its body is the payment protocols’ own, so only the header names the refusal (payment_required). API Gateway answers a few requests itself, for example a throughput limit. Those responses carry no x-bf-error header.
The Transaction API uses most of the codes below and adds two of its own, body_invalid and transaction_unmatched, listed in Transaction API errors.
The request
The credential
The brand
Every404 below uses one API credit: you asked us to look, and we looked. A pay-per-request 404 is settled too, except crawl_queued: that payment is not charged, the body says so in a payment object, and the same payment can be presented again for the retry. The code tells you whether asking again can help.
Our side
The errors overview explains how codes work across every Brandfetch API.