免费 Favicon API - 即时获取任意网站图标

Q: Favicon.im API 真的免费吗？

是的，合理使用完全免费。我们每月处理 3000 万+ 请求，不收取任何费用。对于超大流量的企业使用，请联系我们。

Q: 需要 API 密钥吗？

不需要。只需构建 URL 并发出请求，立即可用。

Q: 如果网站没有 favicon 会怎样？

我们返回默认占位图标。您可以使用 default-avatar 参数自定义，或使用 throw-error-on-404 处理。

Q: Favicon 多久更新一次？

Favicon 缓存 24 小时。之后在下次请求时获取新版本。

Q: 可以在生产环境使用吗？

当然可以！我们有 99.9% 的可用性，每天处理数百万请求。许多生产应用依赖我们的 API。

Favicon.im 提供免费、可靠的 API 来获取任意网站的 favicon。无需 API 密钥，由 Cloudflare 全球边缘网络提供高速响应。

由 Cloudflare 驱动

30M+

月请求量

99.9%

可用性

<100ms

平均响应

快速开始

获取 favicon 只需构建一个 URL：

基本用法

https://favicon.im/{domain}

Example: https://favicon.im/github.com

更大尺寸（最高 256px）

https://favicon.im/{domain}?larger=true

Example: https://favicon.im/github.com?larger=true

立即尝试

https://favicon.im/github.com

API 参数

Parameter	Type	Description
`{domain}`	string	要获取 favicon 的网站域名（不含协议）
`larger`	boolean	设为 "true" 获取更大图标（最高 256px）
`default-avatar`	string (URL)	未找到 favicon 时重定向的 URL（需 URL 编码）
`throw-error-on-404`	boolean	未找到 favicon 时返回 HTTP 404（用于自定义降级处理）

代码示例

                    <img src="https://favicon.im/github.com" alt="GitHub favicon" loading="lazy" />

<!-- With larger size -->
<img src="https://favicon.im/github.com?larger=true" alt="GitHub favicon" />

<!-- With fallback -->
<img src="https://favicon.im/example.com"
     onerror="this.src='/fallback-icon.png'"
     alt="Website favicon" />
                

功能特点

无需 API 密钥

立即开始使用 - 无需注册，无需认证，毫无麻烦。

全球 CDN

Favicon 缓存并从全球边缘节点分发，快速交付。

智能降级

搜索多个来源：favicon.ico、HTML link 标签、Web Manifest、Apple Touch 图标。

自动优化

为您的请求返回最佳可用的 favicon 格式和尺寸。

支持 CORS

可直接在浏览器应用中使用，无需代理。

高可用性

99.9% 可用性，自动故障转移和冗余。

使用场景

链接预览

在应用或网站中显示链接的 favicon，提供更好的视觉上下文。

书签管理器

在书签列表中显示网站图标，便于快速识别。

浏览器扩展

在浏览器扩展中获取标签页、历史记录或书签的 favicon。

分析仪表盘

在分析和报告界面中显示客户/网站 logo。

CRM 系统

根据公司网站域名显示公司 logo。

社交媒体工具

通过视觉识别增强链接分享体验。

技术详情

响应格式

直接返回 favicon 图片，带有适当的 Content-Type 头（image/png、image/x-icon、image/svg+xml 等）

缓存

Favicon 缓存 24 小时。您可以直接热链接，无需在您的端进行缓存。

尺寸选项

默认返回标准 favicon（约 32px）。使用 larger=true 时，可返回最高 256px。

错误处理

未找到 favicon 时返回默认占位图标，如果设置了 throw-error-on-404 则返回 404。

最佳实践

✓ 在 img 标签上使用 loading="lazy" 属性，避免一次加载太多 favicon
✓ 为可访问性添加适当的 alt 文本（如 "GitHub 图标"）
✓ 考虑使用 onerror 处理程序自定义降级图片
✓ 对于 Next.js，将 favicon.im 添加到您的可信图片域配置中
✓ 对于高流量应用，本地缓存常用域名的响应

常见问题

Favicon.im API 真的免费吗？