API

Fetch ICO favicons with a single call

FaviconKit keeps things simple: one endpoint, lightning-fast ICO responses, and sensible fallbacks so you never ship an empty favicon slot again.

curl request Typical latency < 100 ms
curl "https://ico.faviconkit.net/favicon/example.com?sz=64"
  --header "Accept: image/x-icon"
  --output example.ico

Endpoint structure

Pick the size you need (16-256) and we’ll return a polished ICO file, complete with embedded sizes for broad compatibility.

  • ICO delivery: https://ico.faviconkit.net/favicon/{domain}?sz={16-256}
  • Automatic fallbacks: root favicon paths, HTML metadata, and DNS checks keep results consistent.
  • Content type: image/x-icon for plug-and-play browser support.

Implementation tips

  • Cache for 24 hours

    Respect our cache headers to avoid unnecessary requests and guarantee instant loads for your users.

  • Validate domains

    Clean user input before calling the API to prevent typos or unsupported characters from reaching production.

  • Handle 4xx gracefully

    Fallback to letter avatars or placeholders if a favicon cannot be fetched. Our status codes make it easy to branch.

Need custom ICO coverage?

We provide tailored support for large imports, strict compliance workflows, and partner integrations. Tell us what you need and we’ll craft the right approach.