接入流程
视频信息
POST /api/douyin/detail
字幕 · 语音转录
POST /api/transcribe/submit
GET /api/transcribe/{job_id}
用户资料
POST /api/douyin/user/detail
典型用法
作品详情
POST /api/douyin/detail — 公开作品链接或分享文案解析。
综合搜索
POST /api/douyin/search — 关键词综合搜索，支持 cursor 翻页。
用户资料
POST /api/douyin/user/detail — sec_user_id 或主页链接。
用户搜索
POST /api/douyin/user/search — 按关键词搜索用户。
用户作品
POST /api/douyin/user/works — 用户作品列表，支持分页。
语音转录
无原生字幕接口；字幕请 POST /api/transcribe/submit。
复制就能跑
把 YOUR_API_KEY 换成控制台密钥。先 POST /api/douyin/detail 取作品信息；需要字幕时 POST /api/transcribe/submit 提交转录，再 GET /api/transcribe/{job_id} 查询结果。
import requests
API_BASE = "https://www.dataspider.ai/api"
HEADERS = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
}
detail = requests.post(
f"{API_BASE}/douyin/detail",
headers=HEADERS,
json={"url": "https://www.douyin.com/video/7123456789012345678"},
)
print(detail.json())
job = requests.post(
f"{API_BASE}/transcribe/submit",
headers=HEADERS,
json={
"source": {"type": "platform_url", "url": "https://www.douyin.com/video/7123456789012345678"},
"engine": "paraformer",
"language": "",
"enable_speaker": False,
},
).json()["data"]
print(job)
result = requests.get(f"{API_BASE}/transcribe/{job['job_id']}", headers=HEADERS)
print(result.json())
JSON 响应
response.json
{
"code": 200,
"message": "ok",
"success": true,
"data": {
"aweme_detail": {
"aweme_id": "7123456789012345678",
"desc": "示例作品描述",
"author": {
"nickname": "示例"
}
}
}
}返回内容
视频数据
- 标题、作者、简介
- 时长与封面
- 作品 ID 与统计字段
- 公开链接解析
语音转录（字幕）
- 提交抖音视频链接到转录任务
- 轮询任务状态并下载结果
- 返回带起止时间的文本分段
- 与 YouTube、TikTok 共用同一套转录任务接口
浏览其他平台
