get {favicon} offers an API that allows users to retrieve favicons from website URLs. Some API methods include retrieving favicons from specified websites, editing the format of the favicons, filtering the type of favicon returned, and retrieving image sources. This works better than Google Shared Stuff (S2) and other online favicon retrieval services.


{url} - required
Specify target url to get favicon. You can also specify multiple url by comma (,) separated. If you specify multiple url(s), the image will be combined based on {layout} and {format}.
{type} - optional
This parameter value should be 'all' (type=all). If you specify this attribute, all of the favicon(s) (which includes desktop, iOS version) will be combined based on {layout} and {format}.
{format} - optional
Specify the MIME type of favicon to be returned from the server. The supported formats are gif, png, jpeg, bmp & ico. Default will be 'ico' format.
{defaultIcon} - optional
Specify a default icon to be displayed if the favicon not found.
{layout} - optional
This parameter will be used only for multiple url/multiple favicons. The supported values are 'h' and 'v' (horizontal and vertical). Default will be 'horizontal' layout.
{includesocial} - optional
Specify the parameter value as 'true' to include facebook image or Open Graph protocol image. Default will be 'false'.
{filter} - optional
Specify which image/icon to be filter if the requested url has more images/icons. The supported values are:
  • shortcut icon - <link href="http://www.{your-website-url}/favicon.ico" rel="shortcut icon" />
  • icon - <link href="http://www.{your-website-url}/favicon.ico" rel="icon" />
  • image - <meta content="http://www.{your-website-url}/favicon.ico" itemprop="image" />
  • apple-touch-icon - <link href="http://www.{your-website-url}/favicon.png" rel="apple-touch-icon" />
  • apple-touch-icon-precomposed - <link href="http://www.{your-website-url}/favicon.png" rel="apple-touch-icon-precomposed" />
  • image_src - <link href="http://www.{your-website-url}/favicon.ico" rel="image_src" />
  • og:image - <meta content="http://www.{your-website-url}/favicon.ico" property="og:image" />
{width} - optional
Width of the image to render. (Ex: 16 or 16px)
{height} - optional
Height of the image to render. (Ex: 16 or 16px)

Performance (Look our test page with 1000 random website favicons):

To improve performance, can you also specify the sub-domain from a to z or 1 to 9 (NOTE: It should be one character). This will avoid browser connection limits and improve icon loading performance.(Refer Section 8.1.4 of the HTTP/1.1 RFC)