Favicon Embed
用一个可热链的 URL 嵌入任意网站的 Favicon——直接放进 <img>、CSS 或 Markdown。无需 API key、无需自建托管,CDN 缓存。
接口
GET https://favicon.run/favicon参数
请求示例
https://favicon.run/favicon?domain=github.com&sz=128预览你的 embed
输入任意域名,预览它的 Favicon——直接由 URL 嵌入。
https://favicon.run/favicon?domain=github.com&sz=128如何嵌入
<img src="https://favicon.run/favicon?domain=github.com&sz=128" alt="GitHub" width="32" height="32" />const res = await fetch("https://favicon.run/favicon?domain=github.com&sz=128");
const blob = await res.blob();响应
直接返回 favicon 图片(通常为 image/png)。响应通过 Cache-Control: public, max-age=86400 缓存 24 小时,并以 Access-Control-Allow-Origin: * 返回,可从任意源请求。错误码:域名缺失/非法返回 400,上游获取失败返回 500。
实际示例
下面每个图标都直接由 API 加载——查看网页源码即可验证。
可以嵌在哪
下面都是嵌入了 Favicon 的真实产品界面——每个图标都是实时的。
链接 / 书签列表
在网址目录、资源页或书签管理器里,给每个链接旁边放上网站图标。
github.com
stripe.com
vercel.com
搜索 & 网址联想
在搜索建议或网址输入联想的下拉里显示目标网站的 Favicon。
浏览器标签 & 地址栏
在浏览器式的界面里渲染 Favicon——标签页、地址栏或应用内网页视图。
外链标识
在文档、博客或更新日志里给外链标上目标网站的图标。
This doc ships with Vercel,
Tailwind CSS, and runs on
Cloudflare.
常见问题
Favicon Embed 免费吗?+
免费——无需 API key、无需注册、不收费。想热链多少页面都行。
需要自己托管 Favicon 吗?+
不用。直接在 <img> 标签里引用 API URL,我们会负责获取、服务和缓存图标。
支持哪些尺寸?+
通过 sz 参数支持 16–512 像素。不传则默认 32。
支持 CORS 吗?+
支持。Access-Control-Allow-Origin 为 *,可从任意源的浏览器端 JS 请求图标。
缓存策略是什么,图标多久更新?+
每个响应缓存 24 小时(Cache-Control: public, max-age=86400),所以重复请求又快又省。底层图标按同样周期刷新。
能用于生产 / 高流量场景吗?+
可以。由 CDN 提供并做了充分缓存。流量非常大时,建议你在自己一侧也缓存响应。