实时
服务状态
集成前，请先查看实时服务运行状况和文档中说明的失败响应。
分类
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 或代理工具。
参数和响应映射
在把端点接入客户端前，快速查看输入、输出字段和状态码。
参数
urldevicefull_pageformatoutput
响应示例
statusfinal_urlhttp_statuscapturecapture.formatcapture.mime_typecapture.devicecapture.full_pagecapture.widthcapture.heightcapture.bytescapture.data_base64
HTTP 状态码
200400401402429
API 端点
GET
/v1/screenshot
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。
服务状态
API 资料
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
API 密钥
受保护访问
认证端点使用 API 密钥，并在调用前清楚显示积分成本。
免费额度
免费注册
从每月 10,000 积分开始，只有在用量增长时再升级。
活跃
请求示例
从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。
主要功能
真实浏览器渲染
页面在隔离的浏览器中连同 JavaScript、样式、字体和图片一起加载，与访问者看到的完全一致。
桌面与移动端
可截取 1366 px 的桌面视图，或支持触控和移动布局的 390 px 移动端视图。
整页或视口
可截取可见区域，也可滚动截取整个页面，最高 8,000 px。
JSON 或文件
在 JSON 中获取带有尺寸和大小的 base64 数据，或设置 output=binary 直接接收图片或 PDF。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/screenshot?url=example.com&device=mobile&full_page=true"响应示例
{
"status": "ok",
"final_url": "https://example.com/",
"http_status": 200,
"capture": {
"format": "png",
"mime_type": "image/png",
"device": "mobile",
"full_page": true,
"width": 390,
"height": 2480,
"bytes": 412870,
"data_base64": "iVBORw0KGgoAAAANSUhEUgAA..."
}
}常见问题解答
支持哪些格式？
支持 PNG、JPEG 和 WebP 图片，以及带背景的 A4 PDF 文档。
可以登录或点击按钮吗？
不可以。页面按匿名访问者首次加载时看到的样子截取，不会点击、输入或接受 Cookie 横幅。
遇到特别长的页面会怎样？
整页截图最高到 8,000 px 为止。超过 5 MB 的截图会返回 status unknown，并退还积分。
需要消耗多少积分？
每次截图 10 积分。被拦截或失败的页面会退还积分。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
成功
200
请求成功
请求错误
400
参数无效
未授权
401
API 密钥或会话缺失或无效。
需要付款
402
没有足够额度来执行此请求。
请求过多
429
超出速率限制