🔌 开放 API 开发者文档

🎫 获取你的 API Key

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

POSTGET/api/v1/parse

核心解析接口。POST 传 JSON {"url": "..."}，或 GET 传 ?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.qiaiwan.top/api/v1/balance" -H "Authorization: Bearer dpk_xxxxxxxx"

POST/api/v1/redeem

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

curl -X POST "https://www.qiaiwan.top/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 字段为准；请求失败（code≠0）不扣次数；余额不足返 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.qiaiwan.top/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.qiaiwan.top/api/pro/kuaishou/user?url=https://www.kuaishou.com/profile/3xwghd2fbbtswdy" \
  -H "Authorization: Bearer dpk_xxxxxxxx"

GET/api/pro/kuaishou/comments

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

curl "https://www.qiaiwan.top/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.qiaiwan.top/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.qiaiwan.top/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.qiaiwan.top/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.qiaiwan.top/api/pro/kuaishou/collect?url=https://www.kuaishou.com/profile/3xwghd2fbbtswdy&count=20" \
  -H "Authorization: Bearer dpk_xxxxxxxx"

🚦 快手接口错误码

⚙️ 客户端配置

把 dpk_xxxxxxxx 换成你的 API Key。注意 URL 结尾的斜杠 /mcp/ 不能省。

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

Cursor 用户填 Settings → MCP → Add new global MCP server，内容同上（mcpServers 里那一段）。

🧰 可用工具

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

🎁 兑换充值码 / 查余额

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

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