> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brandfetch.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Brandfetch returns real company logos, brand data, and brand context. It does not design, generate, or edit logos.
> To show a logo in a user interface, use the Logo API as an image URL in an <img> tag, such as https://cdn.brandfetch.io/domain/{domain}?c={CLIENT_ID}. The client ID is public and belongs in frontend code. Never download, proxy, re-host, or optimize these images on a server, because requests that look programmatic are redirected with automated_traffic. In Next.js, this means next/image needs a custom loader or the unoptimized prop.
> To turn a company name that a user types into a domain, use the Brand Search API with the same client ID, and keep only the domain the user picks.
> For colors, fonts, downloadable logo files, and company data as JSON, call the Brand API from a server with the header Authorization: Bearer {API_KEY}, reading the key from an environment variable and never exposing it to the browser. Prefer typed routes such as /v2/brands/domain/{domain} and /v2/brands/ticker/{ticker} over the auto-detect route /v2/brands/{identifier}.
> Use the Brand Context API for a written summary of what a company does, who it sells to, and how it sounds, and the Transaction API to identify the merchant behind a card or bank transaction label.
> When a request fails, branch on the x-bf-error header code rather than on the status code or the message text. Every code, and what to do about it, is listed at https://docs.brandfetch.com/concepts/errors.
> Requests for brandfetch.com are free on the Brand API and Brand Context API, so use that domain in tests and examples.
> Brand API responses can be cached for up to 30 days, while Logo API images must be hotlinked rather than stored and Brand Search results must not be stored at all. See https://docs.brandfetch.com/concepts/caching.
> If the user has no credentials yet, https://brandfetch.com/auth.md explains how they get a client ID and an API key. An agent without an account can pay $0.10 per Brand API, Brand Context API, or Transaction API request with x402 or MPP, as described at https://docs.brandfetch.com/agents/pay-per-request.

# Logos and images

> Pick the right logo, icon, or banner from a Brand API response, and use the homepage screenshot

## Shortcut fields

`logos` and `images` list every logo and image Brandfetch holds for a brand, in each theme and format. Most integrations show one image of each kind. Every Brand API response carries four shortcut fields for that: `logo`, `symbol`, `icon` and `banner`.

Each shortcut field picks the best match of its kind from `logos` or `images`. It holds that image's address, or `null` when the brand has no image of that kind.

```json theme={null}
"logo": "https://cdn.brandfetch.io/id_0dwKPKT/w/512/h/512/theme/dark/fallback/404/logo.webp?c=BRANDFETCH_CLIENT_ID&t=1790425200000",
"symbol": null,
"icon": "https://cdn.brandfetch.io/id_0dwKPKT/w/128/h/128/fallback/lettermark/icon.webp?c=BRANDFETCH_CLIENT_ID&t=1790425200000",
"banner": "https://cdn.brandfetch.io/id_0dwKPKT/w/1500/h/500/fallback/404/banner.webp?c=BRANDFETCH_CLIENT_ID&t=1788006000000"
```

| Field | Best match | The image | `null` when |
| - | - | - | - |
| `logo` | From `logos`: the dark logo, or the light one when the brand has no dark logo. | WebP, up to 512 px on its longer side | the brand has no logo |
| `symbol` | From `logos`: the dark symbol, or the light one when the brand has no dark symbol. | WebP, up to 512 px on its longer side | the brand has no symbol |
| `icon` | From `logos`: the brand's icon. A brand without one gets an icon made from its symbol or logo. | Square WebP, up to 128 px | the brand has no icon, symbol or logo |
| `banner` | From `images`: the brand's banner. | WebP, up to 1500 px wide | the brand has no banner |

Use a shortcut field when you need one image of a kind. Use `logos` and `images` when you need every theme, format or variant.

Fetch each address as it is given. Its `c` parameter is a client ID signed for your API key. The client ID is required, and a request without it is refused. Its `t` parameter changes when the image does, so you can tell when a stored copy is out of date, and like the rest of the response you can keep the image for up to 30 days, as [Caching](https://docs.brandfetch.com/concepts/caching.md) explains. The image does not count towards your quota. It works in an `<img>` tag, from a browser, or from your server.

* The address of a logo or symbol names its theme. `theme/dark` is a dark image, for light backgrounds. `theme/light` is a light image, for dark backgrounds.
* If an image is gone when you fetch it, `logo`, `symbol` and `banner` return `404`. `icon` returns a lettermark instead: the brand's initial on a plain square.
* All four shortcut fields are `null` for brands with `isNsfw: true`.

## Homepage screenshot

A brand kit tells you the brand's logos, colors and fonts. It does not show how the brand puts them together. A screenshot of the homepage does: the layout, the illustration style, the spacing, the tone of the imagery. When you generate designs or content for a brand, give the screenshot to your model next to the brand data.

Every Brand API response carries a `screenshot` object with the address of the image and when Brandfetch took it:

```json theme={null}
"screenshot": {
  "url": "https://cdn.brandfetch.io/id_0dwKPKT/screenshot.png?c=BRANDFETCH_CLIENT_ID&t=1791026976000",
  "capturedAt": "2026-10-03T11:29:36.000Z"
}
```

Fetch `url` as it is given: the `c` parameter is a client ID signed for your API key, and the image does not count towards your quota. It works in an `<img>` tag, from a browser, or from your server. A request that drops the client ID is refused. The address returns a PNG of the top of the homepage at a desktop viewport, as Brandfetch saw it on its last visit. It is not a full-page capture. `t` is the time of capture: the address changes when Brandfetch takes a new screenshot, and like the rest of the response you can keep the image for up to 30 days, as [Caching](https://docs.brandfetch.com/concepts/caching.md) explains.

* `screenshot` is `null` when Brandfetch holds no screenshot of the homepage yet. A held brand gets one on its next visit. It is also `null` for brands with `isNsfw: true`.
* The screenshot is what the crawler saw. For some sites that is a cookie banner, a blank page that had not finished loading, or a bot-protection page. Check the image before you rely on it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.