实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
分类
身份与验证
API 端点
1
主要功能
4
常见问题解答
4
被这些公司的人员使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
OpenAPI
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
1,000
免费额度
每个 UTC 自然月可免费获得 1,000 个积分。如需更多积分，可选择可选的月度方案或购买一次性积分包。
这个 API 可以帮你交付什么
把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
一次认证
使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。
用示例查询
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
运行和监控
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前，快速查看输入、输出字段和状态码。
参数
emailusernameplatformdomain
响应示例
inputinput.typeinput.valueinput.platformavataravatar.urlavatar.sourceavatar.kindavatar.verifiedavatar.content_typeavatar.profile_urlcandidates
HTTP 状态码
200400401402429
API 端点
GET
/v1/avatar
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
OpenAPI
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
1,000
免费额度
每个 UTC 自然月可免费获得 1,000 个积分。如需更多积分，可选择可选的月度方案或购买一次性积分包。
主要功能
邮箱、用户名或域名
邮箱地址会与公开头像服务以及其邮件域名所属公司的徽标进行匹配。用户名会在 GitHub、Bluesky、Mastodon 和 Keybase 上检查。域名则返回网站徽标。
仅返回已验证的图片
每张返回的图片都会被下载并确认确实是图片。错误页面、失效链接和默认占位图永远不会被返回。
每个来源都有证据
每个来源都会报告 present、absent 或 unknown 并说明原因，因此缺少图片的情况绝不会与未响应的来源混淆。
需要时保持最新
结果会复用数小时。传入 max_age 可设置已存储答案的最长有效时间，传入 max_age=0 则重新检查。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"响应示例
{
"input": { "type": "username", "value": "octocat", "platform": null },
"avatar": {
"url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
"source": "bluesky",
"kind": "avatar",
"verified": true,
"content_type": "image/jpeg",
"profile_url": "https://bsky.app/profile/octocat.bsky.social"
},
"candidates": [
{
"source": "github",
"kind": "avatar",
"status": "present",
"detail": "image_verified",
"url": "https://avatars.githubusercontent.com/u/583231?v=4",
"verified": true,
"content_type": "image/png",
"profile_url": "https://github.com/octocat",
"may_be_generated": true
},
{
"source": "bluesky",
"kind": "avatar",
"status": "present",
"detail": "image_verified",
"url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
"verified": true,
"content_type": "image/jpeg",
"profile_url": "https://bsky.app/profile/octocat.bsky.social"
},
{ "source": "keybase", "kind": "avatar", "status": "absent", "detail": "account_not_found", "url": null, "verified": false, "content_type": null }
],
"status": "present",
"checked_at": "2026-11-02T10:00:00.000Z"
}常见问题解答
会检查哪些来源？
邮箱：Gravatar、Libravatar 以及公司邮件域名的 BIMI 徽标。用户名：GitHub、Bluesky、Mastodon 和 Keybase，或仅检查你选择的平台。域名：网站发布的徽标或图标及其 BIMI 徽标。
absent 是什么意思？
每个来源都明确回答没有图片：没有账号、账号没有头像，或没有发布徽标。如果任何来源被屏蔽、响应缓慢或结果不明确，则结果为 unknown。
为什么 GitHub 头像可能被标记为疑似自动生成？
GitHub 会为未上传头像的账号分配自动生成的图案，并且不会说明账号属于哪种情况。这类图片绝不会作为头像返回，而是与其他来源一起列出并加以标记；如果它是找到的唯一图片，则结果为 unknown。
需要多少积分？
每次查询 2 积分，与检查的来源数量无关。unknown 结果会退还积分。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
成功
200
请求成功
请求错误
400
参数无效
未授权
401
API 密钥或会话缺失或无效。
需要付款
402
没有足够额度来执行此请求。
请求过多
429
超出速率限制