> ## 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. # Parameters > Detailed reference of all Logo API parameters ## URL Structure The Logo API uses a structured URL format that allows you to customize logo retrieval through path and query parameters: #### Short version ```html Domain theme={null} Logo by Brandfetch ``` ```html Ticker theme={null} Logo by Brandfetch ``` ```html ISIN theme={null} Logo by Brandfetch ``` ```html Crypto theme={null} Logo by Brandfetch ``` ```html Auto-detection (legacy) theme={null} Logo by Brandfetch ``` #### Full version with all parameters ```html Domain theme={null} Logo by Brandfetch ``` ```html Ticker theme={null} Logo by Brandfetch ``` ```html ISIN theme={null} Logo by Brandfetch ``` ```html Crypto theme={null} Logo by Brandfetch ``` ```html Auto-detection (legacy) theme={null} Logo by Brandfetch ``` 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](https://developers.brandfetch.com/register). *** ## 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:** ```html Domain theme={null} Logo by Brandfetch ``` ```html Ticker theme={null} Logo by Brandfetch ``` ```html ISIN theme={null} Logo by Brandfetch ``` ```html Crypto theme={null} Logo by Brandfetch ``` ```html Auto-detection (legacy) theme={null} Logo by Brandfetch ``` 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` * `light`: The light version of the logo * `dark`: The dark version of the logo ## fallback **Type:** `enum` 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` * `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) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.