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.
https://favicon.is/{domain}<img src="https://favicon.is/github.com" width="32" height="32" alt="GitHub">Query-Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| size | integer | 128 | Icon-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 |
| larger | boolean | false | Gibt ein hochauflösendes Icon (256 px) zurück. Entspricht size=256.?larger=true |
| original | boolean | false | Überspringt den Favicon-Cache von Google und liest das Icon, das im HTML der Website selbst deklariert ist.?original=true |
| download | boolean | false | Sendet 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.
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 ansehenAntwort
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 -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: 3msResponse-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 -I https://favicon.is/example.invalid
HTTP/2 200
content-type: image/svg+xml
x-source: default
x-reason: unsupported-tldInspect-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.
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 }
}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.