Quickstart
Get a clean, ratio-fit logo for any domain in one HTTP request.
Replacing Clearbit Logo API?
Start with the migration guide, then test a few domains live.
Former Clearbit users usually do not need "another logo file source" as much as they need usable output in the UI. These two guides get you there fastest.
ClearLogo is an HTTP API that returns a clean, ratio-fit logo image for any domain via a single GET request. The output is an opaque square on a theme-matched background (white for light, a dark neutral for dark). No login is required for low-volume browsing; production traffic uses a browser key or a server key.
1. Try without a key
The endpoint is open for low-volume browsing. Drop in a domain and you get a PNG back immediately.
GET https://api.clearlogo.dev/logo/github.com?size=128&frame=fill&padding=10
Or drop it straight into HTML:
<img src="https://api.clearlogo.dev/logo/github.com?size=64&frame=fill&padding=10" alt="GitHub" />
2. Get a key for production
Create one from the dashboard. Pick a mode based on where the request runs:
- Browser key — Drop it straight into
<img>tags. Calls are checked against the domains you allow on the key. - Server key — Send it as
Authorization: Bearer …. Keep it in your backend — never ship it to a browser.
3. Tune the output
A few knobs control most results: size, frame (fill fills the canvas, original preserves the source icon's framing), padding (margin per side), shape (square or circle), and theme (light or dark variant, which also sets the opaque background color). Open the playground to preview combinations before you copy the final URL.
Next steps
- Playground — Try every option live and copy the exact URL you'll ship.
- Get an API key — Sign in and create a public or secret key for production traffic.
- API reference — See the endpoint, parameters, auth modes, and rate-limit behavior.