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:

<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

<img src="https://logo.clearbit.com/apple.com" alt="Apple logo" />

After

<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

<img src="https://logo.clearbit.com/apple.com?size=128" alt="Apple logo" />

After

<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:

<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:

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

[e-mail]