Clearbit Logo API Shutdown: The Complete 2026 Migration Guide

If you landed here because your application suddenly started returning broken images where company logos used to be, you are not alone. In December 2025, HubSpot officially shut down the Clearbit public logo API — the logo.clearbit.com endpoint that millions of developers relied on for company logos.

This guide will get you back up and running in under 10 minutes using LogoRouter, the fastest drop-in replacement available.

What Exactly Happened to Clearbit

HubSpot acquired Clearbit in 2023. By mid-2025 they announced deprecation of all public-facing Clearbit APIs that were not tied to paid HubSpot seats. The https://logo.clearbit.com/{domain} endpoint — which was famously free and required no authentication — was among the first to be retired.

If you are still hitting logo.clearbit.com, you will receive either a 404 or a redirect to HubSpot's marketing page. Neither is a valid logo.

The good news: The LogoRouter API is URL-compatible with Clearbit. In most cases, you can migrate with a single find-and-replace in your codebase.

The 1-Line Migration

For the vast majority of use cases, migration is a single URL change:

// Clearbit (broken — returns 404)
const logoUrl = `https://logo.clearbit.com/${domain}`;

// LogoRouter (drop-in replacement)
const logoUrl = `https://img.logorouter.com/${domain}`;

That is it. Same domain input. Similar URL structure. No authentication required on the free tier. Your existing tags, CSS background-image properties, and Next.js Image components will work without modification.

Getting Your Free API Key

While LogoRouter works without an API key on the Community tier (up to 500K requests/month), adding one unlocks higher resolution images, dark mode variants, and removes rate limiting:

// Authenticated request (recommended)
const logoUrl = `https://img.logorouter.com/${domain}?token=YOUR_API_KEY`;

// Or via header (for server-side usage)
const response = await fetch(`https://img.logorouter.com/${domain}`, {
  headers: { 'x-api-key': process.env.LOGOROUTER_API_KEY }
});

Get your free API key — takes 30 seconds

Full Feature Comparison: Clearbit vs LogoRouter

Migrating at Scale: Find & Replace

If you have hundreds of references across a large codebase, use your IDE's global find-and-replace:

# Using sed on Unix/Mac
find . -type f -name "*.ts" -o -name "*.tsx" -o -name "*.js" | \
  xargs sed -i 's|logo.clearbit.com|img.logorouter.com|g'

# Or with ripgrep + sd
rg -l 'logo.clearbit.com' | xargs sd 'logo.clearbit.com' 'img.logorouter.com'

Handling Edge Cases

Custom Sizes

Clearbit supported a size parameter. LogoRouter uses the same parameter name:

// Clearbit
https://logo.clearbit.com/stripe.com?size=128

// LogoRouter (identical parameter)
https://img.logorouter.com/stripe.com?size=128

Fallback Handling

If a company logo is not in our database, LogoRouter returns a smart fallback rather than a 404. You can customize the fallback behavior:

// Custom fallback to a colored initial block
https://img.logorouter.com/unknown-startup.com?fallback=initials

// Transparent 1x1 pixel (to hide broken images silently)
https://img.logorouter.com/unknown-startup.com?fallback=empty

Dark Mode Support

Clearbit had no dark mode support. LogoRouter adds it with a single parameter:

// Force dark logo variant
https://img.logorouter.com/stripe.com?theme=dark

// Auto-detect based on prefers-color-scheme (CSS only)
// Use LogoRouter's CSS helper instead of <img>

What to Do Next

Your migration is done. While you are here, there are a few things worth enabling that Clearbit never offered:

• Brand Colors API — extract primary, secondary, and background colors for any company
• Webhook notifications — get notified when a company rebrands
• Bulk prefetching — preload logos for your entire customer list