Endpoint
Stuur een GET-verzoek met het domein als pad. De response body is de afbeelding zelf, dus je kunt de URL direct in een <img>-tag gebruiken.
https://favicon.is/{domain}<img src="https://favicon.is/github.com" width="32" height="32" alt="GitHub">Queryparameters
| Parameter | Type | Standaard | Beschrijving |
|---|---|---|---|
| size | integer | 128 | Icoongrootte in pixels. Een van 16, 32, 48, 64, 128 of 256; andere waarden worden afgerond naar de dichtstbijzijnde ondersteunde grootte.?size=64 |
| larger | boolean | false | Geeft een icoon in hoge resolutie terug (256 px). Gelijk aan size=256.?larger=true |
| original | boolean | false | Slaat de favicon-cache van Google over en leest het icoon dat in de eigen HTML van de website is opgegeven.?original=true |
| download | boolean | false | Stuurt een Content-Disposition-header mee, zodat browsers het icoon als bestand downloaden.?download=1 |
Geaccepteerde invoer
Je kunt een kaal domein, een subdomein, een volledige URL of een geïnternationaliseerde domeinnaam doorgeven. Protocollen, www., poorten, paden en querystrings worden automatisch verwijderd, en het domein is niet hoofdlettergevoelig.
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/例子.中国Domeinvalidatie met IANA-TLD’s
Favicon.is haalt alleen iconen op voor domeinen waarvan de extensie een topleveldomein is dat in de IANA Root Zone Database is gedelegeerd. Verzoeken voor andere extensies, zoals .local, .test of typefouten, krijgen meteen het standaardicoon, zonder dat er contact wordt gelegd met een server.
Alle ondersteunde TLD’s bekijkenResponse
Een geslaagd verzoek geeft HTTP 200 terug met de afbeelding (meestal PNG, soms ICO of SVG). Wordt er geen icoon gevonden, dan krijg je nog steeds HTTP 200 met het standaardicoon, zodat je pagina nooit een kapotte afbeelding toont.
$ 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: 3msResponseheaders
- Content-Type
- Het afbeeldingsformaat: image/png, image/x-icon, image/svg+xml, image/jpeg, image/gif of image/webp.
- Cache-Control
- Browsers en CDN’s mogen iconen één dag cachen en ze een week lang op de achtergrond opnieuw valideren.
- X-Source
- Waar het icoon vandaan komt: cache-edge, cache-r2, google, live of default.
- X-Reason
- Alleen bij het standaardicoon. Geeft de reden aan: invalid-domain, unsupported-tld, not-found of failure-cache.
- X-Response-Time
- Hoe lang het verzoek aan onze kant duurde.
- Access-Control-Allow-Origin
- Met Access-Control-Allow-Origin: * kun je iconen op een canvas tekenen of ze vanaf elke origin ophalen.
Caching en actualiteit
Elk icoon wordt opgeslagen in Cloudflare R2 en in de edge-cache van het datacenter dat het heeft geleverd. Herhaalde verzoeken duren meestal maar een paar milliseconden.
Opgeslagen iconen worden na zeven dagen op de achtergrond ververst. Verandert een site zijn logo, dan wordt dat automatisch bijgewerkt, zonder dat iemand er vertraging van merkt.
Heeft een site helemaal geen icoon, dan onthouden we dat resultaat een uur lang, zodat de site niet wordt bestookt met herhaalde zoekopdrachten.
Standaardicoon
Als er geen icoon beschikbaar is, geeft de API deze neutrale placeholder terug. Wil je dit detecteren, controleer dan of de X-Source-header de waarde default heeft.
$ curl -I https://favicon.is/example.invalid
HTTP/2 200
content-type: image/svg+xml
x-source: default
x-reason: unsupported-tldInspect-API (JSON)
De favicon-checker draait op een JSON-endpoint dat elk icoon opsomt dat een site declareert: link-tags, het webapp-manifest en /favicon.ico, inclusief de werkelijke afmetingen in pixels.
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 }
}Redelijk gebruik
Het afbeeldingsendpoint is gratis en heeft bij normaal gebruik geen harde limiet. De inspect-API is beperkt tot 30 verzoeken per minuut per IP-adres. Ben je van plan miljoenen verzoeken per dag te sturen, neem dan eerst contact met ons op.