快速开始

通过一次 HTTP 请求为任何域名获取干净、比例合适的 logo。

正在从 Clearbit Logo API 迁移?

先查看迁移指南,再在几个实际域名上测试。

之前的 Clearbit 用户通常不是需要"另一个 logo 文件源",而是需要在 UI 中可直接使用的输出。这两份指南能帮助你最快上手。

ClearLogo 是一个 HTTP API,通过单次 GET 请求为任何域名返回干净、比例合适、透明背景的 logo 图像。低流量浏览无需登录;生产流量使用浏览器密钥或服务器密钥。

1. 无需密钥即可尝试

该端点对低流量浏览开放。输入域名,立即获得 PNG 返回。

GET https://api.clearlogo.dev/logo/github.com?size=128&content=80

或直接在 HTML 中使用:

<img src="https://api.clearlogo.dev/logo/github.com?size=64&content=80" alt="GitHub" />

2. 获取生产密钥

从仪表板创建密钥。根据请求运行的位置选择模式:

  • 浏览器密钥 — 直接在 <img> 标签中使用。调用会根据密钥上允许的域名进行检查。
  • 服务器密钥 — 以 Authorization: Bearer … 的形式发送。保存在后端 — 切勿将其发送到浏览器。

登录以创建密钥

3. 调整输出

三个参数控制大部分结果:size(大小)、content(canvas 内的 logo 占比)和 theme(亮色/暗色变体)。 打开演练场 在复制最终 URL 之前预览组合。

下一步

  • 演练场 — 在线尝试每个选项并复制您要使用的精确 URL。
  • 获取 API 密钥 — 登录并创建公开密钥或私密密钥用于生产流量。
  • API 参考 — 查看端点、参数、认证方式和速率限制行为。