> ## 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.

# Batch lookups

> Look up to 100 brands in one Brand API request. Each brand found uses one credit, and misses are free.

Send up to 100 identifiers in one request. Get one result per identifier, in the order you sent them.

```curl Batch lookup theme={null}
curl --request POST \
--url https://api.brandfetch.io/v2/brands/batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{"identifiers": ["nike.com", "https://www.spotify.com/about", "not a domain"]}'
```

Each result carries the identifier you sent, a `status` and, on a `200`, the `brand` (shortened here):

```json theme={null}
{
  "results": [
    { "identifier": "nike.com", "status": 200, "brand": { "name": "Nike", "domain": "nike.com" } },
    { "identifier": "https://www.spotify.com/about", "status": 200, "brand": { "name": "Spotify", "domain": "spotify.com" } },
    { "identifier": "not a domain", "status": 400, "message": "Bad Request" }
  ]
}
```

A batch never crawls while you wait. A brand that is not indexed yet is queued for indexing and answered `202`. Request it again later, on its own or in your next batch.

| Status | Meaning |
| - | - |
| `200` | The brand, in the same shape as `GET /v2/brands/{identifier}`. |
| `202` | Not indexed yet. Queued for indexing. |
| `204` | With `cachedOnly`: not indexed. Nothing is queued. |
| `400` | Not a valid identifier. `message` says why. |
| `404` | No brand for the identifier. `message` gives the reason. |
| `413`, `500`, `504` | Not answered this time. Request it again. |

A string is read as the identifier of `GET /v2/brands/{identifier}`: a domain, website URL, email address, brand ID, ticker or ISIN. To name the type, send an object: `{ "type": "ticker", "value": "BHP.AX" }`. `type` is `domain`, `ticker`, `isin`, `crypto` or `brandId`. An exchange-suffixed ticker sent as a string, such as `bhp.ax`, is read as a domain.

`cachedOnly`, `allowNsfw` and `palette` go in the body, as booleans, and mean what they mean on `GET`.

Each identifier answered `200` uses one API credit. Every other result is free, `404` included, and an identifier repeated in one request is charged once. When your organization has fewer credits left than a batch could use, the batch is refused with `429` and nothing is charged. Batch lookups are available on paid plans and with prepaid credits. A free plan receives `403` with the header `x-bf-error: paid_plan_required`. See the [reference](https://docs.brandfetch.com/reference/brand-api-batch.md) for the full contract.


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