Migrating from Clearbit
Clearbit's Logo API was sunset on December 8, 2025. BrandQL works as a drop-in replacement. Same idea, different URL.
Quick Start
In most cases, migrating is as simple as changing the base URL. Here's a side-by-side comparison:
https://logo.clearbit.com/stripe.comhttps://api.brandql.com/logo/stripe.com That's it. Drop the new URL into your <img> tag and you're done.
Key Differences
The API works similarly to Clearbit's. Here's what's different.
| Feature | Clearbit | BrandQL |
|---|---|---|
| Base URL | logo.clearbit.com | api.brandql.com/logo |
| Formats | PNG only | SVG, PNG, WebP |
| Format parameter | N/A | ?format=svg |
| Variants parameter (dark, light, transparent, svg) | N/A | ?variant=light |
| Fallback | Letter initials | Configurable (coming soon) |
| Speed | fast | good (will improve) |
| CDN | probably awesome | Cloudflare |
| Status | Sunset Dec 2025 | Active development |
Step-by-Step Migration
Update the base URL
Find all references to logo.clearbit.com in your codebase and replace with api.brandql.com/logo.
// Before
const logoUrl = `https://logo.clearbit.com/${domain}`
// After
const logoUrl = `https://api.brandql.com/logo/${domain}`Add authentication (optional)
BrandQL works without authentication for basic usage. For higher rate limits and usage tracking, add your API key as a header.
// Optional: Add API key for higher limits
fetch(`https://api.brandql.com/logo/${domain}`, {
headers: {
'Authorization': `Bearer ${apiKey}`
}
})Test with a few domains
Verify that logos render correctly for your most common domains. BrandQL's scraper discovers logos from multiple sources (favicons, OG images, apple-touch-icons, inline SVGs) and selects the highest quality option.
Customize format and size (optional)
Unlike Clearbit, BrandQL supports SVG and WebP formats. Add query parameters to customize the output.
// PNG at 128px (default behavior, same as Clearbit)
https://api.brandql.com/logo/stripe.com?size=128
// SVG (if available, best quality)
https://api.brandql.com/logo/stripe.com?format=svg
// WebP at 256px (smaller file size)
https://api.brandql.com/logo/stripe.com?format=webp&size=256Frequently Asked Questions
What are the rate limits?
Unauthenticated requests are limited to 100 requests per minute per IP. With an API key, you get higher limits based on your plan. Check the documentation for details.
Is there a free tier?
Yes. There's a free tier. Use the API without authentication for basic usage, or sign up for higher limits and usage tracking.
What if a logo isn't found?
BrandQL will attempt to scrape the domain on-demand if a logo isn't already cached. If no logo can be found, the API returns a 404. Fallback images (like letter initials) are on the roadmap.
How fresh is the logo data?
Logos are cached after the first fetch. The cache is refreshed periodically, and you can request a fresh scrape via the API if needed. Most logos don't change frequently, so caching provides fast response times.
Do you support all the same domains as Clearbit?
Honestly, not yet. Clearbit had years and a large team to build their database. BrandQL is a solo project, still early. But the scraper fetches logos on-demand from live websites, so if a domain has a logo, we can usually find it. Coverage grows with every request.
Can I use BrandQL in production?
Yes. BrandQL is production-ready and serves logos via Cloudflare's global CDN. The service is built and maintained by an active developer who relies on it for his own SaaS products.
Ready to migrate?
Get started in minutes. No credit card required for the free tier.