Why This Exists
On December 8, 2025, Clearbit (now owned by HubSpot) permanently shut down its free Logo API. Thousands of apps, dashboards, CRMs, and websites that used logo.clearbit.com/domain.com to display company logos lost their image source overnight.
Open Logo API is the fix. Upload it to any PHP server — shared hosting, a VPS, or a dedicated box — and you have your own logo API that works exactly the same way. You own the server, the cache, and the data. No vendor lock-in, no usage fees, no surprise shutdowns.
| Clearbit Logo API | Logo.dev | Open Logo API | |
|---|---|---|---|
| Price | Was free → Dead | Free tier (limited) | Free forever |
| Self-hosted | No | No | Yes |
| Data stays on your server | No | No | Yes |
| Rate limits | N/A | Limited | You control |
| Vendor dependency | Shut down | Third party | None |
| Setup time | N/A | ~5 min | ~5 min |
Features
Multi-Strategy Scraping
Parses HTML for apple-touch-icon, og:image, link[rel=icon], tries well-known paths, falls back to Google & DuckDuckGo favicon services.
Local Caching
Logos cached as PNG on your server. Re-scraped automatically after 6 months (configurable 1–24 months). Known misses tracked to avoid re-scraping.
REST API + CORS
Any site or app can call your API. CORS enabled by default. Works as an img src, from JavaScript fetch(), PHP, Python, cURL — anything.
Clearbit-Compatible URL
/d/github.com path format mirrors Clearbit's URL pattern. Find-and-replace migration takes 30 seconds.
your server Shortcode
[logo domain="github.com"] — use in any post, page, or widget. Size, class, link, alt, and fallback options included.
Rate Limiting & Auth
Configurable per-IP rate limit. Optional API key requirement for private deployments. Admin dashboard with cache stats & browser.
Quick Start
Step 1. Download and upload to your server. Point your domain to the /public directory.
Step 2. Make the /cache directory writable. Visit /admin to configure (default password: changeme).
Step 3. Use it:
<!-- Direct in any HTML -->
<img src="https://yoursite.com/logo/github.com" alt="GitHub" />
<!-- your server shortcode -->
[logo domain="github.com" size="64"]
<!-- JavaScript -->
const logo = `https://yoursite.com/logo/${domain}`;
<!-- JSON metadata -->
fetch(`https://yoursite.com/api/logo?domain=github.com&format=json`)
.then(r => r.json()) // { domain, found, url, cached, fetched_at }Migrating from Clearbit
Find and replace one string in your codebase:
// Before (dead)
https://logo.clearbit.com/github.com
// After (your server)
https://yoursite.com/logo/github.comThat's it. Same URL pattern, same behavior, your infrastructure.
Deploying on a Subdomain
Set up on a subdomain (e.g. api.yoursite.com) purely to run this plugin, then point your app's logo URLs to it. This works for React, Next.js, Vue, Laravel, Django, Rails, Go, static sites — anything that can load an <img> or make an HTTP request.
# Example: cheap $5/mo VPS or shared hosting
api.yoursite.com ← your server + Open Logo API plugin
yoursite.com ← Your React/Next.js/Laravel app
# Your app just uses img tags:
<img src="https://api.yoursite.com/logo/stripe.com" />API Reference
GET /api/logo
Query parameter style. Returns PNG image bytes by default, or JSON with ?format=json.
GET /logo/{domain}
Clearbit-compatible path style. Always returns PNG image bytes.
GET /api/status
Health check. Returns JSON with cache stats and endpoint URLs.
Parameters
domain (required) — company domain, e.g. github.com. Protocol and www. stripped automatically.
format — image (default) or json
size — requested size hint, 16–512
api_key — required only if key auth is enabled in settings
Response Headers
X-Logo-Source: fresh | cache | not-found — tells you if the logo was just scraped or served from cache.
Cache-Control: public, max-age=2592000 — 30-day browser cache.
Access-Control-Allow-Origin: * — when CORS is enabled.
Requirements
PHP 7.4+ with GD library, Apache (mod_rewrite) or Nginx, writable /cache directory. No database. No Composer. No npm. No your server. No framework dependencies.
License
GPLv2 or later. Free to use, modify, and distribute. Built by Max Intel.