文章正文

文章链接正文与发布时间提取

POST /news/fetchcontent

业务说明

根据文章链接提取标题、正文和发布时间；

支持纯文本正文和保留 HTML 标签两种格式；

可按需返回原始 HTML 内容；

适合资讯聚合、内容归档和素材整理；

鉴权：需要 AppKey，使用本操作声明的鉴权位置。

请求参数

参数	位置	类型	必填	真实默认值	说明
appkey	query	string	否	无	付费后获取的 APPKEY
url	body / application/json	string	是	无	需要抓取正文的文章链接
contentwithhtml	body / application/json	["boolean", "string", "null"]	否	false	返回的文章是否包含 HTML 标签
htmlsourcecontent	body / application/json	["boolean", "string", "null"]	否	false	是否返回文章页面原始 HTML 内容，供您二次解析或分析正文失败时使用，需要注意接口的性能问题
url	body / application/x-www-form-urlencoded	string	是	无	需要抓取正文的文章链接
contentwithhtml	body / application/x-www-form-urlencoded	["boolean", "string", "null"]	否	false	返回的文章是否包含 HTML 标签
htmlsourcecontent	body / application/x-www-form-urlencoded	["boolean", "string", "null"]	否	false	是否返回文章页面原始 HTML 内容，供您二次解析或分析正文失败时使用，需要注意接口的性能问题

独立请求示例

{
  "url": "https://cdn.gugudata.com/demo/fetchcontentimages/v1/article-e65ee1f448ca5233.html",
  "contentwithhtml": false,
  "htmlsourcecontent": false
}

返回契约

HTTP 200：业务码 100 成功。
application/json

{
  "type": "object",
  "required": [
    "DataStatus",
    "Data"
  ],
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，此接口返回 1"
        }
      }
    },
    "Data": {
      "type": "object",
      "required": [
        "Url",
        "Title",
        "Content",
        "HTMLSourceContent",
        "PublishDate"
      ],
      "properties": {
        "Url": {
          "type": "string",
          "description": "文章 Url"
        },
        "Title": {
          "type": "string",
          "description": "文章标题"
        },
        "Content": {
          "type": "string",
          "description": "智能分析出的文章正文部分（包含 HTML 标签时，标签为 Unicode 编码）"
        },
        "HTMLSourceContent": {
          "type": "string",
          "description": "文章的原始 HTML 内容（HTML 标签为 Unicode 编码）"
        },
        "PublishDate": {
          "type": "string",
          "description": "文章发表时间"
        }
      },
      "description": "文章结果对象。"
    }
  }
}

HTTP 401：公共鉴权失败；沿用现有公共契约。

HTTP 403：公共权益或额度不足；沿用现有公共契约。

HTTP 404：资源不存在。请求路径不存在。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 405：请求方法不允许。当前路径不支持该 HTTP 方法。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 415：请求内容类型不支持。上传或请求体的内容类型不符合接口要求。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 429：公共频率限制；沿用现有公共契约。

HTTP 502：数据服务暂时不可用，请稍后重试。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 400：业务码 501：参数缺失、非法、重复或冲突。
application/json

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，此接口返回 1"
        }
      }
    },
    "Data": {
      "type": "null",
      "description": "文章结果对象。"
    }
  }
}

HTTP 503：业务码 901：处理、依赖失败或超时。
application/json

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，此接口返回 1"
        }
      }
    },
    "Data": {
      "type": "null",
      "description": "文章结果对象。"
    }
  }
}

业务状态与 HTTP 状态

业务码	含义	说明
100	成功	HTTP 200；仍应检查业务状态。
501	参数错误	HTTP 400
901	依赖失败	HTTP 503

接口详情：https://www.gugudata.com/api/details/fetchcontent
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

