高质量网页快照截取服务,支持自定义视口尺寸、全页截图与多格式输出,最大分辨率 3840px,适用于竞品监控、内容存档、缩略图生成、SEO 审计、网页外观自动化测试等场景。
网站截图 API 通过标准 HTTP GET 请求接收目标 URL,返回结构化 JSON 数据(含截图图片 URL)。支持自定义视口宽高、全页滚动截图、多种输出格式(PNG / JPG / WebP)以及页面加载延迟等待。底层基于真实 Chromium 浏览器渲染引擎,可正确处理 JavaScript 动态内容、Web 字体、CSS 动画等现代网页特性。截图结果通过 CDN 加速分发,支持即时访问。接口全程 HTTPS 加密传输,支持高并发调用,可稳定用于线上生产环境。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户身份密钥,在控制台「应用管理」中创建应用后获取。 |
| url | string | 是 | 待截图的网页 URL,需包含 http:// 或 https:// 前缀。 |
| width | int | 否 | 视口宽度,单位像素,默认 1280,最大 3840。 |
| height | int | 否 | 视口高度,单位像素。不传时根据页面内容自动计算。 |
| full_page | int | 否 | 是否全页截图:0(仅视口范围,默认)或 1(滚动截取完整页面)。 |
| format | string | 否 | 输出格式:png(默认)、jpg、webp。 |
| delay | int | 否 | 页面加载后额外等待秒数,范围 0~10,默认 0。适用于需等待 JS 渲染完成的页面。 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200 表示请求成功,其余见错误码对照表。 |
| msg | string | 状态描述信息。 |
| data.image_url | string | 截图图片的 CDN 访问地址,有效期 24 小时。 |
| data.width | int | 截图实际宽度,单位像素。 |
| data.height | int | 截图实际高度,单位像素。 |
| data.format | string | 输出格式:png / jpg / webp。 |
| data.file_size | string | 截图文件大小,如 245KB。 |
| data.title | string | 目标网页的 title 标签内容。 |
| data.load_time | string | 页面加载耗时,单位毫秒。 |
| data.update_time | string | 数据更新时间,格式 yyyy-MM-dd HH:mm:ss。 |
{
"code": 200,
"msg": "success",
"data": {
"image_url": "https://cdn.hmkj4399.com/screenshots/a1b2c3d4.png",
"width": 1280,
"height": 800,
"format": "png",
"file_size": "245KB",
"title": "Example Domain",
"load_time": "1820ms",
"update_time": "2026-07-25 10:15:30"
}
}