首页 开发文档 服务状态 联系支持 登录 / 注册

Favicon API 文档

用一个 GET 请求获取任意站点图标,适合导航站、内容聚合站、CMS 后台与 SaaS 控制台。文档已按参数、示例和返回码整理,减少碎片化卡片阅读负担。

GET /get.php?url=example.com&size=128&key=YOUR_KEY

快速开始

请求成功返回 image/png,可直接作为 `` 的地址使用。若接口校验失败,会返回对应错误状态码与文本说明。

GET https://favicon.org.cn/get.php?url=apple.com&size=64&key=YOUR_KEY
<img src="https://favicon.org.cn/get.php?url=apple.com&size=64&key=YOUR_KEY" alt="apple favicon" />

参数说明

url 必填
目标站点域名或 URL,例如 `apple.com`、`https://github.com`。
size 可选
输出尺寸,默认 `64`,建议 `16/32/64/128/256` 等常见值。
key 可选
API Key。若后台启用访客模式可留空,否则需要有效密钥。

返回状态

  • 200 请求成功,返回 `image/png` 图标数据。
  • 403 未授权:缺失或无效的 API Key。
  • 404 目标站点未找到可用图标。
  • 429 请求频率过高,请稍后重试。