Skip to main content

​
URL Structure

The Logo API uses a structured URL format that allows you to customize logo retrieval through path and query parameters:

​
Short version

​
Full version with all parameters

To use Logo API, you must include your client ID with every request. To get your client ID, register for free from our Developer Portal.

​
identifier

Type: string Required Identifier to retrieve brand assets. Accepted formats:
  • Domain: nike.com
  • Brand ID: id_0dwKPKT
  • ISIN: US6541061031
  • Stock or ETF ticker: NKE
  • Crypto symbol: BTC, ETH (uppercase preferred)
To avoid potential naming collisions between identifier types, you can use explicit type routes with the pattern {type}/{identifier}:
  • domain/nike.com - Query by domain name
  • ticker/NKE - Query by Stock or ETF ticker
  • isin/US6541061031 - Query by ISIN code
  • crypto/BTC - Query by Crypto symbol
Examples:
If you omit the type prefix (e.g., nike.com instead of domain/nike.com), the API will auto-detect the identifier type. The detection order is: Domain → Stock or ETF ticker → ISIN → Crypto symbol. However, we recommend using explicit type routes to prevent collisions and ensure accurate results.

​
theme

Type: enum<string>
  • light: The light version of the logo
  • dark: The dark version of the logo

​
fallback

Type: enum<string> What you get when the logo cannot be served:
  • brandfetch: The Brandfetch logo, in the requested type and theme
  • transparent: A see-through placeholder, sized to your w and h, for custom background options
  • lettermark: A square icon featuring the first letter of the brand’s name (applies only to type=icon; for logo and symbol it behaves like brandfetch)
  • 404: HTTP status 404 with an empty body, so your own code can decide what to show
Default: Depends on why the logo is missing, not on the type
  • transparent when the identifier does not resolve to a brand, or cannot be parsed at all
  • brandfetch when the brand exists but has no asset of the requested type and theme
The image fallbacks (brandfetch, transparent, and lettermark on logo or symbol) are served as WebP whatever format the URL asks for. The one exception is lettermark on type=icon, which is drawn in the requested format and can also be requested as .svg.

​
h

Type: number Height of the logo, in pixels. The ratio of the logo is always respected: give only h and the width follows. Give both w and h and the logo’s longer side takes the matching value while the other side follows the ratio — so a wide logo asked for w/200/h/20 comes back 200 wide and as tall as its ratio dictates. Size one side only, or match your box to the logo’s ratio, when the result must fit. Every size, fallbacks included, is clamped between 16 and 2048 pixels, and a raster logo is never enlarged beyond its stored size. A non-numeric, zero or negative value is ignored; a decimal is truncated to its whole part.

​
w

Type: number Width of the logo, in pixels. The ratio of the logo is always respected: give only w and the height follows. Give both w and h and the logo’s longer side takes the matching value while the other side follows the ratio — see h above for what that means for a box of a different shape. Every size, fallbacks included, is clamped between 16 and 2048 pixels, and a raster logo is never enlarged beyond its stored size. A non-numeric, zero or negative value is ignored; a decimal is truncated to its whole part.

​
type

Type: enum<string>
  • icon: (default) The icon used on social profiles (e.g., Tesla’s social icon)
  • logo: The horizontal logo, usually seen on large surfaces (e.g., Tesla’s logo)
  • symbol: The universal mark that abstractly represents the brand (e.g., Tesla’s T symbol)