Favicon API & URL Guide

Plantillas de URL de favicon listas para copiar (basadas en servicios gratuitos).

Descripción general

Mzu favicondl proporciona plantillas de URL de favicon listas para copiar y una interfaz de extracción de favicons. Por defecto, utiliza un Cloudflare Worker para descubrir iconos reales y proxy de imágenes para descargas.

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

Find and download a usable favicon for a domain or 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í - The target domain or URL, e.g. example.com
size number No 128 The preferred icon size in pixels, clamped to 16-512
format string No redirect Use json for metadata; omit it for a downloadable image redirect

Detalles de parámetros:

url

Supports domains and full website URLs:

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

Preferred icon size, from 16 to 512 pixels:

  • • 16 - 16x16
  • • 32 - 32x32
  • • 128 - 128x128
  • • 512 - 512x512 when supported

Respuestas

Respuesta exitosa (formato JSON)

Respuesta JSON
{
  "ok": true,
  "domain": "example.com",
  "size": 128,
  "iconUrl": "https://example.com/favicon.svg",
  "proxyUrl": "https://favicondl.com/api/proxy?url=...",
  "source": "html"
}

Respuesta de error

Respuesta de error
{
  "success": false,
  "error": "Domain not found",
  "message": "Unable to find favicon for the specified domain",
  "code": 404,
  "timestamp": "2026-01-15T10:30:00Z"
}

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

Referencia directa HTML

HTML
<!-- 在HTML中直接引用favicon -->
<img src="https://favicondl.com/api/extract?url=example.com&size=32" alt="example.com favicon" width="32" height="32">

<!-- 使用大尺寸图标 -->
<img src="https://favicondl.com/api/extract?url=example.com&size=128" alt="example.com favicon" width="128" height="128">

<!-- 作为网站favicon -->
<link rel="icon" type="image/png" href="https://favicondl.com/api/extract?url=example.com&size=32">

Errores

La API devuelve el código de estado HTTP y mensaje de error correspondientes cuando ocurre un error.

Código de estado HTTP Código de error Descripción Solución
400 invalid_domain Formato de dominio inválido Verifica el formato del dominio y asegúrate de que sea válido
404 domain_not_found Dominio no encontrado Confirma que el dominio es correcto y el sitio web es accesible
404 favicon_not_found Favicon no encontrado El sitio web puede no tener un favicon configurado
429 rate_limit_exceeded Límite de solicitudes excedido Reduce la frecuencia de solicitudes e intenta más tarde
500 internal_error Error interno del servidor El servicio no está disponible temporalmente, intenta más tarde

Límites de uso

Gratis

Sin registro necesario, completamente gratis para usar todas las funciones

Límite de solicitudes

  • • Hasta 100 solicitudes por minuto
  • • Hasta 1000 solicitudes por hora
  • • Hasta 10000 solicitudes por día

Uso comercial

Se recomienda a los usuarios comerciales contactarnos para una cuota de uso mayor y soporte prioritario

¡Copiado!