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

# Overview

> Instantly add any company logos to your app or website

[Logo API](https://brandfetch.com/developers/logo-api) is a simple CDN link that gives you access to any brand’s latest logos. It’s customizable with powerful transformation capabilities and is meant to be directly embedded in your HTML tags so the logo always remains up-to-date.

## Implementation guide

The Logo API is a free product. Before you deploy your application to a live
environment, be sure to consult our [rate limits](/logo-api/rate-limits) and
review our [usage guidelines](/logo-api/guidelines) to ensure a smooth launch.

<Steps>
  <Step title="Embed your logo">
    To embed a logo, simply use an `img` tag with the following `src` attribute:

    <CodeGroup>
      ```html Auto-detection theme={null}
      <img
        src="https://cdn.brandfetch.io/nike.com?c=BRANDFETCH_CLIENT_ID"
        alt="Logo by Brandfetch"
      />
      ```

      ```html Domain theme={null}
      <img
        src="https://cdn.brandfetch.io/domain/nike.com?c=BRANDFETCH_CLIENT_ID"
        alt="Logo by Brandfetch"
      />
      ```

      ```html Stock or ETF ticker theme={null}
      <img
        src="https://cdn.brandfetch.io/ticker/AAPL?c=BRANDFETCH_CLIENT_ID"
        alt="Logo by Brandfetch"
      />
      ```

      ```html Crypto symbol theme={null}
      <img
        src="https://cdn.brandfetch.io/crypto/BTC?c=BRANDFETCH_CLIENT_ID"
        alt="Logo by Brandfetch"
      />
      ```

      ```html ISIN theme={null}
      <img
        src="https://cdn.brandfetch.io/isin/US0378331005?c=BRANDFETCH_CLIENT_ID"
        alt="Logo by Brandfetch"
      />
      ```
    </CodeGroup>

    <Tip>
      You can use explicit type routes (`domain/`, `ticker/`, `isin/`, `crypto/`) to avoid naming collisions. Without a type prefix, the API will auto-detect the identifier type (domain → ticker → isin → crypto).
    </Tip>
  </Step>

  <Step title="Register an account and get your Client ID">
    <Tip>
      Logo API is free to use and <u>we don't ask for any attribution</u>.
    </Tip>

    Each request must include your unique client ID. This ensures your usage stays within fair limits and logos render reliably.

    To get your client ID, register for free from our [Developer Portal](https://developers.brandfetch.com/register).
  </Step>

  <Step title="Implement additional features">
    Beyond simply swapping out the base URL, Brandfetch's Logo API offers powerful features to enhance your logo fetching experience:

    * **Logo types:** Access not just logo icons, but also brand symbols and main logos.

    * **Theme variants:** Access dark or light logos, display them on any background.

    * **Customizable sizing:** Adjust the logo’s height and width to fit your needs.

    * **Smart fallbacks:** Even when a logo isn’t available, you’ll get fallbacks.

    * **Search by Stock or ETF ticker:** Query directly by Stock or ETF ticker (e.g., `NKE`, `QQQ`).

    * **Search by ISIN**: Query directly by ISIN (e.g., `US6541061031`).

    * **Search by Crypto symbol:** Query directly by Crypto symbol (e.g., `BTC`, `ETH`).

    Explore these options in our Logo API [parameters page](/logo-api/parameters).
  </Step>
</Steps>

***

## Default icon

Get the brand's default logo icon.

<CodeGroup>
  ```html Domain theme={null}
  <img
    src="https://cdn.brandfetch.io/nike.com?c=BRANDFETCH_CLIENT_ID"
    alt="Logos by Brandfetch"
  />
  ```

  ```html Stock or ETF ticker theme={null}
  <img
    src="https://cdn.brandfetch.io/ticker/NKE?c=BRANDFETCH_CLIENT_ID"
    alt="Logos by Brandfetch"
  />
  ```

  ```html Crypto symbol theme={null}
  <img
    src="https://cdn.brandfetch.io/crypto/BTC?c=BRANDFETCH_CLIENT_ID"
    alt="Logos by Brandfetch"
  />
  ```
</CodeGroup>

### PNG or JPG instead of WEBP

By default Logo API serves logos in the modern and highly efficient WebP format. You can use others formats by specifying the file extension in the URL.

`logo`, `symbol` type variants support an additional `svg` format.

```html theme={null}
<img
  src="https://cdn.brandfetch.io/:domain/icon.png?c=BRANDFETCH_CLIENT_ID"
  alt="Logos by Brandfetch"
/>
```

### Logo sizing / Retina

Customize the logo’s dimensions by adding `w` (width) and `h` (height) query parameters to the URL. The ratio of the logo is always respected.

For Retina displays, double the size values for optimal display. e.g., for a 64x64 icon display, set `h=128` and `w=128`.

```html theme={null}
<img
  src="https://cdn.brandfetch.io/:domain/h/128/w/128/icon.png?c=BRANDFETCH_CLIENT_ID"
  alt="Logos by Brandfetch"
/>
```

### Type variants

Request different types of logos by using the `type` path parameter.

Available variants are: `icon`, `symbol`, and `logo`.

```html theme={null}
<img
  src="https://cdn.brandfetch.io/:domain/symbol?c=BRANDFETCH_CLIENT_ID"
  alt="Logos by Brandfetch"
/>
```

### Dark and light themes

Ensure the logo looks great regardless of the background color of your application.

```html theme={null}
<img
  src="https://cdn.brandfetch.io/:domain/theme/light/logo?c=BRANDFETCH_CLIENT_ID"
  alt="Logos by Brandfetch"
/>
```

### Multiple fallbacks

Specify a fallback option to be used when the a logo is not available.
[See all fallbacks](/logo-api/parameters).

```html theme={null}
<img
  src="https://cdn.brandfetch.io/:domain/fallback/lettermark/icon?c=BRANDFETCH_CLIENT_ID"
  alt="Logos by Brandfetch"
/>
```

## Explore more options

Explore these options in our Logo API [parameters page](/logo-api/parameters).