实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
分类
Web 数据
API 端点
1
主要功能
4
常见问题解答
4
被这些公司的人员使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
OpenAPI
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
10,000
免费额度
从每月 10,000 积分开始，只有在用量增长时再升级。
这个 API 可以帮你交付什么
把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
一次认证
使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。
用示例查询
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
运行和监控
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前，快速查看输入、输出字段和状态码。
参数
urlmax_pages
响应示例
statussummarysummary.pages_crawledsummary.pages_oksummary.pages_not_foundsummary.average_scoresummary.crawl_completeissuesissues.broken_internal_linksissues.duplicate_meta_descriptionsissues.thin_pagesissues.onpage_checks
HTTP 状态码
200400401402429
API 端点
GET
/v1/site-audit
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
服务状态
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
免费额度
免费注册
从每月 10,000 积分开始，只有在用量增长时再升级。
活跃
请求示例
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
主要功能
友好抓取
通过内部链接发现页面，遵循 robots.txt，并在固定的时间预算内每次只抓取少量页面。
站点级问题
失效的内部链接及其所在页面、内部重定向、已设置 canonical 的页面和 noindex 页面，以及内容单薄的页面。
重复检测
重复的标题、meta 描述和 H1，以及主要内容近似重复的页面对。
审计每个页面
每个被抓取的页面都会接受完整的页面审计，并附带评分、层级深度、入链数和未通过的检查项。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/site-audit?url=example.com&max_pages=25"响应示例
{
"status": "ok",
"summary": { "pages_crawled": 25, "pages_ok": 24, "pages_not_found": 1, "average_score": 88, "crawl_complete": false },
"issues": {
"broken_internal_links": [{ "url": "https://example.com/old-sale", "http_status": 404, "linked_from": ["https://example.com/"] }],
"duplicate_meta_descriptions": [{ "value": "shop trail shoes", "urls": ["https://example.com/a", "https://example.com/b"] }],
"thin_pages": [{ "url": "https://example.com/contact", "word_count": 74 }],
"onpage_checks": [{ "check": "images_alt", "pages": 12 }]
}
}常见问题解答
最多可以抓取多少个页面？
每次请求 10、25 或 50 个页面。响应会说明有多少已发现的页面未被抓取，方便您了解覆盖范围。
会遵循 robots.txt 吗？
会。对所有爬虫都禁止访问的页面会被跳过。如果无法读取 robots.txt，则只审计起始页面。
为什么有些链接没有被检查？
只检查已抓取的页面。指向页数上限之外页面的链接会计为已发现但未抓取。
需要消耗多少积分？
10 个页面 10 积分，25 个页面 20 积分，50 个页面 35 积分。如果无法读取起始页面，该请求会退还积分。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
成功
200
请求成功
请求错误
400
参数无效
未授权
401
API 密钥或会话缺失或无效。
需要付款
402
没有足够额度来执行此请求。
请求过多
429
超出速率限制