Brand: Company Brand Assets by Domain

Brand, part of the Logo.dev API, turns one identifier into a brand’s full public identity: its name, description, colors, social profiles, logo, brandmark, and banners. You already hold these identifiers. They arrive in work emails at signup, sit on CRM records, and appear in portfolios as tickers. One request replaces the crawler, parsers, and image processing you would otherwise run and re-run to catch rebrands. Send your secret key and exactly one identifier to GET /v2/brands:

curl --header "Authorization: Bearer LOGO_DEV_SECRET_KEY" \
  "https://api.logo.dev/v2/brands?domain=apple.com"

The response looks like:

{
  "data": {
    "object": "brand",
    "id": "brand_4x0wr3g0000g00400000000004",
    "slug": "apple",
    "domain": "apple.com",
    "status": "ready",
    "name": "Apple",
    "description": "Apple is a multinational technology company that designs and manufactures consumer electronics, software, and online services.",
    "indexed_at": "2026-09-08T17:35:33Z",
    "is_profane": false,
    "socials": { "linkedin": "https://www.linkedin.com/company/apple", "twitter": "https://x.com/apple" },
    "colors": [{ "r": 0, "g": 0, "b": 0, "hex": "#000000", "oklch": { "l": 0, "c": 0, "h": 0 } }],
    "logo": {
      "url": "https://img.logo.dev/assets/SEALED_TOKEN",
      "etag": "18f50d2cd074270b0d3909e5fd192bfb23c5514eaf4844f4705e61b3ed1a34d3",
      "blurhash": "U*L#2+WB~qRj?bofM{Rj?bxuM{WBayayWBWB",
      "source": { "width": 1000, "height": 1000, "format": "png", "has_transparency": true, "is_vector": false },
      "last_updated_at": "2026-09-08T17:35:33Z",
      "expires_at": "2026-09-28T13:00:00Z"
    },
    "brandmark": { "url": "https://img.logo.dev/assets/SEALED_TOKEN", "...": "..." },
    "social_banners": []
  },
  "metadata": {
    "request_id": "request_01k6z8m2a4b5c6d7e8f9g0h1j2",
    "resolution": { "type": "domain", "value": "apple.com", "method": "direct", "context": {} }
  }
}

Look up a brand lists every field. Key your records on data.id, not on the domain. A brand keeps its id when its domain changes, and GET /v2/brands/{id} fetches it again by that id.

Look up a brand by any identifier

Send exactly one identifier. Each lookup page covers how Logo.dev reads that identifier:

The API reference also lists merchant, for card-statement descriptors. It is not enabled for any account yet and returns 403. To identify a merchant today, use Transaction. GET /v2/brands returns at most one brand, and only a 200 carries one. To show a list of candidates first, use Search.

Handle each status

Status	`data`	What to do
`200`	The brand, with `status: "ready"`	Use it. A single image can still be `null`.
`202`	`{"object": "brand", "status": "not_indexed"}`	Retry after `Retry-After` seconds, or wait for the `brand.indexed` webhook. Not billed.
`404`	`{"object": "brand", "status": "not_found"}`	No brand matches. Not billed.

A first lookup of a brand Logo.dev has not indexed yet returns 202, and the brand is usually ready within a minute. See not found vs. still indexing. Set your HTTP client timeout to at least 15 seconds, because Logo.dev can prepare a brand’s assets at request time. On serverless platforms, a default function timeout such as Vercel’s maxDuration can end the request first.

Automatic subscriptions

If webhooks are on for your account, a lookup also subscribes the account to the brand’s update webhooks. Add nosubscribe=true to skip that. metadata.subscription reports what the lookup did. status is subscribed when the account is subscribed to the brand. Your plan caps the number of subscriptions. At the cap, a lookup of a new brand does not subscribe the account: status is quota_exceeded, and message gives the reason. The lookup is answered and billed as usual.

