文章原文与爆款分析

分析公众号文章、普通网页或文档，提取原文、转换 Markdown 并拆解内容结构与爆款逻辑。

v1异步任务 Bearer 鉴权

POSThttps://popto.cn/api/open/v1/toolbox/wechat_article_analysis

鉴权与请求头

在 API 密钥管理 ↗ 创建密钥，每次请求在 HTTP Header 中携带。

AuthorizationBearer <POPTO_API_KEY>必填

Content-Typeapplication/json必填

请求参数 Body · JSON

来源字段 wechat_url、article_url、url、file_url 至少填写一项非空值。

wechat_urlstring可选

公众号文章链接，支持 /s/分享码与含 __biz、mid、idx、sn 的长链接。

article_urlstring可选

兼容的文章链接字段，优先级低于 wechat_url。

urlstring可选

普通网页 HTTP(S) 链接；也兼容公众号文章链接。

file_urlstring可选

文档 HTTP(S) 下载地址。填写后优先按文档分析。

file_namestring可选

文档文件名，建议使用上传接口返回值。

mime_typestring可选

文档 MIME 类型，建议使用上传接口返回值。

fetch_statsboolean可选

是否获取公众号阅读、点赞等统计，默认 false；可能额外计费。网页和文档忽略此项。

fetch_article_statsboolean可选

fetch_stats 的兼容字段。

include_statsboolean可选

fetch_stats 的兼容字段。

返回值与结构

成功时 ret = 0，业务数据位于 data.ent。以下为 data.ent 中的字段。

tool_idstring

工具箱项目 ID，同时用作项目 ID 与任务 source_id。

task_idstring

异步任务 ID。

调用说明

本地文档先调用文档上传接口，再将 file_url、file_name、mime_type 传入本接口。
用 task/batch_get 获取结果。outputs 包含分析结果、article_row，以及按需获取的 stats。
独立文章分析不依赖跟创能力开关。

处理业务响应

HTTP 200 仍可能返回业务错误，请同时检查 ret、code 和 msg。查看响应与错误码

请求示例Request

bash

curl --request POST \
  'https://popto.cn/api/open/v1/toolbox/wechat_article_analysis' \
  --header "Authorization: Bearer $POPTO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "wechat_url": "https://mp.weixin.qq.com/s/ARTICLE_SHARE_CODE",
  "fetch_stats": false
}'

成功响应200 OK

json

{
  "ret": 0,
  "msg": "success",
  "data": {
    "ent": {
      "tool_id": "tool_example",
      "task_id": "task_example"
    }
  }
}

示例内容用于说明结构。任务 ID、积分和执行结果以实际响应为准。