面向生产的端点按 99.99% 可用性和已记录的状态处理方式设计。
被出色公司的人们使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
这个 API 可以帮你交付什么
把此页面当作生产集成简报:端点、示例、响应结构,以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本,而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
使用文档中的请求头发送 API 密钥,并在服务之间保持请求一致。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前,快速查看输入、输出字段和状态码。
参数
响应示例
HTTP 状态码
API 端点
/v1/brand-monitor
/v1/brand-monitor
/v1/brand-monitor/scan
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
主要功能
GET /v1/brand-monitor • POST /v1/brand-monitor • GET /v1/brand-monitor/scan
domain, alert_email, alert_webhook
200, 201, 400, 401, 402, 429, 500, 502, 503, 504
1-5 / 需要身份验证
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand-monitor"
curl -X POST "https://domscan.net/v1/brand-monitor" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{"domain":"acme.com","alert_email":"security@example.com"}'
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand-monitor/scan?domain=acme.com"
响应示例
{
"brands": [
{
"domain": "acme.com",
"added_at": "2026-04-01T09:00:00Z",
"last_scan_at": "2026-04-13T11:30:00Z",
"scan_count": 8,
"registered_typos": 4,
"new_threats_since_baseline": 1,
"has_alerts": true
}
],
"total": 1,
"updated_at": "2026-04-13T11:30:00Z"
}
常见问题解答
本指南涵盖 3 个公开端点:GET /v1/brand-monitor, POST /v1/brand-monitor, GET /v1/brand-monitor/scan。
需要。调用 品牌监控 时,请使用 `X-API-Key` 或 `Authorization: Bearer` 标头发送您的 API 密钥。
本指南中的请求会根据端点消耗 1-5 个积分。批量端点适用页面和完整文档中显示的公开批量费率。
查看 品牌监控 的完整文档,以了解参数详情、身份验证说明以及同一 API 系列中的相关端点。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
请求成功
资源已成功创建。
参数无效
API 密钥或会话缺失或无效。
没有足够额度来执行此请求。
超出速率限制
内部错误
上游 RDAP 错误
上游服务不可用或正在临时限流。
上游查询已超时。
每月 10,000 免费积分起步。几秒内开始检查域名。