网站截图与 HTML 快照 API 接口

接口详情官网地址: https://www.gugudata.com/api/details/url2snapshot

网站截图与 HTML 快照 API 通过网页 URL 获取站点截图与内容，网站工具、截图等关键词场景常会用到，适合用于站点内容抽取与网页分析、SEO 检查与页面结构处理与网页自动化采集与结构化输出等业务场景，方便开发者直接在应用、脚本或数据流程中接入。

1. 产品功能

• 支持任意网页 URL 高质量截图，包括动态内容和 JavaScript 渲染页面；
• 支持全页面截图和可视区域截图两种模式；
• 可自定义截图尺寸、设备像素比等参数；
• 支持桌面端和移动端设备模拟；
• 同时返回截图图片和网页文本内容；
• 支持 base64 编码和 CDN URL 两种返回格式；
• 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
• 全面兼容 Apple ATS；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；

2. API 文档

接口地址: https://api.gugudata.com/websitetools/url2snapshot?appkey={{appkey}}

返回格式: application/json; charset=utf-8

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/websitetools/url2snapshot?appkey={{appkey}}?url=YOUR_VALUE&responseFormat=base64&fullPage=true&width=1920&height=1080&deviceScaleFactor=1&userAgent=YOUR_VALUE&isMobile=false

数据预览: https://www.gugudata.com/preview/url2snapshot

接口测试: https://api.gugudata.com/websitetools/url2snapshot/demo

3. 请求参数

4. 返回参数

5. 错误码说明

6. 适用场景

• 适合用于站点内容抽取与网页分析，快速补齐产品侧需要的 网站截图与 HTML 快照 数据能力。
• 适合用于SEO 检查与页面结构处理，减少手工整理、清洗与重复开发成本。
• 适合用于网页自动化采集与结构化输出，将接口结果直接接入后台系统、数据任务或内容处理流程。

7. 相关接口

• 可搭配使用：获取任意站点标题与图标，适合补充同类场景的接口能力。
• 可搭配使用：域名 Whois 查询，适合补充同类场景的接口能力。
• 可搭配使用：网页可读内容抽取，适合补充同类场景的接口能力。