Favicon API

免费、无需 API key 的 Favicon URL 服务。可直接在 <img> 标签里热链任意网站的图标,也可编程调用——由 CDN 缓存加速。

接口

GET https://favicon.run/favicon

参数

domain
必填。网站主机名或完整网址,如 github.com 或 https://github.com/path,会自动归一化为主机名。
sz
可选。图标像素尺寸,限制在 16–512 之间,默认 32。

请求示例

https://favicon.run/favicon?domain=github.com&sz=128

使用方式

HTML
<img src="https://favicon.run/favicon?domain=github.com&sz=128" alt="GitHub" width="32" height="32" />
JavaScript
const res = await fetch("https://favicon.run/favicon?domain=github.com&sz=128");
const blob = await res.blob();
Markdown
![GitHub](https://favicon.run/favicon?domain=github.com&sz=128)

响应

直接返回 favicon 图片(通常为 image/png)。响应通过 Cache-Control: public, max-age=86400 缓存 24 小时,并以 Access-Control-Allow-Origin: * 返回,可从任意源请求。错误码:域名缺失/非法返回 400,上游获取失败返回 500。

实际示例

下面每个图标都直接由 API 加载——查看网页源码即可验证。

github.com favicongithub.com · 128px
stripe.com faviconstripe.com · 64px
x.com faviconx.com · 32px
youtube.com faviconyoutube.com · 48px
npmjs.com faviconnpmjs.com · 96px
vercel.com faviconvercel.com · 128px

常见问题

Favicon API 免费吗?+

免费——无需 API key、无需注册、不收费。想热链多少页面都行。

需要自己托管 Favicon 吗?+

不用。直接在 <img> 标签里引用 API URL,我们会负责获取、服务和缓存图标。

支持哪些尺寸?+

通过 sz 参数支持 16–512 像素。不传则默认 32。

支持 CORS 吗?+

支持。Access-Control-Allow-Origin 为 *,可从任意源的浏览器端 JS 请求图标。

缓存策略是什么,图标多久更新?+

每个响应缓存 24 小时(Cache-Control: public, max-age=86400),所以重复请求又快又省。底层图标按同样周期刷新。

能用于生产 / 高流量场景吗?+

可以。由 CDN 提供并做了充分缓存。流量非常大时,建议你在自己一侧也缓存响应。

准备好动手试试了吗?