URL 转静态 HTML 文件

将公开网页保存为可下载的 HTML 文件
返回 HTML 文件公开下载地址。保存范围取决于网页实际可访问内容及资源；登录、验证或复杂动态页面可能无法转换。文件请按业务需要自行保存，不承诺永久托管。
接收一个公开网页地址，生成 HTML 文件。
返回公开下载链接，便于获取转换文件。
保留可提取的网页正文，便于内容归档。
支持中文网页资料的保存与审阅。
保存能够成功内联的图片资源，具体以文件结果为准。
保存可获取的页面样式，便于后续查看。
按单页组织产物，便于对应原始网页。
可用于网页资料整理及留存。
可作为内容审阅流程的资料文件。
通过不同时间生成的文件进行人工版本对照。
可将下载文件纳入自有文档归档流程。
支持 JSON 与表单接入，提供可复现的公开样例。

当前接口契约

接口详情：https://www.gugudata.com/api/details/url2html

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	调用凭据；兼容现有有效位置，多处须一致。此鉴权位置可选；整体鉴权要求及其他已支持位置以本操作说明为准。
url	string	是	无	公开 HTTP/HTTPS 网页地址；同时支持 JSON 与表单。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	真实、可读的业务请求参数；无业务参数时为空，不包含凭据。
DataStatus.StatusCode	integer	接口返回状态码。
DataStatus.StatusDescription	string	接口返回状态说明。
DataStatus.ResponseDateTime	string	接口数据返回时间。
DataStatus.DataTotalCount	integer	成功结果对象数量，为 1。
Data	string	返回 HTML 文件公开下载地址。保存范围取决于网页实际可访问内容及资源；登录、验证或复杂动态页面可能无法转换。文件请按业务需要自行保存，不承诺永久托管。

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数或文件错误	HTTP 400
901	依赖失败或超时	HTTP 503
502	请求频率限制	HTTP 429
503	权益已过期	HTTP 403
504	凭据无效或无接口权限	HTTP 401
505	调用额度不足	HTTP 403

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功（业务码 100）。

Bodyapplication/json

示例

{
  "DataStatus": {
    "RequestParameter": "url=https://cdn.gugudata.com/demo/fetchcontentimages/v1/article-e65ee1f448ca5233.html",
    "StatusCode": 100,
    "StatusDescription": "请求成功。",
    "ResponseDateTime": "2026-10-15 19:40:34.219",
    "DataTotalCount": 1
  },
  "Data": "https://cdn.gugudata.com/webpages/7093d0ee-5af6-4cc4-84fc-f1f45ef9e1af.html"
}

🟠400参数或文件错误（业务码 501）。

🔴503依赖失败或超时（业务码 901）。

🟠429请求频率限制（业务码 502）。

🟠403权益已过期（业务码 503）；调用额度不足（业务码 505）。

🟠401凭据无效或无接口权限（业务码 504）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明