语义化获取站点 JSON 结构内容

网页内容 JSON 提取
提交公开网页地址和自然语言提取指令，将页面中的目标信息转换为可直接处理的 JSON 数据。
可在指令中约定字段名称和组织方式，便于让不同网页的提取结果使用一致的业务字段。
可指定只提取页面中的某类内容，例如产品信息或联系方式，减少后续人工筛选与整理。
适合从文章或资讯页面整理标题、作者、发布时间等页面已有信息，用于内容索引与资料归档。
适合从产品介绍或目录页面整理名称、规格、价格等页面已有信息，辅助维护产品资料。
可提取企业官网展示的站点名称、联系邮箱等公开信息，便于补充企业资料和业务名录。
支持对可访问的动态网页进行内容提取，可用于需要页面加载后才呈现信息的场景。
提取结果支持 JSON 对象、数组及字符串、数字、布尔值，便于承接单条记录、列表和简单数值结果。
可使用中文描述提取需求，并在指令中指定英文字段名，方便业务人员与开发者共同定义输出。
支持表单和 JSON 两种请求正文，便于接入既有 HTTP 客户端、后端服务和自动化工具。
返回的结构化数据可继续用于数据库入库、表格整理或 AI 工作流，减少重复复制网页内容。
提供公开网页的提取 Demo，可先查看输入指令与 JSON 样例，再设计自己的提取任务。
必填值不能全为空白，字段不能重复；请求回显只包含 URL 与指令长度。

当前接口契约

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

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	支持 Query、Header、Bearer 或历史正文 appkey；凭据必须一致。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
url	string	是	无	HTTP/HTTPS 网页地址，不含用户名密码；支持表单与 JSON 正文。
prompt	string	是	无	非空提取指令；参数不可重复，结果应对照网页复核。

正常响应字段

字段	类型	说明
DataStatus.StatusCode	integer	接口返回状态码，100为成功
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	integer	此条件下的总数据量，一般为1
Data	object/array/string/number/boolean	按指令返回有效 JSON；支持对象、数组及标量，0 与 false 有效。
DataStatus.RequestParameter	string	本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数错误	HTTP 400
502	请求频率受限	HTTP 429
503	订单到期	HTTP 403
504	APPKEY 缺失或无效	HTTP 401
505	额度或权限不可用	HTTP 403
900	内部错误	HTTP 500
901	提取服务暂不可用、超时或取消	HTTP 503

常见问题

如何让不同网页返回一致的字段？

在 prompt 中写清要提取的字段名、类型和输出层级。例如要求返回包含 title 和 publish_date 的 JSON 对象，并明确网页缺少日期时使用空字符串。请用接入侧的字段校验确认每次输出。

如何提交网页地址和提取指令？

用 POST 提交可访问的 HTTP 或 HTTPS 网页地址 url 和非空 prompt。请求正文支持 JSON 或表单，网页地址中请勿携带用户名或密码。

返回的数据可以是列表或单个数值吗？

可以。Data 支持 JSON 对象、数组、字符串、数字和布尔值。按业务约定检查 Data 的类型，0 和 false 都是有效结果。

Demo 可以提交自己的网页吗？

Demo 无需 AppKey，提供公开网页及提取指令的样例。要提取指定网页，请向正式接口提交自己的 url 和 prompt。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功（业务码 100）。

Bodyapplication/json

示例

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

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

🟠401APPKEY 缺失或无效（业务码 504）。

🟠403订单到期（业务码 503）；额度或权限不可用（业务码 505）。

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

🔴500内部错误（业务码 900）。

🔴503提取服务暂不可用、超时或取消（业务码 901）。

语义化获取站点 JSON 结构内容

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

常见问题#

如何让不同网页返回一致的字段？#

如何提交网页地址和提取指令？#

返回的数据可以是列表或单个数值吗？#

Demo 可以提交自己的网页吗？#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明

常见问题

如何让不同网页返回一致的字段？

如何提交网页地址和提取指令？

返回的数据可以是列表或单个数值吗？

Demo 可以提交自己的网页吗？