Get only the logo or the brandmark

GET /v2/brands/logo and GET /v2/brands/brandmark return one image as JSON, without the rest of the brand. They take the same identifiers as GET /v2/brands and never subscribe you to the brand:

curl --header "Authorization: Bearer LOGO_DEV_SECRET_KEY" \
  "https://api.logo.dev/v2/brands/logo?ticker=AAPL"

A brand that is ready but has no image of that kind returns 404, and the request is still billed. To show a logo on a page, you don’t need these routes. The Logo.dev CDN serves logo images with a publishable key.

Images

Every image, inside a brand or on its own, has the same fields:

Field	Meaning
`url`	A temporary signed download URL. It stops working at `expires_at`, about 24 hours later.
`etag`	Identifies this version of the source image. It is the same on every route.
`blurhash`	A compact placeholder to show while the image loads. See BlurHash for decoders.
`source`	The original file: `width`, `height`, `format` (such as `png`, `svg`, or `webp`), `has_transparency`, and `is_vector`
`last_updated_at`	When the image last changed. `null` if it has not changed since the brand was indexed.
`expires_at`	When `url` stops working

Download the images you need and host them yourself. Save each image’s etag with your copy. When you fetch the brand again, download only the images whose etag changed. A new url or expires_at alone does not mean the image changed. The signature in a download URL is the credential, so send no key with it. Add these query parameters to format the download. They do not change source.

Parameter	Values
`size`	Pixels. The default is `128`, and the maximum is `800`.
`format`	`jpg` (the default), `png`, or `webp`
`theme`	`light` or `dark`. Use it with `png` or `webp`.

A url with no parameters downloads a 128-pixel JPG, not the source file. To keep a large copy with transparency, add ?size=800&format=png. Downloads from these URLs do not count as CDN requests.

Resolution

metadata.resolution describes how your identifier reached the brand. It is about the request, not the brand.

Field	Meaning
`type`	The identifier you sent: `domain`, `ticker`, `isin`, `crypto`, `name`, or `brand_id`
`value`	The normalized identifier, for example the registrable domain or the uppercased ticker
`method`	How it matched: `direct` for a brand id or a domain that is its own brand, `domain` through an alias or redirect, `security` for a ticker or ISIN, `crypto` for a token symbol, `search` for a name
`context`	Reserved for merchant lookups. Always `{}` today.

The same identifier can reach a different brand later if its match changes. Subscriptions follow brand ids, so they do not move with it.

Authentication and plans

Brand takes your secret key (sk_...) as a bearer token. Call it from your server, and keep the key out of client code and git. Lookups spend API credits from your plan’s monthly grant, then from prepaid API credits. See API credits for how billing works, including when a repeat lookup is free, what each request costs for the cost of each route, and out of API credits for the 402 response. See the pricing page for what each plan includes.

Next steps

Look up a brand

Every parameter, field, and status code.

Webhooks

Get told when a brand you use changes.

Migrate from Brandfetch

Map each Brandfetch Brand API field to Logo.dev.

Onboarding personalization

Brand a signup flow from a work email.

Get started

CDN

API

Platform

Switch to Logo.dev

Integrations

Get your logo seen

Comparisons

Support

Brand: Company Brand Assets by Domain

Look up a brand by any identifier

Handle each status

Automatic subscriptions

Get only the logo or the brandmark

Images

Resolution

Authentication and plans

Next steps

Look up a brand

Webhooks

Migrate from Brandfetch

Onboarding personalization

​Look up a brand by any identifier

​Handle each status

​Automatic subscriptions

​Get only the logo or the brandmark

​Images

​Resolution

​Authentication and plans

​Next steps

Look up a brand

Webhooks

Migrate from Brandfetch

Onboarding personalization

Look up a brand by any identifier

Handle each status

Automatic subscriptions

Get only the logo or the brandmark

Images

Resolution

Authentication and plans

Next steps