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>.
https://favicon.is/{domain}<img src="https://favicon.is/github.com" width="32" height="32" alt="GitHub">Parámetros de consulta
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| size | integer | 128 | Tamañ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 |
| larger | boolean | false | Devuelve un icono en alta resolución (256 px). Equivale a size=256.?larger=true |
| original | boolean | false | Omite la caché de favicons de Google y lee el icono declarado en el propio HTML del sitio web.?original=true |
| download | boolean | false | Enví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.
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 compatiblesRespuesta
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 -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: 3msCabeceras 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 -I https://favicon.is/example.invalid
HTTP/2 200
content-type: image/svg+xml
x-source: default
x-reason: unsupported-tldAPI 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.
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 }
}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.