实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
分类
身份与验证
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 或代理工具。
参数和响应映射
在把端点接入客户端前，快速查看输入、输出字段和状态码。
参数
domaintickerexchangeisinname
响应示例
queryquery.typequery.valuequery.exchangestatusdomainnamename.statusname.valuename.provenancename.provenance.sourcename.provenance.method
HTTP 状态码
200304400401402429
API 端点
GET
/v1/brand
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
OpenAPI
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
1,000
免费积分
每月 1,000 个免费积分，即刻开始。需要更多？可选择月度方案，或购买一次性积分包。
主要功能
从徽标读取的颜色
调色板来自已解码徽标的像素，排除透明区域和纯色背景，提供 hex、RGB 和 OKLCH 格式。网站自行声明的 theme_color 会单独报告。
方形与宽幅徽标
获取方形品牌标志，以及网站发布的宽幅页眉徽标或文字标志。两者在返回之前都会被下载并解码。
未知绝不等于不存在
每个字段都会标明存在、不存在或未知。网站拦截请求或超时，只会得到未知字段，而不是空字段；股票代码对应多家公司时，会返回候选列表，而不是猜测。
品牌变更时发出提醒
通过品牌提醒订阅来监控某个品牌域名，当其徽标、颜色、名称或社交媒体主页发生变化时，你的 Webhook 会收到 brand.updated。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"响应示例
{
"query": { "type": "domain", "value": "stripe.com", "exchange": null },
"status": "present",
"domain": "stripe.com",
"name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
"logo": {
"status": "present",
"value": { "url": "https://domscan.net/v1/logo/stripe.com", "source": "touch_icon", "verification": "decoded", "native_width": 180, "native_height": 180 }
},
"wide_logo": {
"status": "present",
"value": { "url": "https://domscan.net/v1/logo/stripe.com?variant=wide", "source": "logo_image", "aspect_ratio": 2.4 }
},
"colors": {
"status": "present",
"value": {
"from": "logo",
"dominant": { "hex": "#635bff", "rgb": { "r": 99, "g": 91, "b": 255 }, "oklch": { "css": "oklch(57.84% 0.2346 278.29)" }, "share": 0.8712 },
"background": null
},
"provenance": { "source": "logo_pixels", "method": "quantized_palette" }
},
"theme_color": { "status": "present", "value": { "declared": "#635BFF" }, "provenance": { "source": "website", "method": "meta_theme_color" } },
"socials": { "status": "present", "value": [{ "platform": "x", "url": "https://x.com/stripe", "declared_by": "same_as" }] },
"checked_at": "2026-11-02T10:00:00.000Z"
}常见问题解答
一次品牌查询消耗多少额度？
每次请求消耗 3 个额度，“不存在”和“未知”的结果同样计费。无效请求，以及因 DomScan 自身的公司数据不可用而失败的查询，都会退还额度。响应中的每个徽标图片 URL 在你请求时消耗 1 个额度。
我可以保存品牌数据吗？
可以。你可以在自己的系统中缓存并保存结果和徽标。响应带有 ETag 和缓存标头，方便你重新验证已保存的副本。徽标和名称仍是其所有者的商标。
品牌颜色来自哪里？
来自已解码徽标的像素。相近的颜色会被合并，透明部分和纯色背景会被排除，同一个徽标始终得到同样的调色板。网站自行声明的 theme_color 是单独的字段。
可以用股票代码查询品牌吗？
可以。用 ticker（可选搭配 exchange）、isin 或 name 代替 domain 发送即可。只有恰好匹配一家公司时才会使用域名；否则结果为未知，并附带原因和候选列表。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
成功
200
请求成功
HTTP 304
304
我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
请求错误
400
参数无效
未授权
401
API 密钥或会话缺失或无效。
需要付款
402
没有足够额度来执行此请求。
请求过多
429
超出速率限制