实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
分类
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 或代理工具。
参数和响应映射
在把端点接入客户端前，快速查看输入、输出字段和状态码。
参数
urlrender
响应示例
statusscoremetameta.titlemeta.title_lengthmeta.canonical_self_referencingmeta.indexableheadingsheadings.h1contentcontent.word_countcontent.text_to_html_ratio
HTTP 状态码
200400401402429
API 端点
GET
/v1/onpage
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
服务状态
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
免费额度
免费注册
从每月 10,000 积分开始，只有在用量增长时再升级。
活跃
请求示例
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
主要功能
原始或渲染后
审计服务器发送的 HTML，或设置 render=true，在隔离的浏览器中运行 JavaScript 后再审计页面，就像现代爬虫查看单页应用那样。
38 项加权检查
每项检查都会返回通过、警告、失败或不适用及其严重程度，涵盖从缺少标题、canonical 冲突，到混合内容、缺少 alt 文本的图片和跳级的标题层级等问题。
一次调用获得所有信号
标题和描述长度、meta robots 和 X-Robots-Tag、语言、viewport、favicon、Open Graph、Twitter cards、链接和图片数量以及结构化数据类型。
如实呈现未知结果
被拦截、被限流或失败的抓取会返回 status unknown 并附带原因，且会退还积分，因此无法读取的页面不会被误当作没有问题的页面。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/onpage?url=example.com/shoes/trail-runner&render=true"响应示例
{
"status": "ok",
"score": 87,
"meta": {
"title": "Trail Running Shoes for Rocky Terrain | Example Outdoor",
"title_length": 55,
"canonical_self_referencing": true,
"indexable": true
},
"headings": { "h1": ["Trail Running Shoes for Rocky Terrain"] },
"content": { "word_count": 122, "text_to_html_ratio": 0.221 },
"checks": [
{ "id": "mixed_content", "status": "fail", "severity": "high", "value": 1 },
{ "id": "images_alt", "status": "warn", "severity": "medium", "value": 1 }
],
"issues": ["mixed_content", "heading_hierarchy", "word_count", "images_alt"]
}常见问题解答
评分是如何计算的？
高严重度检查权重为 10 分，中等为 5 分，低为 2 分。通过可获得全部权重，警告获得一半，失败则不得分。不适用的检查（例如没有图片的页面上的图片 alt 文本）不计入。
什么时候应该使用 render=true？
适用于使用 JavaScript 框架构建的页面，这类页面的标题、内容或链接只有在脚本运行后才会出现。可以用 JavaScript SEO API 对比两个版本，准确查看有哪些变化。
它会抓取整个网站吗？
不会。每次请求只审计一个 URL，因此您可以控制检查哪些页面以及花费多少。可以结合站点地图审计 API 来选择要审计的 URL。
需要多少积分？
原始 HTML 审计需要 2 个积分，使用 render=true 需要 6 个积分。结果为 status unknown 的请求会退还积分。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
成功
200
请求成功
请求错误
400
参数无效
未授权
401
API 密钥或会话缺失或无效。
需要付款
402
没有足够额度来执行此请求。
请求过多
429
超出速率限制