爆款视频结构拆解

输入抖音、小红书、微信视频号或可访问的视频链接，提取内容、分析爆款结构，并按需返回视频分段。

v1异步任务 Bearer 鉴权

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

鉴权与请求头

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

AuthorizationBearer <POPTO_API_KEY>必填

Content-Typeapplication/json必填

请求参数 Body · JSON

urlstring必填

视频链接或包含链接的分享文本。

split_videoboolean可选

是否切分视频，默认 false；开启后增加视频切分积分消耗。

hot_analysisboolean可选

兼容字段。此接口始终启用爆款结构分析，无需填写。

返回值与结构

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

tool_idstring

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

task_idstring

异步任务 ID。

调用说明

提交成功仅代表任务已创建；使用返回的 task_id 查询任务。
此独立工具不返回 flow_id。tool_id 是工具箱项目标识。
调用会消耗视频分析与结构拆解积分，split_video=true 时还包含视频切分。

处理业务响应

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

请求示例Request

bash

curl --request POST \
  'https://popto.cn/api/open/v1/toolbox/hot_structure_dismantle' \
  --header "Authorization: Bearer $POPTO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "https://v.douyin.com/VIDEO_SHARE_CODE/",
  "split_video": false
}'

成功响应200 OK

json

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

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