网站截图与 HTML 快照 API 接口
网站工具 通过网页 URL 获取站点截图与内容 网页截图 / 网页快照 网站工具 / 截图
1. 产品功能
- 支持任意网页 URL 高质量截图，包括动态内容和 JavaScript 渲染页面；
- 支持全页面截图和可视区域截图两种模式；
- 可自定义截图尺寸、设备像素比等参数；
- 支持桌面端和移动端设备模拟；
- 同时返回截图图片和网页文本内容；
- 支持 base64 编码和 CDN URL 两种返回格式；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡；
- 接口调用状态与状态监控
2. API 文档
接口详情: https://www.gugudata.com/api/details/url2snapshot
接口地址: https://api.gugudata.com/websitetools/url2snapshot?appkey={{appkey}}
返回格式: application/json; charset=utf-8
请求方式: POST
请求协议: HTTPS
请求示例: https://api.gugudata.com/websitetools/url2snapshot
数据预览: https://www.gugudata.com/preview/url2snapshot
接口测试: https://api.gugudata.com/websitetools/url2snapshot/demo
3. 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| url | string | 是 | https://www.example.com | 需要截图的网页 URL 地址，必须是有效的 HTTP 或 HTTPS 链接 |
| responseformat | string | 否 | base64 | 返回格式，可选值：base64（返回 base64 编码的图片数据）、url（返回图片 URL 链接） |
| fullpage | boolean | 否 | true | 是否截取完整页面，true 为全页面截图，false 为可视区域截图 |
| width | int | 否 | 1920 | 截图宽度，单位像素，范围：320-3840 |
| height | int | 否 | 1080 | 截图高度，单位像素，范围：240-2160 |
| devicescalefactor | float | 否 | 1 | 设备像素比，影响截图清晰度，范围：1-3 |
| useragent | string | 否 | Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 | 用户代理字符串，用于模拟不同的浏览器 |
| ismobile | boolean | 否 | false | 是否模拟移动设备，true 为移动设备模式，false 为桌面模式 |
4. 返回参数
| 参数名 | 参数类型 | 备注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回状态码，100 为成功 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | int | 此条件下的总数据量，一般为1 |
| Data.Image | string | 截图图片，当responseFormat为base64时返回base64编码的图片数据，为url时返回图片链接 |
| Data.Content | string | 网页文本内容，提取的网页主要文本信息 |