API de favicon gratuita

Obtén el favicon de cualquier web por URL con una sola petición GET. Sin clave de API ni registro.

Inicio rápido

La API de favicons de favicondl convierte cualquier dominio o URL en su favicon con una sola petición GET. Sin clave de API, sin cuenta y sin SDK. Pasa size con uno de estos valores: 16, 32, 48, 64, 128, 180, 192, 256 o 512, para obtener un PNG cuadrado de ese tamaño. Cualquier otro número se ajusta al más cercano (en empate, el menor):

<img src="https://favicondl.com/api/extract?url=github.com&size=32" width="32" height="32" alt="Favicon de GitHub">

Omite size para recibir el archivo original. Un raster más pequeño se amplía y puede verse borroso. Un SVG se rasteriza al tamaño pedido. Las cabeceras X-Favicon-Native-Size y X-Favicon-Upscaled de la imagen indican cuándo ocurrió.

O pide JSON para ver qué archivo se encontró y de dónde procede:

curl "https://favicondl.com/api/extract?url=github.com&format=json"
curl "https://favicondl.com/api/extract?url=github.com&size=32&format=json"
{
  "ok": true,
  "domain": "github.com",
  "size": null,
  "resized": false,
  "upscaled": false,
  "vector": true,
  "nativeWidth": null,
  "nativeHeight": null,
  "iconUrl": "https://github.githubassets.com/favicons/favicon.svg",
  "proxyUrl": "https://favicondl.com/api/proxy?url=https%3A%2F%2Fgithub.githubassets.com%2Ffavicons%2Ffavicon.svg",
  "source": "html",
  "rel": "icon",
  "format": "svg",
  "width": null,
  "height": null,
  "pageUrl": "https://github.com/",
  "candidates": [
    { "url": "https://github.githubassets.com/favicons/favicon.svg", "format": "svg", "vector": true, "source": "html", "rel": "icon", "proxyUrl": "…" },
    { "url": "https://github.githubassets.com/assets/app-icon-512-7f9c4ff2e960.png", "format": "png", "width": 512, "height": 512, "source": "manifest", "rel": "manifest", "proxyUrl": "…" },
    { "url": "https://github.com/favicon.ico", "format": "ico", "width": 32, "height": 32, "source": "direct", "rel": "favicon.ico", "proxyUrl": "…" }
  ]
}

iconUrl es el archivo original del sitio. proxyUrl es la imagen que hay que descargar: el archivo original si omites size, o un PNG cuadrado exacto (por ejemplo &size=32) si lo indicas. Incluye Access-Control-Allow-Origin: *.

width y height son el origen medido (null en SVG). Con size, outputWidth y outputHeight coinciden con él, nativeWidth / nativeHeight son los píxeles de origen, y upscaled es true solo cuando un raster se amplió: ese PNG puede verse borroso. candidates lista hasta 8 iconos verificados más. Queda vacío si hubo que recurrir a Google o DuckDuckGo.

