网页所有 URL 结构化输出

提取网页 HTTP/HTTPS 链接，自动补全地址并去重
提交单个公开网页地址，提取页面中实际取得的 HTTP/HTTPS 链接，适合建立页面链接清单。
支持提取站内与站外链接，便于按域名进一步整理网站导航和外部引用。
支持提取动态网页加载后出现的链接，结果以本次实际取得的页面内容为准。
将相对链接补全为完整网页地址，减少后续处理时手动拼接域名和路径的工作。
去除链接中的页面片段标记，便于把指向同一页面不同位置的地址统一整理。
对提取结果自动去重，减少导航栏、正文和页脚重复链接带来的重复处理。
过滤纯页内锚点及邮件、脚本等非 HTTP/HTTPS 地址，让结果集中于网页链接。
以 JSON 字符串数组返回链接，便于直接接入后端服务、数据表或自动化任务。
同时返回链接数量，方便在链接清单、巡检报表和任务记录中展示本次结果规模。
页面没有可返回的链接时以空数组表示，便于应用区分空结果与提取失败。
提取的地址可作为后续页面采集、内容归档或链接检查的输入，支持分步骤处理网页资料。
提供公开 Demo 展示链接数组与数量，可先确认返回格式，再接入自己的业务流程。

接入说明：提取服务失败时可能返回 7 天内的备用结果，请根据 X-GuGuData-Data-Source 判断来源；备用结果可能已过时。两次提取失败且无有效备用结果时返回依赖失败。GET 请求的 URL 可能出现在网关访问日志中。

当前接口契约

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

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	支持 Query、Header 或 Bearer；多处提供时须一致。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
url	string	是	无	完整的公开 HTTP/HTTPS 网页地址；参数不可重复。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。
DataStatus.StatusCode	integer	接口返回状态码。
DataStatus.StatusDescription	string	接口返回状态说明。
DataStatus.ResponseDateTime	string	接口数据返回时间。
DataStatus.DataTotalCount	integer	Data 数组中的链接数量。
Data	array	网页实际取得的 HTTP/HTTPS 链接；无链接时为空数组。

业务状态说明

业务状态码	业务状态码解释	备注
100	请求成功	结果可能为空数组
501	参数错误	HTTP 400；参数缺失、重复或格式错误
502	请求频率受限	HTTP 429
503	订单已过期	HTTP 403
504	APPKEY 错误	HTTP 401；APPKEY 缺失或无效
505	调用包额度不足	HTTP 403
901	依赖失败	HTTP 503；提取失败且无有效备用结果

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。

Bodyapplication/json

示例

{
  "Data": [
    {}
  ],
  "DataStatus": {
    "StatusCode": 0,
    "StatusDescription": "string",
    "ResponseDateTime": "string",
    "DataTotalCount": 0
  }
}

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

🟠401APPKEY 错误（业务码 504）。

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

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

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

🔴500服务内部错误。服务端处理异常，请稍后重试。

🔴502网关或上游连接错误。正式业务依赖失败通常返回 HTTP 503。

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

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明