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
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)
{type}/{identifier}:
domain/nike.com- Query by domain nameticker/NKE- Query by Stock or ETF tickerisin/US6541061031- Query by ISIN codecrypto/BTC- Query by Crypto symbol
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 logodark— The dark version of the logo
fallback
Type:enum<string>
brandfetch— The Brandfetch logotransparent— A see-through placeholder for custom background optionslettermark— A square icon featuring the first letter of the brand’s name (applies only to type=icon)404— HTTP status 404 and a see-through placeholder for custom background options
brandfetchforicontransparentforlogoandsymbol
h
Type:number
Height of the logo. The ratio of the logo is always respected.
w
Type:number
Width of the logo. The ratio of the logo is always respected.
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)