业务码 100 成功。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"url=https://www.sohu.com/a/515020778_121119377\u0026contentwithhtml=false\u0026htmlsourcecontent=false","StatusCode":100,"StatusDescription":"请求成功。","ResponseDateTime":"2026-11-02 15:30:17.287","DataTotalCount":1},"Data":{"Url":"https://www.sohu.com/a/515020778_121119377","Title":"2009年收藏的茅台值多少？还能留吗？","Content":"2009年收藏的茅台值多少？还能留吗？\n众所周知，茅台酒是我国的国酒，除了越陈越香越柔和的特质之外，还具有非常高的收藏价值。现在已经有越来越多的资本开始炒作茅台酒，导致2017年的时候茅台酒一度脱销了很久的时间。\n2009年收藏的茅台值多少？还能留吗？\n2009年的茅台酒的总产量为2.3万吨，但当时市场销售的飞天茅台价格是每瓶650元，目前2009年飞天茅台每瓶的价格在2300元-3500元。\n\n1:1987年贵州茅台酒（铁盖），尺寸：，估价：RMB 220,000 ~ 320,000，成交价： RMB 322,000\n有的酒友可能会说是同样都是茅台酒，为什么回收的价格和销售的价格会有不一样呢？这是因为，回收白酒这个行业的特点就是风险大、占用资金的时间比较长，从最开始的找酒到鉴别酒的真假，每一步都不能出现差错，所以导致回收的成本非常高，再加上在终端消费市场上，消费群体的数量并不是很多，所以茅台酒的回收价格和销售价格之间自然存在比较大的差异，这种现象也算是比较正常的一种情况了。试问，如果回收价和销售价差不太多的话，那么商家为什么还要冒那么大的风险从事白酒回收生意呢？高风险高报酬在哪个行业都是准则。\n\n2:1990年贵州茅台酒（铁盖），尺寸：，估价：RMB 117,000 ~ 130,000，成交价： RMB 322,000\n当然，我们作为酒友对于藏酒的品相如何也是要非常关注的，这一点也很重要。如果白酒的外包装被损坏了或者是开封了，那就可以非常明确地告诉你，这瓶茅台酒就太可惜了，已经不值钱了。如果是因为封存的原因导致酒跑了很多的话，收藏的价值也会大幅下降。还有一点就是，藏酒滴蜡会对鉴别茅台酒的真假造成很大的影响，价值也会大打折扣。\n\n3:1997年贵州茅台酒（珍品），尺寸：，估价：RMB 180,000 ~ 280,000，成交价： RMB 287,500\n从去年开始一直到现在，茅台酒的市场价格都不是很稳定，所以那些收藏茅台酒的目的是为了保值升值的人，一定要非常慎重决定。\n1、要调查自己入手的途径是不是正规的，一定要记住保证茅台酒是正品的，买到假的茅台酒会导致你得不偿失。\n\n4:1987年贵州茅台酒（铁盖），尺寸：，估价：RMB 180,000 ~ 250,000，成交价： RMB 287,500\n2、要考虑购买的价格。从以往的市场行情来看，通常在春节过完之后，是一年里面茅台酒的价格相对比较低的时期，我们选择在这个时候入手可以用较低的价格买入。\n\n5:1983-1985年贵州茅台酒（大飞天），尺寸：，估价：RMB 180,000 ~ 280,000，成交价： RMB 287,500\n这里要提醒大家的是，茅台酒保存的时间越久的话，酒液就越容易被挥发，保存起来就越不容易。茅台酒的价格贵的可以卖到几千元，所以一定要保存好。返回搜狐，查看更多","HTMLSourceContent":"","PublishDate":""}}

🟠400请求参数错误。请求参数缺失、格式错误或参数组合不合法。

🟠401鉴权失败。缺少 appkey 或 appkey 无效。

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

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

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

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

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

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

🔴502数据服务暂时不可用，请稍后重试。

🔴503业务码 901：处理、依赖失败或超时。

业务说明#

请求参数#

独立请求示例#

返回契约#

业务状态与 HTTP 状态#

请求参数

请求示例代码

返回响应

业务说明

请求参数

独立请求示例

返回契约

业务状态与 HTTP 状态