🔌 开放 API 开发者文档

🎫 获取你的 API Key

Key 跟随账号：在个人中心注册后自动发放首把 Key（赠试用次数），换设备不丢、可多把分项目使用。账号制之前匿名领过的 Key 继续有效，可在下方查余额/兑换，或登录个人中心绑定到账号。

POSTGET/api/v1/parse

核心解析接口。POST 传 JSON {"url": "..."}，或 GET 传 ?url=...。支持分享文本、短链、完整链接。

🎵 背景音乐 / 原声 MP3 直链

抖音作品的原声 MP3 已随解析结果一起返回，一步到位。

解析抖音作品时，服务端会用 data.music.mid 向平台换取原声文件，并回填到 data.music.play_url。它是 douyinstatic.com 上的静态 MP3（Content-Type: audio/mpeg），无签名、不校验 Referer，拿到即可直接下载，字节不经本站中转：

# 1. 解析并保存响应
curl -s -X POST "https://www.qimiaowan.com/api/v1/parse" \
  -H "Authorization: Bearer dpk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://v.douyin.com/xxxxxx/"}' > result.json

# 2. 直接下载原声 MP3（空值代表这条没有可用音频直链）
MP3=$(jq -r '.data.music.play_url // ""' result.json)
if [ -n "$MP3" ]; then curl -L -o music.mp3 "$MP3"; fi

返回片段示例（示例 CDN 地址不可下载）：

{
  "platform": "douyin",
  "music": {
    "title": "原声 - 作者名",
    "author": "作者名",
    "mid": "7623343147089824527",
    "play_url": "https://lf26-music-east.douyinstatic.com/obj/ies-music-hj/xxx.mp3",
    "play_url_backup": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/xxx.mp3"
  }
}

什么情况下 play_url 为空：非抖音平台上游不提供独立音频文件（小红书、快手、B站等），如需音频请下载 play_url 视频后自行抽轨，本接口不提供服务端抽轨；版权方禁止下载、上游接口临时风控时也可能为空，稍后重新解析即可。旧版 mid → /api/music/direct 两步法仍可用，但那是网页内部接口、按 IP 限流，开放 API 请直接读 play_url。

商品混合素材（aweme_type = product）

同一个 /api/v1/parse 接口支持抖音商品分享文本、v.douyin.com 短链和 haohuo.jinritemai.com 商品长链，无需单独的商品端点。短链由服务端识别最终内容类型。

以下字段位于 data.product。商品视频可能为 0 条或多条，详情图可为空数组；无视频不代表解析失败。

商品 data 示例（仅展示相关字段，示例 CDN 地址不可下载）：

{
  "aweme_type": "product",
  "platform": "douyin",
  "aweme_id": "3811124822906372482",
  "desc": "商品标题",
  "cover": "https://cdn.example.com/main.webp",
  "play_url": "https://cdn.example.com/video.mp4",
  "images": [
    "https://cdn.example.com/main.webp",
    "https://cdn.example.com/detail.jpeg"
  ],
  "product": {
    "product_id": "3811124822906372482",
    "shop_name": "店铺名称",
    "videos": [{
      "url": "https://cdn.example.com/video.mp4",
      "cover": "https://cdn.example.com/video-cover.webp",
      "width": 1080,
      "height": 1080
    }],
    "main_images": ["https://cdn.example.com/main.webp"],
    "detail_images": ["https://cdn.example.com/detail.jpeg"]
  }
}

无视频商品仍返回 aweme_type: "product"，同时 play_url: ""、product.videos: []；图片可照常展示和下载。

GET/api/v1/balance

查询 Key 状态。返回 balance（剩余调用次数；Key 已绑账号时为账号共享池余额，与网页超额解析通用、名下所有 Key 共用）、rpm（每分钟限频）、today_used（今日已用）。

curl "https://www.qimiaowan.com/api/v1/balance" -H "Authorization: Bearer dpk_xxxxxxxx"

POST/api/v1/redeem

兑换充值码加次数（一码一用；Key 已绑账号时充入账号共享池）。Body：{"code": "XXXXXXXXXXXX"}。

curl -X POST "https://www.qimiaowan.com/api/v1/redeem" \
  -H "Authorization: Bearer dpk_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"code": "XXXXXXXXXXXX"}'

🔐 鉴权与计费（快手为按次计费功能）

💰 扣费次数：列表类 posts / likes / collect 每次调用扣 3 次；信息类 user / comments / replies / live 每次调用扣 1 次。 实际扣减以响应里的 cost 字段为准；我们侧失败（风控 / 网络 / 服务异常）不扣次数，链接本身不可用（fail_side:"link"）照常扣 1 次；余额不足返 1402。

GET/api/pro/kuaishou/posts