Cómo elige la API el icono

  1. La página de inicio se solicita como lo haría un navegador normal, siguiendo las redirecciones (incluido www ↔ dominio sin www). Se leen todos los <link> de iconos: icon, shortcut icon, apple-touch-icon, apple-touch-icon-precomposed y mask-icon. Los enlaces relativos y los relativos al protocolo (//cdn…) se resuelven respecto a la URL final de la página o a su etiqueta <base> (source: "html").
  2. El manifiesto de la aplicación web enlazado desde la página se abre para leer su lista de iconos, que suele ser donde están los de 192 y 512 px (source: "manifest").
  3. Las rutas habituales /favicon.ico y /apple-touch-icon.png también se prueban (source: "direct").
  4. Cada candidato se descarga y se comprueba: los bytes deben ser realmente una imagen (PNG, ICO, SVG, WebP, JPEG, GIF…) y medimos su tamaño real en píxeles en lugar de fiarnos del nombre del archivo.
  5. El servicio de favicons de Google y, después, DuckDuckGo solo se usan si nada del propio sitio funciona, con el size que pidas (source: "google_s2" o "duckduckgo").

Los candidatos verificados se ordenan para que gane el archivo más nítido: primero un SVG a todo color y después el PNG/ICO/WebP cuadrado más grande. El mask-icon monocromo de Safari y los iconos del manifiesto marcados solo como maskable quedan más abajo porque no se parecen al favicon normal. Esa fuente se redimensiona a uno de 16, 32, 48, 64, 128, 180, 192, 256 o 512 (cualquier otro número se ajusta al más cercano). Omite size para conservar el archivo original. La reducción usa Lanczos, la ampliación un remuestreo de alta calidad, los iconos no cuadrados se rellenan con transparencia y el SVG se rasteriza al tamaño pedido. Un raster ampliado puede verse borroso; la respuesta no lo presenta como un original nítido.

Si obtienes google_s2, el sitio no tiene ningún icono al que podamos llegar o ha bloqueado nuestra petición (por ejemplo, con una página de verificación anti-bots). Para un solo sitio, el descargador de favicons de nuestra página de inicio prueba además algunas fuentes extra directamente desde tu navegador y muestra todos los tamaños encontrados para que elijas uno.

Comparativa de APIs de favicon: favicondl frente a Google S2, DuckDuckGo e Icon Horse

Los cuatro servicios se pueden empezar a usar gratis y no necesitan clave de API. Se diferencian en lo que devuelven:

favicondlGoogle S2DuckDuckGoIcon Horse
Endpoint/api/extract?url=example.comgoogle.com/s2/favicons?domain=example.com&sz=64icons.duckduckgo.com/ip3/example.com.icoicon.horse/icon/example.com
Clave de APINoNoNoNo (plan gratuito)
Cuota gratuita publicadaNinguna (uso razonable)No publicadaNo publicada1.000 iconos al mes en el plan gratuito
Parámetro de tamañosize 16, 32, 48, 64, 128, 180, 192, 256 o 512. Los demás números se ajustan al más cercano. Omítelo para el archivo original.szNoNo documentado
Qué devuelveUn PNG cuadrado exacto si se indica size; si no, el archivo original (SVG, PNG, ICO…)PNG o JPEG (observado)ICO (observado)PNG (observado)
Metadatos JSONSí (format=json: URL del icono, origen, formato, tamaño medido en píxeles y hasta 8 iconos alternativos)NoNoNo
Resultado para github.com en nuestra pruebafavicon.svg (vectorial)PNG de 16×16 con sz=16, 180×180 con sz=256ICO con 16×16 y 32×32PNG de 256×256

Los resultados proceden de nuestras propias peticiones del 12 de octubre de 2026; la cuota de Icon Horse está tomada de su sección de precios. Los servicios de terceros pueden cambiar en cualquier momento, así que revisa las condiciones de cada proveedor antes de depender de ellos en producción.

Descripción general

Mzu favicondl ofrece plantillas de URL de favicon listas para copiar y una interfaz para extraer favicons. Su propia API de extracción encuentra los iconos reales que publica un sitio web, y un proxy de imágenes permite descargarlos desde código del navegador.

Rápido

Obtención optimizada para vista previa rápida

Gratis

Sin registro necesario

Confiable

Diseñado para alta disponibilidad

Autenticación

Este proyecto utiliza plantillas de URL de servicios de favicon gratuitos, no se requiere autenticación ni API Key.

Nota: Aunque no requerimos API Key, por favor usa el servicio de manera razonable para evitar solicitudes excesivas.

Endpoints

GET FaviconDL Extract API

Encuentra y descarga un favicon utilizable para un dominio o una URL

URL base:

https://favicondl.com/api/extract

Ejemplo completo:

https://favicondl.com/api/extract?url=example.com&size=128

Parámetros

Nombre del parámetro Tipo Requerido Valor predeterminado Descripción
url string Sí - El dominio o la URL de destino, p. ej. example.com
size number No ninguno (archivo original) Solo 16, 32, 48, 64, 128, 180, 192, 256 o 512. Cualquier otro número se ajusta al tamaño permitido más cercano (en empate, el menor) y la petición redirige a esa URL. Omite size para el archivo original. Un valor que no es un número devuelve 400. Un raster más pequeño se amplía y puede verse borroso; un SVG se rasteriza al tamaño ajustado.
format string No redirect Usa json para obtener metadatos; omítelo para recibir una redirección a la imagen descargable

Detalles de parámetros:

url

Admite dominios y URL completas de sitios web:

  • • example.com
  • • www.example.com
  • • https://example.com/docs
  • • sub.example.com
size

PNG cuadrado de uno de los tamaños de abajo. Cualquier otro número se ajusta al más cercano. Omítelo para el archivo original.

  • • 16 - 16x16
  • • 32 - 32x32
  • • 48 - 48x48
  • • 64 - 64x64
  • • 128 - 128x128
  • • 180 - 180x180
  • • 192 - 192x192
  • • 256 - 256x256
  • • 512 - 512x512

Solo se leen url (domain sigue valiendo como alias), size y format. Cualquier otro parámetro se ignora. El host pasa a minúsculas, se asume https, se quita un www. inicial y la barra final. Una petición que no esté ya así redirige con 308 a la URL estable, que es la que guarda la CDN. /api/proxy conserva www y la ruta de la imagen, porque identifican el archivo.

Respuestas

Respuesta exitosa (formato JSON)

Respuesta JSON
{
  "ok": true,
  "domain": "example.com",
  "size": 32,
  "resized": true,
  "outputFormat": "png",
  "outputWidth": 32,
  "outputHeight": 32,
  "upscaled": false,
  "nativeWidth": null,
  "nativeHeight": null,
  "vector": true,
  "iconUrl": "https://example.com/favicon.svg",
  "proxyUrl": "https://favicondl.com/api/proxy?url=...&size=32",
  "source": "html",
  "rel": "icon",
  "format": "svg",
  "width": null,
  "height": null,
  "pageUrl": "https://example.com/",
  "candidates": [ ... ]
}

Respuesta de error

Respuesta de error
{
  "ok": false,
  "error": "Missing url"
}

Nota: Cuando se usa format=redirect, la API redirige directamente a la URL del favicon sin devolver una respuesta JSON.

Ejemplos

JavaScript (Fetch)

JavaScript
async function getFavicon(url, size = 128) {
  const endpoint = new URL('https://favicondl.com/api/extract');
  endpoint.searchParams.set('url', url);
  endpoint.searchParams.set('size', String(size));
  const response = await fetch(endpoint);
  if (!response.ok) throw new Error(`Favicon request failed: ${response.status}`);
  return await response.blob();
}

const icon = await getFavicon('example.com', 128);
const imageUrl = URL.createObjectURL(icon);
document.querySelector('#favicon-preview').src = imageUrl;

Python (Requests)

Python
import requests

def get_favicon(url: str, size: int = 128) -> bytes:
    response = requests.get(
        "https://favicondl.com/api/extract",
        params={"url": url, "size": size},
        timeout=15,
    )
    response.raise_for_status()
    return response.content

icon_bytes = get_favicon("example.com", 128)
with open("example-favicon", "wb") as output:
    output.write(icon_bytes)

PHP (cURL)

PHP
<?php
function getFavicon(string $url, int $size = 128): string {
    $endpoint = 'https://favicondl.com/api/extract?url=' . urlencode($url) . '&size=' . $size;
    $context = stream_context_create(['http' => ['follow_location' => 1, 'timeout' => 15]]);
    $icon = file_get_contents($endpoint, false, $context);
    if ($icon === false) {
        throw new RuntimeException('Favicon request failed');
    }
    return $icon;
}

file_put_contents('example-favicon', getFavicon('example.com', 128));
?>

Referencia directa HTML

HTML
<!-- Exact 32×32 PNG. Allowed: 16, 32, 48, 64, 128, 180, 192, 256, 512. Other numbers snap to the nearest. -->
<img src="https://favicondl.com/api/extract?url=example.com&size=32" alt="example.com favicon" width="32" height="32">

<!-- Omit size for the original file. Small rasters requested above native size may look soft. -->
<img src="https://favicondl.com/api/extract?url=example.com" alt="example.com favicon">

Errores

Los errores devuelven un código de estado HTTP y un JSON breve con ok en false y un mensaje de error.

Código de estado HTTP Mensaje de error Descripción Solución
400 Missing url No se envió el parámetro url ni domain Añade ?url=example.com a la solicitud
400 Invalid format format no es json ni redirect Usa format=json u omítelo para obtener una redirección
400 Invalid domain El valor no se pudo interpretar como un nombre de host Envía un dominio como example.com o una URL https:// completa
405 Method not allowed Solo se admiten solicitudes GET Envía una solicitud GET
502 Favicon extraction failed El extractor no pudo devolver un icono Inténtalo más tarde
415 Target is not an image Solo en /api/proxy: la URL no devolvió datos de imagen reales Usa un iconUrl o candidates[].url devuelto por /api/extract

OpenAPI spec and MCP server

  • OpenAPI 3 spec: https://favicondl.com/openapi.yaml — import it into Postman, Insomnia or a client generator.
  • MCP server: favicondl MCP (registry name io.github.sweesama/favicondl) exposes an extract_favicon tool so Claude, Cursor and other MCP clients can fetch icons.

Límites de uso

Gratis

Sin registro necesario, completamente gratis para usar todas las funciones

Uso razonable

  • • No hay API key ni una cuota fija publicada
  • • Los iconos encontrados en el sitio se guardan en caché en el edge 24 horas; los resultados de Google/DuckDuckGo, 10 minutos
  • • Guarda en caché los iconos por tu cuenta y evita el rastreo masivo

Uso comercial

No hay plan de pago ni SLA. Para un uso intensivo o crítico, guarda los iconos que necesites en tu propio almacenamiento.

¡Copiado!