{} Make Use More Simple.

The Most Simple Way to Get Website Favicons

Every website should have a favicon image, which shows on browser's tab and favorites.

For a website designer or site master, you'll want to add the favicon image before links. It makes website colorful, and improve readability and usability for your site.

This interface is born for that, use a simple and stable way to get favicon image.


  • Easy to use.
  • Server-side cache. It'll be faster if you have been visited that, without waiting.
  • Support HTTPS.
  • Support redirect.

This interface is not perfect. If you have any question, please leave me a message here or send me an email.


Use url query string is ok.





Parameters Description


Available domains

  • api.byi.pw/favicon
  • favicon.byi.pw


favicon.byi.pw doesn't support HTTPS!



The website URL you want get favicon image. It can be any accessible website URL.

Only support HTTP / HTTPS, schema is optional.

Change history

Current (v3.0)

  • 04/28/2017 Add English documents
  • 10/28/2016 Service move to JP, and served by docker
  • 11/19/2016 Rewrite system with NodeJS, and add HTTP/2 support
  • 11/20/2016 Optimize caching policy


  • 07/27/2016 Fix relative URL error (#5)
  • 05/30/2016 Fix error when URL start with "//"
  • 05/18/2016 The core module get-favicon opened its source on github and available on composer.
  • 04/10/2016 Rewrite system with laravel framework


  • 02/28/2015 Add API usage analytics
  • 11/27/2014 Change output type to "image/x-icon"
  • 11/24/2014 Fix unknown type of rel="icon" and "alternate icon"

10/20/2014 v2.1

  • Add a local cache map
  • Optimize cURL, fix redirect
  • Support HTTPS
  • Improve performance

09/28/2014 v2.0

  • Rewrite system with CodeIgniter
  • Change file cache to memcache
  • Change API host to api.byi.pw/favicon
  • Change file_get_contents to cURL

08/12/2014 v1.2

  • Move service to microsoft azure
  • Optimize get icon policy, and improve cache time calculation

06/17/2014 v1.1

  • Give up google's interface, and change to implement algorithm self
  • Add cache control, support force refresh cache

01/02/2014 v1.0

  • The first version online, using google's API interface and a local cache