主页作品列表（核心）。返回作者主页的作品（视频/图集）列表；监控场景用 aweme_id+create_time 判断新增。 无水印下载：拿 aweme_id 拼作品链接调 /api/v1/parse。仅开放 API-Key 调用：必须携带 Authorization: Bearer <Key>，无 Key 返 1401（网页入口已下线）。

curl "https://www.qimiaowan.com/api/pro/kuaishou/posts?url=https://www.kuaishou.com/profile/3xwghd2fbbtswdy&count=20" \
  -H "Authorization: Bearer dpk_xxxxxxxx"

GET/api/pro/kuaishou/user

作者主页信息（免签名，快）。返回粉丝/作品/获赞等公开数据。

curl "https://www.qimiaowan.com/api/pro/kuaishou/user?url=https://www.kuaishou.com/profile/3xwghd2fbbtswdy" \
  -H "Authorization: Bearer dpk_xxxxxxxx"

GET/api/pro/kuaishou/comments

作品评论导出（免签名，快）。返回某作品的评论列表 + 总数。

curl "https://www.qimiaowan.com/api/pro/kuaishou/comments?url=https://www.kuaishou.com/short-video/3x2qchb3zj6v869&count=20" \
  -H "Authorization: Bearer dpk_xxxxxxxx"

GET/api/pro/kuaishou/replies

评论回复导出（免签名，快）。拉某条根评论下的回复；返回结构同 comments。

curl "https://www.qimiaowan.com/api/pro/kuaishou/replies?url=https://www.kuaishou.com/short-video/3x2qchb3zj6v869&cid=1179363630087" \
  -H "Authorization: Bearer dpk_xxxxxxxx"

GET/api/pro/kuaishou/live

直播回放列表（免签名，快）。返回作者的直播回放；items[] 结构同 posts（aweme_id=回放 photoId）。

curl "https://www.qimiaowan.com/api/pro/kuaishou/live?url=https://www.kuaishou.com/profile/3xwghd2fbbtswdy" \
  -H "Authorization: Bearer dpk_xxxxxxxx"

GET/api/pro/kuaishou/likes

喜欢列表（浏览器签名，稍慢）。对方未公开喜欢时 items 为空（code=0，属平台隐私，非错误）。

curl "https://www.qimiaowan.com/api/pro/kuaishou/likes?url=https://www.kuaishou.com/profile/3xwghd2fbbtswdy&count=20" \
  -H "Authorization: Bearer dpk_xxxxxxxx"

GET/api/pro/kuaishou/collect

收藏列表（浏览器签名，稍慢）。收藏多为私密，通常 items 为空（code=0，非错误）。

curl "https://www.qimiaowan.com/api/pro/kuaishou/collect?url=https://www.kuaishou.com/profile/3xwghd2fbbtswdy&count=20" \
  -H "Authorization: Bearer dpk_xxxxxxxx"

🚦 快手接口错误码

GET/api/v1/xhs/user/notes

计费：每次成功调用扣 3 次； 参数错误 / 用户不可访问 / 服务异常不扣。余额不足返 1402。

curl "https://www.qimiaowan.com/api/v1/xhs/user/notes?url=https://www.xiaohongshu.com/user/profile/xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Authorization: Bearer dpk_xxxxxxxx"

# 每 10 分钟查第一页，用 note_id 集合做新视频检测（伪代码）
seen = set()
while True:
    r = GET /api/v1/xhs/user/notes?user_id=<24位ID>
    for it in r["data"]["items"]:
        if it["type"] == "video" and not it["is_pinned"] and it["note_id"] not in seen:
            print("新视频", it["note_id"], it["create_time"], it["title"])
    seen.update(x["note_id"] for x in r["data"]["items"])
    sleep(600)

⚙️ 客户端配置

想省事点按钮一键装进 Cursor / VS Code；用别的 IDE 就用下面的通用配置。不同客户端的配置文件格式不完全一样：多数用顶层 mcpServers，VS Code 的 .vscode/mcp.json 用 servers，Claude Desktop 需 mcp-remote 桥接，图形界面客户端只填 URL。

{
  "mcpServers": {
    "douparse": {
      "type": "http",
      "url": "https://www.qimiaowan.com/mcp/",
      "headers": { "Authorization": "Bearer dpk_xxxxxxxx" }
    }
  }
}

注意 URL 结尾的斜杠 /mcp/ 不能省；Cursor 用户也可填 Settings → MCP → Add new global MCP server。

🧰 可用工具

支持平台同开放 API：抖音、快手、小红书、B站、视频号、微博、知乎等 10+ 平台。

🎁 兑换充值码 / 查余额

已有 Key？在这里直接兑换充值码或查询余额（Key 只保存在你的浏览器本地）。

没有充值码？到 个人中心 的「充值 / 购买次数」扫码支付，到账自动加次数。