Zum Inhalt springen
Favicon.is

API-Dokumentation

Favicon.is ist eine einfache HTTP-API, die das Favicon jeder Website als Bild zurückgibt. Keine Keys, keine SDKs und keine Rate-Limit-Header, um die du dich kümmern musst.

Endpunkt

Sende eine GET-Anfrage mit der Domain als Pfad. Der Response-Body ist das Bild selbst, du kannst die URL also direkt in einem <img>-Tag verwenden.

GEThttps://favicon.is/{domain}
Beispiel
<img src="https://favicon.is/github.com" width="32" height="32" alt="GitHub">
GitHub faviconGitHub favicon (256 px)

Query-Parameter

ParameterTypStandardBeschreibung
sizeinteger128Icon-Größe in Pixeln. Einer der Werte 16, 32, 48, 64, 128 oder 256; andere Werte werden auf die nächste unterstützte Größe gerundet.?size=64
largerbooleanfalseGibt ein hochauflösendes Icon (256 px) zurück. Entspricht size=256.?larger=true
originalbooleanfalseÜberspringt den Favicon-Cache von Google und liest das Icon, das im HTML der Website selbst deklariert ist.?original=true
downloadbooleanfalseSendet einen Content-Disposition-Header, damit Browser das Icon als Datei herunterladen.?download=1

Akzeptierte Eingaben

Du kannst eine reine Domain, eine Subdomain, eine vollständige URL oder einen internationalisierten Domainnamen übergeben. Protokolle, www., Ports, Pfade und Query-Strings werden automatisch entfernt, und bei der Domain spielt Groß- und Kleinschreibung keine Rolle.

Beispiel
https://favicon.is/github.com
https://favicon.is/docs.github.com
https://favicon.is/https://github.com/features/actions
https://favicon.is/WWW.GitHub.com:443
https://favicon.is/bücher.de
https://favicon.is/例子.中国

Domain-Validierung mit IANA-TLDs

Favicon.is ruft nur Icons für Domains ab, deren Endung eine in der IANA Root Zone Database delegierte Top-Level-Domain ist. Anfragen für andere Endungen wie .local, .test oder Tippfehler werden sofort mit dem Standard-Icon beantwortet, ohne einen Server zu kontaktieren.

Alle unterstützten TLDs ansehen

Antwort

Eine erfolgreiche Anfrage liefert HTTP 200 mit dem Bild (meist PNG, manchmal ICO oder SVG). Wird kein Icon gefunden, erhältst du trotzdem HTTP 200 mit dem Standard-Icon – so zeigt deine Seite nie ein kaputtes Bild.

cURL
$ curl -I https://favicon.is/github.com

HTTP/2 200
content-type: image/png
cache-control: public, max-age=86400, stale-while-revalidate=604800
access-control-allow-origin: *
etag: "8c1f3b6a2d4e5f60718293a4"
x-source: cache-r2
x-response-time: 3ms

Response-Header

Content-Type
Das Bildformat: image/png, image/x-icon, image/svg+xml, image/jpeg, image/gif oder image/webp.
Cache-Control
Browser und CDNs dürfen Icons einen Tag lang cachen und eine Woche lang im Hintergrund revalidieren.
X-Source
Woher das Icon stammt: cache-edge, cache-r2, google, live oder default.
X-Reason
Nur beim Standard-Icon. Nennt den Grund: invalid-domain, unsupported-tld, not-found oder failure-cache.
X-Response-Time
Wie lange die Anfrage auf unserer Seite gedauert hat.
Access-Control-Allow-Origin
Access-Control-Allow-Origin: * erlaubt es dir, Icons auf einem Canvas zu zeichnen oder sie von jedem Origin aus abzurufen.

Caching und Aktualität

Jedes Icon wird in Cloudflare R2 und im Edge-Cache des Rechenzentrums gespeichert, das es ausgeliefert hat. Wiederholte Anfragen dauern meist nur wenige Millisekunden.

Gespeicherte Icons werden nach sieben Tagen im Hintergrund aktualisiert. Ändert eine Website ihr Logo, wird das also automatisch übernommen, ohne dass jemand ausgebremst wird.

Hat eine Website gar kein Icon, merken wir uns dieses Ergebnis eine Stunde lang, damit sie nicht mit wiederholten Abfragen überlastet wird.

Standard-Icon

Wenn kein Icon verfügbar ist, gibt die API diesen neutralen Platzhalter zurück. Prüfe den X-Source-Header auf den Wert default, wenn du ihn erkennen möchtest.

cURL
$ curl -I https://favicon.is/example.invalid

HTTP/2 200
content-type: image/svg+xml
x-source: default
x-reason: unsupported-tld

Inspect-API (JSON)

Der Favicon-Checker basiert auf einem JSON-Endpunkt, der jedes Icon auflistet, das eine Website deklariert: Link-Tags, das Web-App-Manifest und /favicon.ico, inklusive der tatsächlichen Pixelmaße.

JSON
GET https://favicon.is/api/inspect?domain=github.com

{
  "domain": "github.com",
  "url": "https://github.com/",
  "title": "GitHub · Build and ship software on a single, collaborative platform",
  "reachable": true,
  "icons": [
    {
      "href": "https://github.githubassets.com/favicons/favicon.svg",
      "rel": "icon",
      "type": "image/svg+xml",
      "source": "link",
      "ok": true,
      "contentType": "image/svg+xml",
      "width": 32,
      "height": 32
    }
  ],
  "manifest": { "href": "https://github.com/manifest.json", "ok": true, "icons": [ … ] },
  "checks": { "ico": true, "svg": true, "appleTouch": true, "manifest": true, "large": true }
}
Favicon-Checker

Faire Nutzung

Der Bild-Endpunkt ist kostenlos und hat bei normaler Nutzung kein festes Limit. Die Inspect-API ist auf 30 Anfragen pro Minute und IP-Adresse begrenzt. Wenn du Millionen Anfragen pro Tag senden möchtest, melde dich bitte vorher bei uns.