Direct naar inhoud
Favicon.is

API-documentatie

Favicon.is is een eenvoudige HTTP-API die het favicon van elke website als afbeelding teruggeeft. Geen sleutels, geen SDK’s en geen rate-limit-headers om bij te houden.

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.

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

Queryparameters

ParameterTypeStandaardBeschrijving
sizeinteger128Icoongrootte in pixels. Een van 16, 32, 48, 64, 128 of 256; andere waarden worden afgerond naar de dichtstbijzijnde ondersteunde grootte.?size=64
largerbooleanfalseGeeft een icoon in hoge resolutie terug (256 px). Gelijk aan size=256.?larger=true
originalbooleanfalseSlaat de favicon-cache van Google over en leest het icoon dat in de eigen HTML van de website is opgegeven.?original=true
downloadbooleanfalseStuurt 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.

Voorbeeld
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 bekijken

Response

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
$ 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

Responseheaders

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
$ 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)

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.

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

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.