跳转到内容
POST AI agent ready /v1/favicon

Favicon API - 免费 Favicon 提取器

传递域名并返回网站公开的所有网站图标的结构化列表。 The API fetches the HTML, parses link tags, checks common fallback paths like /favicon.ico, and returns each icon with its URL, declared sizes, and MIME type.

Parameters

stringrequired

The domain to extract favicons from. Do not include the protocol (https://).

Code examples

curl -X POST https://api.botoi.com/v1/favicon \
  -H "Content-Type: application/json" \
  -d '{"domain":"github.com"}'

When to use this API

书签管理器缩略图

当用户保存书签时,调用 favicon API 来获取站点图标并将其显示在标题旁边。 这为您的书签管理器提供了一个精美的、可视化的链接列表。

链接预览丰富

将此端点与 url-metadata 结合起来构建丰富的链接卡。 在聊天应用程序或 CMS 编辑器中显示每个粘贴的 URL 的网站图标、页面标题和说明。

竞争分析仪表板

提取竞争对手域列表的图标并将其显示在监控仪表板中。 即时视觉识别每个品牌,无需手动上传图标。

Frequently asked questions

API 检测哪些图标格式?
它检测 HTML 头中声明的 ICO、PNG、SVG 和 Apple Touch 图标。 如果不存在链接标签,它还会检查 /favicon.ico 后备路径。
它遵循重定向吗?
是的。 API 最多可跟踪 5 个 HTTP 重定向以到达最终的 HTML 文档。 这处理从 www 重定向到非 www 或从 HTTP 重定向到 HTTPS 的域。
如果域名没有图标会怎样?
API 返回一个空的收藏夹图标数组。 不会抛出任何错误。 您可以检查数组长度来决定是否在 UI 中显示默认图标。
我应该在域参数中包含“https://”吗?
不可以。传递裸域名,例如“github.com”。 API 自动添加协议并处理 HTTP 和 HTTPS 查找。
返回的图标 URL 是否稳定?
URL 指向目标域上的实时资产,因此如果网站所有者更新其图标,它们可能会发生更改。 如需长期存储,请下载图标并自行托管。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.