> ## Documentation Index
> Fetch the complete documentation index at: https://devshine-cbff6863.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating from Clearbit

> Complete Guide to Replacing Clearbit's Logo API with Brand API

Clearbit's Logo API has been widely used by developers to display company logos by domain name. As teams look for a modern and reliable alternative, Brand API Logo API provides a simple migration path with CDN-powered logo delivery, flexible parameters, and support for high-quality brand assets.

This guide explains how to migrate from Clearbit Logo API to Brand API Logo API by updating your logo URLs and adding your Client ID.

## Quick Start Migration

In most cases, you can migrate from Clearbit by replacing the base URL and adding your Brand API Client ID.

**Clearbit Logo URL**

```
https://logo.clearbit.com/:domain
```

**Brand API Logo URL**

```
https://cdn.brandapi.io/:domain?c=:clientId
```

**Example:**

```html theme={null}
<img src="https://cdn.brandapi.io/apple.com?c=YOUR_CLIENT_ID" alt="Apple logo" />
```

## URL Mapping

| Feature         | Clearbit URL                                 | Brand API URL                                                          |
| --------------- | -------------------------------------------- | ---------------------------------------------------------------------- |
| Basic logo      | `https://logo.clearbit.com/:domain`          | `https://cdn.brandapi.io/:domain?c=:clientId`                          |
| Logo size       | `https://logo.clearbit.com/:domain?size=128` | `https://cdn.brandapi.io/:domain/h/128/w/128?c=:clientId`              |
| Custom fallback | Limited fallback control                     | `https://cdn.brandapi.io/:domain/fallback/lettermark/icon?c=:clientId` |
| 404 fallback    | Depends on Clearbit behavior                 | `https://cdn.brandapi.io/:domain/fallback/404/icon?c=:clientId`        |
| SVG logo        | Not always available                         | `https://cdn.brandapi.io/:domain/logo.svg?c=:clientId`                 |

## Step-by-Step Migration

### 1. Get Your Client ID

Create an account on Brand API and retrieve your Client ID from the developer dashboard.

Your Client ID is required for Logo API requests and helps ensure reliable logo delivery, fair usage tracking, and consistent performance.

### 2. Update Image Tags

Replace your existing Clearbit image source URLs with Brand API Logo API URLs.

**Before**

```html theme={null}
<img src="https://logo.clearbit.com/apple.com" alt="Apple logo" />
```

**After**

```html theme={null}
<img src="https://cdn.brandapi.io/apple.com?c=YOUR_CLIENT_ID" alt="Apple logo" />
```

This change allows your application to load company logos through Brand API's CDN.

### 3. Add Logo Sizing

If your existing Clearbit integration uses the `size` query parameter, replace it with Brand API sizing parameters.

**Before**

```html theme={null}
<img src="https://logo.clearbit.com/apple.com?size=128" alt="Apple logo" />
```

**After**

```html theme={null}
<img 
  src="https://cdn.brandapi.io/apple.com/h/128/w/128?c=YOUR_CLIENT_ID"
  width="128"
  height="128"
  alt="Apple logo" 
/>
```

Brand API preserves logo aspect ratio while allowing you to request the size your interface needs.

### 4. Handle Fallbacks

Brand API Logo API gives you flexible fallback options when a logo is not available.

You can use a built-in fallback such as a lettermark:

```html theme={null}
<img 
  src="https://cdn.brandapi.io/unknown-domain.com/fallback/lettermark/icon?c=YOUR_CLIENT_ID"
  alt="Company logo fallback" 
/>
```

Or use the 404 fallback when you want your frontend to handle missing logos:

```html theme={null}
<img 
  src="https://cdn.brandapi.io/unknown-domain.com/fallback/404/icon?c=YOUR_CLIENT_ID"
  alt="Company logo" 
/>
```

This gives your application more control over the user experience.

## Why Migrate to Brand API?

### Higher Quality Logo Assets

Brand API Logo API supports high-quality brand assets, including modern image formats and SVG logos where available.

This helps your logos stay sharp across dashboards, websites, mobile screens, and high-resolution displays.

### More Than Logos

Brand API provides more than basic logo delivery.

With Brand API, you can access brand assets and company metadata such as:

* Logos
* Colors
* Fonts
* Company descriptions
* Domain information
* Brand profiles

This makes it useful for applications that need complete brand data, not just logo images.

### CDN-Based Logo Delivery

Brand API Logo API is built for fast and reliable logo delivery through a CDN-based image URL.

This helps developers embed logos directly in apps and websites without downloading, storing, or manually updating logo files.

### Flexible Logo Customization

Brand API Logo API supports flexible parameters for different UI needs, including:

* Logo type
* Logo size
* Light and dark themes
* Fallback behavior
* File formats

This gives developers more control over how brand logos appear in their applications.

### Fair Use Guidance

Brand API provides clear logo usage guidelines to help developers use third-party logos responsibly.

These guidelines help teams understand fair use principles, logo embedding rules, and acceptable use cases.

## Migration Checklist

Before going live, review this checklist:

* [ ] Create your Brand API account
* [ ] Copy your Client ID from the dashboard
* [ ] Replace Clearbit logo URLs with Brand API CDN URLs
* [ ] Add your Client ID to every request
* [ ] Update size parameters if needed
* [ ] Add descriptive alt text for accessibility and SEO
* [ ] Configure fallback behavior
* [ ] Test missing-logo scenarios
* [ ] Review Logo API usage guidelines and rate limits

## Need Help Migrating?

If you need help replacing Clearbit Logo API, setting up Logo API fallbacks, or choosing the right migration approach, contact our team.

**[hello@devshineteam.com](mailto:hello@devshineteam.com)**