实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
分类
身份与验证
API 端点
1
主要功能
4
常见问题解答
4
被这些公司的人员使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
OpenAPI
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
1,000
免费积分
每月 1,000 个免费积分，即刻开始。需要更多？可选择月度方案，或购买一次性积分包。
这个 API 可以帮你交付什么
把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
一次认证
使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。
用示例查询
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
运行和监控
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前，快速查看输入、输出字段和状态码。
参数
domain
响应示例
successdatameta
HTTP 状态码
401402
API 端点
GET
/v1/logo/:domain
domain
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
OpenAPI
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
1,000
免费积分
每月 1,000 个免费积分，即刻开始。需要更多？可选择月度方案，或购买一次性积分包。
主要功能
真实的徽标，或诚实的答复
徽标来自公司自己发布的内容：BIMI 邮件徽标、应用图标、触控图标、结构化数据徽标和网站图标。每张图片在返回前都会下载并解码验证。没有徽标时会返回 404；使用 fallback=monogram 则返回生成的字母图片，并且始终标明是生成的。
尺寸贴合你的界面
可选择 16 到 512 像素的任意尺寸，用 retina 获得双倍像素密度，用 greyscale 转为灰度，并用 theme=light 或 theme=dark 把低对比度的徽标放在你的背景上依然清晰的底板上。图片为带透明边距的正方形。
可自由缓存和保存
响应带有长期有效的公共缓存标头、ETag 和 Last-Modified。浏览器和你的 CDN 都可以保留它们，你也可以存储文件并从自己的服务器提供。在 URL 中加入 v= 即可让它不可变。
可放心用于网页
在 token 参数中使用可公开密钥，它只能在你列出的网站上使用，并按密钥和访客设置限额。私密密钥则留在你的服务器上，通过 X-API-Key 标头发送。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
"https://domscan.net/v1/logo/stripe.com?size=128&retina=true"<img src="https://domscan.net/v1/logo/stripe.com?size=64&token=pk_YOUR_PUBLISHABLE_KEY" width="64" height="64" alt="Stripe">响应示例
HTTP/2 200
content-type: image/png
cache-control: public, max-age=86400, stale-while-revalidate=604800
etag: "9f2c4e1a7b3d5c60-256-c"
x-logo-status: found
x-logo-source: touch_icon
x-logo-verification: decoded
x-logo-source-format: png
x-logo-native-size: 180x180
x-credits-remaining: 4999常见问题解答
一个徽标消耗多少额度？
每次请求消耗 1 个额度，包括从缓存提供的徽标、生成的字母图片、没有徽标的域名以及 304 Not Modified 响应。在任何处理之前就被拒绝的请求，例如域名无效或密钥在未允许的网站上使用，不会计费。请缓存图片，而不要在每次页面浏览时都重新获取。
可以把徽标存储在我自己的服务器上吗？
可以。你可以缓存返回的图片、存储它们，并从自己的服务器或 CDN 提供。徽标仍是其所有者的商标，请仅用于标识它所属的公司。
“未找到”和“不可用”有什么区别？
“未找到”表示网站及其邮件记录已有响应，且没有发布可用的徽标；该结果会复用一小时。“不可用”表示网站拦截了请求、响应缓慢或响应不明确，因此没有得出结论，你可以几分钟后重试。X-Logo-Status 可以区分两者。
怎么知道徽标来自哪里？
X-Logo-Source 会给出来源，例如 bimi、manifest_icon、touch_icon 或 favicon，X-Logo-Verification 表示图片已解码验证。生成的字母图片始终带有 X-Logo-Source: generated，绝不会被当作徽标呈现。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
未授权
401
API 密钥或会话缺失或无效。
需要付款
402
没有足够额度来执行此请求。