← 返回首页

接口文档

基础地址 https://jxapi.java68.cn · 稳定版前缀 /v1

1. 鉴权

所有 /v1 业务接口需带 Key,二选一:Authorization: Bearer vt_live_xxx或 X-API-Key: vt_live_xxx。

curl -X POST https://jxapi.java68.cn/v1/parse \
  -H "Authorization: Bearer $VT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://v.douyin.com/xxxx/","request_id":"demo-1"}'

2. 统一响应

{ "code": 0, "msg": "ok", "request_id": "req_ab12", "cost": 1, "data": { ... } }

cost 是本次计费次数,失败恒为 0。同一个 request_id 24 小时内只扣一次费。

3. 解析单条

POST /v1/parse
{ "url": "分享链接或整段文案", "author_sec_uid": "可选", "request_id": "建议传" }

→ { "code": 0, "cost": 1, "data": {
      "type": "video", "title": "…", "author": "…",
      "cover": "…", "video_url": "…", "images": [], "live_videos": [] } }

视频直链下载必须带 Referer: https://www.douyin.com/,否则 CDN 403。

4. 主页批量

POST /v1/douyin/home
{ "sec_uid": "MS4wLjABAAAA…", "cursor": 0, "count": 20 }

按成功返回条数计费,单页最低 10 条;仅包月专业及以上可用。

5. 错误码

code含义计费
0成功是
1001Key 无效/停用否
1002额度不足否
1003限流(看 Retry-After)否
2001链接无法识别否
2002作品不存在或已删除否
3001上游暂时失败,可重试否
5000内部错误否

6. 计费规则

OpenAPI 规范: openapi.yaml(可直接导入 Postman / Apifox / Swagger UI)
需要更大额度或更高并发?查看套餐