FaviconAPI

输入域名
拿到任意网站的图标地址

常用站点

接口文档

图标解析接口均为 GET，返回结果带 CORS 头，可直接用于浏览器端。

  • 接口列表
  • 请求参数
  • 响应说明
  • 调用示例
方法路径说明
GET /icon 返回图标二进制流，可直接作为 img / link 的地址
GET /icon/default 内置默认图标（SVG），用于兜底展示
GET /api/info 解析图标并返回 JSON 元信息（来源、尺寸、体积、耗时）
参数类型必填默认值说明
url string 是 — 目标站点，支持域名（github.com）或完整地址（https://github.com/a/b），自动取 origin
size int 否 原始尺寸 16 / 32 / 48 / 64 / 128 / 180 / 192 / 256，等比缩放居中，保留透明通道
format string 否 auto auto 跟随源图；png 统一转 PNG；ico 输出 ICO 容器
refresh bool 否 0 传 1 跳过缓存，强制重新抓取
fallback string 否 default default 解析不到时返回内置占位图标；404 改为返回 JSON 错误（参数非法 422、未找到图标 404）
未传 size 时保留源图原始分辨率；传了 size 而未指定 format 时默认输出 PNG。

响应头

响应头说明
X-Favicon-Source命中来源：site-link / common-path / third-party / default
X-Favicon-CacheHIT 命中本地缓存，MISS 实时抓取
X-Favicon-Width / Height实际输出图标的像素尺寸
X-Favicon-Time本次处理耗时（毫秒）
Cache-Controlpublic, max-age=86400，由浏览器与 CDN 复用
X-RateLimit-Limit / Remaining / Reset限流额度、剩余次数与窗口重置时间戳；超限返回 429 与 Retry-After

JSON 返回（/api/info）

{
  "code": 0,
  "msg": "ok",
  "data": {
    "host": "github.com",
    "api": "https://favicon.wenruyun.com/icon?url=github.com&size=64",
    "source": "site-link",
    "source_label": "站点声明",
    "mime": "image/png",
    "width": 64,
    "height": 64,
    "weight": 3412,
    "cache": false,
    "elapsed_ms": 486
  }
}
解析失败时 source 为 default，api 仍然可用，只是返回内置占位图标。

直接引用

<link rel="icon" href="https://your-domain.com/icon?url=github.com&size=64">
<img src="https://your-domain.com/icon?url=github.com&size=32" alt="github">

命令行

# 直接下载图标
curl -o favicon.png "https://favicon.wenruyun.com/icon?url=github.com&size=128&format=png"

# 只看元信息
curl "https://favicon.wenruyun.com/api/info?url=github.com"