A developer’s guide to migrating from Clearbit’s Logo API to Brandfetch

Introduction

Clearbit’s once-popular Logo API is shutting down, leaving many developers searching for a Clearbit logo alternative that offers reliable, up-to-date logos. If your code currently relies on https://logo.clearbit.com/:domain to fetch brand logos, your app might rendering logos soon.

This guide provides a comprehensive overview of migrating to a new Logo API solution. We’ll explain why you should consider migrating, and walk through the migration process (using Brandfetch’s Logo Link as an example) with code samples and best practices. By the end, you’ll have a clear path to replace Clearbit’s Logo API with a robust alternative.

Why Migrate?

Clearbit’s Logo API service is being deprecated – it’s not maintained and is scheduled to terminate at the end on December 1, 2025. This means existing integrations will eventually stop working.

To keep your product’s UI displaying company logos, migrating to a new Logo API is a must. Fortunately, several alternatives have emerged. Logo Link from Brandfetch is a strong choice, it’s reliable with a 100% uptime, it’s trusted in production by Canva, Typeform and Experian, and has the most generous free tier with up-to 1 mio requests/month making it the no-brainer alternative solution.

Detailed Migration Guide (Using Logo Link as an Example)

Below is a simplified pathway for migrating from Clearbit’s Logo API to Brandfetch as your primary logo API.

1. Sign Up & Authentication

👉

When embedding Logo Link, HTTP requests must include the Referer header with the request origin. Your HTTP Referrer-Policy header must be set to one of: origin, origin-when-cross-origin, strict-origin, strict-origin-when-cross-origin (browser default), or unsafe-url.

Register: Create a developer account on Brandfetch’s platform and retrieve your clientId.
Include the Client ID: Each request for an embedded logo must include your unique client ID. This ensures your usage stays within fair limits and logos render reliably.

2. Replace the API Endpoints

Old Clearbit CDN:

Copy

<img src="https://logo.clearbit.com/:domain" alt="Logo" />

New Logo Link CDN:

Copy

<img src="https://cdn.brandfetch.io/:domain?c={client-id}" alt="Logos by Brandfetch" />

This “drop-in” approach makes it easy to embed logos; simply adjust the src attribute in your HTML.

3. Parameters & Optional Features

With Clearbit’s API, you had limited or no parameters beyond size and grayscale. Logo Link provides a a powerful path-based structure provides more flexibility:

Copy

https://cdn.brandfetch.io/{domain}/{type}/theme/{theme}/fallback/{fallback}/h/{height}/w/{width}?c={client-id}

You can specify:

Logo Type: icon, logo, or symbol

Logo Type: icon, logo, or symbol
Theme: light or dark
Fallback: brandfetch, transparent, lettermark, or 404
Sizing: Control height or width (the logo’s aspect ratio is preserved)

This means you can fetch a full horizontal logo, a small symbol, or a dark-themed version—all via URL parameters.

4. Error Handling & Fallbacks

Clearbit typically returned an HTTP 404 for unknown domains.
Brandfetch gives you control: specify fallback/lettermark to get a lettermark, or fallback/404 if you prefer to catch and replace a broken image. Learn about fallbacks here.

5. Pricing, Attribution & Rate Limits

Logo Link is free with 1’000’000 requests/mo and you don't need to display an attribution link—simply include your clientId in every request. If you anticipate heavy usage, book a call to explore enterprise packages including custom caching rules, SLAs, and flexible legal terms.

Conclusion

Migrating from Clearbit’s Logo API to a new “logo API” may sound daunting, but it’s actually a quick update—especially if you leverage Brandfetch’s Logo Link.

The table above makes it clear: Clearbit is no longer viable, and while Logo.dev helps for a basic drop-in replacement, Logo Link is the future-proof replacement for modern startups and large enterprise with reliable maintenance, and a far richer dataset for those who want to expand beyond simple logos.

Swapping out logo.clearbit.com/:domain with Brandfetch’s cdn.brandfetch.io/:domain?c={clientId} is often enough to get you up and running right away.

From there, you can explore theming, fallback images, and brand color data. If you need a truly comprehensive and future-proof “clearbit logo alternative,” Brandfetch is the clear winner.

Happy building! 🛠️

Ready to ship?

We're the leading brand data aggregator, simplifying next-level B2B personalization for developers

All services online