Pular para o conteúdo
Favicon.is

Exemplos de integração

O Favicon.is funciona em qualquer lugar onde você possa usar uma URL de imagem. Escolha sua stack e copie o snippet.

HTML

O jeito mais simples: aponte uma tag <img> para a API. Adicione width e height para evitar mudanças de layout.

HTML
<img src="https://favicon.is/github.com" width="32" height="32" alt="GitHub" loading="lazy">

<!-- High resolution for retina screens -->
<img src="https://favicon.is/github.com?larger=true" width="64" height="64" alt="GitHub">

Markdown

Mostre o ícone de um site em arquivos README, documentações e anotações.

Markdown
![GitHub](https://favicon.is/github.com?size=32) [GitHub](https://github.com)

CSS

Use o ícone como imagem de fundo, por exemplo ao lado de links externos.

CSS
a[href^="https://github.com"]::before {
  content: "";
  display: inline-block;
  width: 1em;
  height: 1em;
  margin-right: 0.35em;
  vertical-align: -0.125em;
  background: url("https://favicon.is/github.com?size=32") center / contain no-repeat;
}

JavaScript

Adicione ícones a todos os links externos de uma página em tempo de execução.

JavaScript
document.querySelectorAll('a[href^="http"]').forEach((link) => {
  const { hostname } = new URL(link.href);
  const icon = document.createElement('img');
  icon.src = `https://favicon.is/${hostname}?size=32`;
  icon.width = icon.height = 16;
  icon.alt = '';
  icon.loading = 'lazy';
  icon.style.marginRight = '0.35em';
  link.prepend(icon);
});

React

Um pequeno componente reutilizável com fallback quando a imagem falha.

React
export function Favicon({ domain, size = 16 }) {
  return (
    <img
      src={`https://favicon.is/${domain}?size=${size * 2}`}
      width={size}
      height={size}
      alt=""
      loading="lazy"
      onError={(event) => {
        event.currentTarget.src = 'https://favicon.is/default-favicon.svg';
      }}
    />
  );
}

// <Favicon domain="github.com" />

Vue

O mesmo componente como single-file component do Vue.

Vue
<script setup>
defineProps({
  domain: { type: String, required: true },
  size: { type: Number, default: 16 },
});
</script>

<template>
  <img
    :src="`https://favicon.is/${domain}?size=${size * 2}`"
    :width="size"
    :height="size"
    alt=""
    loading="lazy"
  />
</template>

Python

Baixe ícones em um script, por exemplo para montar uma página de favoritos.

Python
import pathlib
import urllib.request

domains = ["github.com", "wikipedia.org", "python.org"]
out = pathlib.Path("icons")
out.mkdir(exist_ok=True)

for domain in domains:
    with urllib.request.urlopen(f"https://favicon.is/{domain}?larger=true") as response:
        ext = {"image/png": "png", "image/x-icon": "ico", "image/svg+xml": "svg"}.get(
            response.headers.get_content_type(), "img"
        )
        (out / f"{domain}.{ext}").write_bytes(response.read())
        print(domain, response.headers["X-Source"])

PHP

Renderize um ícone em um template no servidor.

PHP
<?php
$domain = parse_url($link, PHP_URL_HOST);
$src = 'https://favicon.is/' . rawurlencode($domain) . '?size=32';
?>
<img src="<?= htmlspecialchars($src) ?>" width="16" height="16" alt="">

Go

Busque um ícone e salve-o em disco.

Go
package main

import (
	"io"
	"net/http"
	"os"
)

func main() {
	resp, err := http.Get("https://favicon.is/go.dev?larger=true")
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	file, err := os.Create("go.dev.png")
	if err != nil {
		panic(err)
	}
	defer file.Close()

	if _, err := io.Copy(file, resp.Body); err != nil {
		panic(err)
	}
}

cURL

Confira os cabeçalhos de resposta pela linha de comando.

cURL
# Inspect the response headers
curl -I https://favicon.is/github.com

# Save a 64 px icon
curl -o github.png "https://favicon.is/github.com?size=64"