Saltar al contenido
Favicon.is

Documentación de la API

Favicon.is es una API HTTP sencilla que devuelve el favicon de cualquier sitio web como imagen. Sin claves, sin SDK y sin cabeceras de límite de solicitudes que gestionar.

Endpoint

Envía una solicitud GET con el dominio como ruta. El cuerpo de la respuesta es la propia imagen, así que puedes usar la URL directamente en una etiqueta <img>.

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

Parámetros de consulta

ParámetroTipoPredeterminadoDescripción
sizeinteger128Tamaño del icono en píxeles: 16, 32, 48, 64, 128 o 256. Los demás valores se redondean al tamaño compatible más cercano.?size=64
largerbooleanfalseDevuelve un icono en alta resolución (256 px). Equivale a size=256.?larger=true
originalbooleanfalseOmite la caché de favicons de Google y lee el icono declarado en el propio HTML del sitio web.?original=true
downloadbooleanfalseEnvía una cabecera Content-Disposition para que los navegadores descarguen el icono como archivo.?download=1

Entradas aceptadas

Puedes pasar un dominio sin más, un subdominio, una URL completa o un nombre de dominio internacionalizado. Los protocolos, www., puertos, rutas y cadenas de consulta se eliminan automáticamente, y el dominio se compara sin distinguir entre mayúsculas y minúsculas.

Ejemplo
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/例子.中国

Validación de dominios con los TLD de IANA

Favicon.is solo obtiene iconos de dominios cuyo sufijo es un dominio de nivel superior delegado en la base de datos de la zona raíz de IANA. Las solicitudes con otros sufijos, como .local, .test o errores tipográficos, reciben al instante el icono predeterminado, sin contactar con ningún servidor.

Ver todos los TLD compatibles

Respuesta

Una solicitud correcta devuelve HTTP 200 con la imagen (normalmente PNG, a veces ICO o SVG). Si no se encuentra ningún icono, igualmente recibes HTTP 200 con el icono predeterminado, así que tu página nunca muestra una imagen rota.

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

Cabeceras de respuesta

Content-Type
El formato de la imagen: image/png, image/x-icon, image/svg+xml, image/jpeg, image/gif o image/webp.
Cache-Control
Los navegadores y las CDN pueden almacenar los iconos en caché durante un día y revalidarlos en segundo plano durante una semana.
X-Source
De dónde procede el icono: cache-edge, cache-r2, google, live o default.
X-Reason
Solo en el icono predeterminado. Explica el motivo: invalid-domain, unsupported-tld, not-found o failure-cache.
X-Response-Time
Cuánto tardó la solicitud en nuestro lado.
Access-Control-Allow-Origin
Access-Control-Allow-Origin: * te permite dibujar iconos en un canvas u obtenerlos desde cualquier origen.

Caché y actualización

Cada icono se guarda en Cloudflare R2 y en la caché edge del centro de datos que lo sirvió. Las solicitudes repetidas suelen tardar unos pocos milisegundos.

Los iconos guardados se actualizan en segundo plano a los siete días, así que, si un sitio cambia su logotipo, se actualiza automáticamente sin ralentizar a nadie.

Cuando un sitio no tiene ningún icono, ese resultado se recuerda durante una hora para no saturarlo con búsquedas repetidas.

Icono predeterminado

Cuando no hay ningún icono disponible, la API devuelve este marcador neutro. Si quieres detectarlo, comprueba si la cabecera X-Source tiene el valor default.

cURL
$ curl -I https://favicon.is/example.invalid

HTTP/2 200
content-type: image/svg+xml
x-source: default
x-reason: unsupported-tld

API de inspección (JSON)

El comprobador de favicons funciona con un endpoint JSON que enumera todos los iconos que declara un sitio: etiquetas link, el manifiesto de la aplicación web y /favicon.ico, con sus dimensiones reales en píxeles.

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 }
}
Comprobador de favicon

Uso razonable

El endpoint de imágenes es gratuito y no tiene un límite estricto para un uso normal. La API de inspección está limitada a 30 solicitudes por minuto por dirección IP. Si piensas enviar millones de solicitudes al día, ponte en contacto con nosotros antes.