Quickstart
Holen Sie sich ein sauberes, proportionsgerechtes Logo für jede Domain in einer HTTP-Anfrage.
Ersetzen Sie die Clearbit Logo API?
Beginnen Sie mit dem Migrationsleitfaden, testen Sie dann ein paar Domains live.
Ehemalige Clearbit-Nutzer benötigen in der Regel nicht „eine weitere Logo-Dateiquelle", sondern einen verwertbaren Output in der UI. Diese beiden Leitfäden bringen Sie schneller ans Ziel.
ClearLogo ist eine HTTP-API, die für jede Domain ein sauberes, proportionsgerechtes Logobild als opakes Quadrat auf einem themengerechten Hintergrund (weiß für hell, ein dunkles Neutral für dunkel) über eine einzelne GET-Anfrage zurückgibt. Für geringes Volumen ist keine Anmeldung erforderlich; Produktionsverkehr verwendet einen Browser- oder Server-Schlüssel.
1. Testen ohne Schlüssel
Der Endpoint ist für geringes Volumen offen. Geben Sie eine Domain ein und Sie erhalten sofort eine PNG zurück.
GET https://api.clearlogo.dev/logo/github.com?size=128&frame=fill&padding=10
Oder fügen Sie sie direkt in HTML ein:
<img src="https://api.clearlogo.dev/logo/github.com?size=64&frame=fill&padding=10" alt="GitHub" />
2. Schlüssel für die Produktion abrufen
Erstellen Sie einen vom Dashboard. Wählen Sie einen Modus basierend darauf, wo die Anfrage ausgeführt wird:
- Browser-Schlüssel — Fügen Sie ihn direkt in
<img>-Tags ein. Aufrufe werden gegen die auf dem Schlüssel zulässigen Domains überprüft. - Server-Schlüssel — Senden Sie ihn als
Authorization: Bearer …. Behalten Sie ihn in Ihrem Backend — versenden Sie ihn niemals an einen Browser.
Melden Sie sich an, um einen Schlüssel zu erstellen
3. Die Ausgabe anpassen
Einige Regler steuern die meisten Ergebnisse: size, frame (fill füllt die Canvas, original bewahrt die ursprüngliche Rahmung des Quell-Icons), padding (Rand je Seite), shape (square oder circle) und theme (helle oder dunkle Variante, die auch die Farbe des opaken Hintergrunds bestimmt). Öffnen Sie den Playground, um Kombinationen in der Vorschau anzusehen, bevor Sie die endgültige URL kopieren.
Nächste Schritte
- Playground — Testen Sie alle Optionen live und kopieren Sie die genaue URL, die Sie verwenden werden.
- API-Schlüssel abrufen — Melden Sie sich an und erstellen Sie einen öffentlichen oder privaten Schlüssel für Produktionsverkehr.
- API-Referenz — Sehen Sie den Endpoint, Parameter, Authentifizierungsmodi und das Rate-Limit-Verhalten.