文章正文图片列表

提取文章正文图片，支持大小和分辨率筛选
根据文章链接提取识别到的正文图片列表。
按图片文件大小筛选，支持小数 KB 阈值。
按图片宽度和高度筛选，两项均达到阈值才保留。
将正文中的相对图片地址解析为完整 HTTP/HTTPS 地址。
去除重复图片地址，保留首次出现的顺序。
可返回与每张图片对应的完整 img 标签，便于核对属性。
可同时返回来源页面 HTML，供内容整理和进一步分析。
无正文图片或已核实图片均不满足条件时返回空列表。
提供图片地址集合，便于文章素材整理和人工审核。
支持表单和 JSON 请求，并提供可复现的完整公开样例。
筛选时跳过个别无法核实的图片；全部候选均无法核实时失败。使用正文识别结果，不执行整站遍历。

当前接口契约

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

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	开发者中心分配的 APPKEY；支持现有 Query、Body、Header 和 Bearer 鉴权。此鉴权位置可选；整体鉴权要求及其他已支持位置以本操作说明为准。
url	string	是	无	公开 HTTP/HTTPS 文章链接，必须显式传入；支持表单和 JSON，不保证识别全部网页图片。
limittype	string	否	无	不传时不筛选；size 按最小文件大小筛选，ratio 按最小宽、高筛选。
limitvalue	float / [int,int]	否	无	指定筛选类型时必填：size 为非负 KB 数值，支持小数；ratio 为 [宽,高]，两个非负整数，单位为像素。未指定类型时忽略此值。
imagewithtag	boolean	否	false	是否返回与图片 URL 对应的完整 img 标签，默认 false。
htmlsourcecontent	boolean	否	false	是否返回页面原始 HTML，默认 false。15 分钟主缓存及最多 24 小时备用内容可能与网页当前状态不同。

正常响应字段

字段	类型	说明
DataStatus.StatusCode	integer	接口返回状态码
DataStatus.StatusDescription	string	接口返回状态说明
DataStatus.ResponseDateTime	string	接口数据返回时间
DataStatus.DataTotalCount	integer	符合条件的图片集合数量
Data.Url	string	文章 Url
Data.ImagesUrl	array	文章正文中符合筛选条件的图片 Url 集合
Data.ImagesTag	array	开启 imagewithtag 时返回与图片 URL 一一对应的完整 img 标签，否则为 null。
Data.HTMLSourceContent	string	开启 htmlsourcecontent 时返回页面原始 HTML，否则为空字符串。
DataStatus.RequestParameter	string	本次真实业务请求参数，不包含凭据；Demo 展示对应输入。

业务状态说明

业务状态码	业务状态码解释	备注
100	请求成功	HTTP 200
501	参数错误	HTTP 400
504	APPKEY 缺失或无效	HTTP 401
901	正文图片提取依赖失败或超时	HTTP 503

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

请求成功（业务码 100）。

Bodyapplication/json

示例

{
  "DataStatus": {
    "StatusCode": 100,
    "RequestParameter": "{\"url\":\"https://cdn.gugudata.com/demo/fetchcontentimages/v1/article-e65ee1f448ca5233.html\",\"imagewithtag\":true,\"htmlsourcecontent\":false}",
    "StatusDescription": "请求成功。",
    "ResponseDateTime": "2026-10-07 11:52:42.019",
    "DataTotalCount": 2
  },
  "Data": {
    "Url": "https://cdn.gugudata.com/demo/fetchcontentimages/v1/article-e65ee1f448ca5233.html",
    "ImagesUrl": [
      "https://cdn.gugudata.com/demo/fetchcontentimages/v1/image-1-ee394c447dff443c.png",
      "https://cdn.gugudata.com/demo/fetchcontentimages/v1/image-2-53aed56f1bb06511.png"
    ],
    "ImagesTag": [
      "<img src=\"https://cdn.gugudata.com/demo/fetchcontentimages/v1/image-1-ee394c447dff443c.png\" alt=\"材料整理说明图 1\" width=\"240\" height=\"120\">",
      "<img src=\"https://cdn.gugudata.com/demo/fetchcontentimages/v1/image-2-53aed56f1bb06511.png\" alt=\"材料整理说明图 2\" width=\"240\" height=\"120\">"
    ],
    "HTMLSourceContent": ""
  }
}

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

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

🟠403无权限访问。订单到期、权限不足或接口额度不可用。

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

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

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

🟠429请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。

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

🔴502上游依赖错误。上游依赖服务不可用或返回异常。

🔴503正文图片提取依赖失败或超时（业务码 901）。

当前接口契约#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应字段

业务状态说明