抖音用户作品
douyin-worksPOSTPOST
https://v1.apizero.cn/api/douyin-works概述
采集抖音用户公开作品，返回前 10～20 条作品页链接、标题、作者、点赞、播放、时长与封面。支持图集。 调用方传入抖音网页登录 Cookie（须含 sessionid），文本或 JSON 均可。
调用约定
- 网关 ·
https://v1.apizero.cn - 鉴权 ·
Authorization: Bearer <API Key> - 回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。
/aidocs/douyin-works/raw.md鉴权
Cookie 传完整字符串即可（须含 sessionid），表单文本或 JSON 都可以，不必拆成多个字段。也可放 Header X-Douyin-Cookie。GET 时请把整段 cookie URL 编码。
获取 API Key：/account/keys
请求头
| Header | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 否 | 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
请求参数
POST · APPLICATION/JSON
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| url | string | 否 | 抖音用户主页链接（短链或长链）。与 sec_user_id 二选一 | https://www.douyin.com/user/MS4wLjABAAAA... |
| sec_user_id | string | 否 | 网页用户 ID。与 url 二选一；也认 sec_uid | MS4wLjABAAAA... |
| cookie | string | 是 | 抖音网页登录后的完整 Cookie，整段传入（须含 sessionid）。文本或 JSON 均可，不要拆成 sessionid / ttwid 等多个字段 | ttwid=...; sessionid=... |
| count | int | 否 | 返回条数 1–20，默认 10 | 10 |
| max_cursor | int | 否 | 翻页游标，默认 0；下一页传上次的 next_cursor | 0 |
{
"url": "https://www.douyin.com/user/MS4wLjABAAAA...",
"sec_user_id": "MS4wLjABAAAA...",
"cookie": "ttwid=...; sessionid=...",
"count": 10,
"max_cursor": 0
}返回结果
顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id
| 字段 | 类型 | 说明 |
|---|---|---|
| sec_user_id | string | 解析后的用户 ID |
| count | int | 本次实际条数 |
| asked | int | 本次请求的 count |
| max_cursor | int | 本次翻页起点 |
| next_cursor | int | 下一页游标，传给 max_cursor |
| has_more | bool | 是否还有下一页 |
| author | object | 作者摘要：sec_uid / unique_id / nickname / avatar |
| list | array | 作品卡片：aweme_id / title / media_type / video_url / share_url / cover_url / images / author_name / like_count / comment_count / share_count / collect_count / play_count / duration / duration_text / is_top / publish_ts / publish_time |
| source | object | 数据来源说明 |
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn |
返回示例
{
"list": [
{
"title": "2026年618什么手机值得买？",
"images": [],
"is_top": false,
"aweme_id": "7512345678901234567",
"duration": 847,
"cover_url": "https://p3-pc-sign.douyinpic.com/example.jpeg",
"video_url": "https://www.douyin.com/video/7512345678901234567",
"like_count": 116000,
"media_type": "video",
"play_count": 890000,
"author_name": "小白测评",
"publish_time": "2026-05-20 12:00:00",
"duration_text": "14:07"
}
],
"asked": 10,
"count": 10,
"author": {
"avatar": "https://p3.douyinpic.com/example.jpeg",
"sec_uid": "MS4wLjABAAAA...",
"nickname": "小白测评",
"unique_id": "example"
},
"has_more": true,
"max_cursor": 0,
"next_cursor": 1758711687000,
"sec_user_id": "MS4wLjABAAAA...",
"tips": "极数本源 · https://apizero.cn"
}请求示例
将 YOUR_API_KEY 替换为真实 Key 后运行。
curl -X POST "https://v1.apizero.cn/api/douyin-works" -H "Authorization: Bearer $APIZERO_KEY" -H "Content-Type: application/json" -d '{
"url": "https://www.douyin.com/user/MS4wLjABAAAA...",
"sec_user_id": "MS4wLjABAAAA...",
"cookie": "ttwid=...; sessionid=...",
"count": "10",
"max_cursor": "0"
}'错误码
先看业务 code。HTTP 也可能不是 200。
| 业务码 | HTTP | 说明 |
|---|---|---|
| 0 | 200 | 成功 |
| 4000 | 400 | 参数错误 |
| 4011 | 401 | API Key 无效 |
| 4013 | 403 | API Key 已暂停 |
| 4014 | 403 | 当前 IP 不在 Key 白名单 |
| 4015 | 401 | 此接口需要 API Key |
| 4022 | 402 | 余额不足 |
| 4029 | 429 | 调用过快（QPS） |
| 4030 | 429 | 今日免费额度已用完 |
| 4040 | 503 | 接口已下线 |
| 4041 | 404 | 接口不存在 |
| 5000 | 500 | 服务器内部错误 |
| 5020 | 502 | 上游暂时不可用 |
| 5021 | 502 | 上游返回格式异常 |
| 5030 | 502 | 暂无可用节点 |
调用限制
| 计费模式 | 完全免费 |
|---|---|
| QPS 限制 | 2 req/s |
| 登录免费额度 | 20 次（已认证） |
| 匿名每日额度 | 2 次（无 API Key） |
| 黄金会员 | 每日 50000 次 · QPS 10 |
| 企业会员 | 会员免费（未配置日上限）· QPS 120 |
购买套餐、看评价请走商城详情。 购买 / 调试
更新日志
- 1.0.22026-09-05
出站代理由服务端实现，调用方无需传入
- 1.0.12026-09-05
Cookie 支持整段文本与 JSON，不必拆字段
- 1.0.02026-09-05
上架独立接口：按用户主页采集公开作品卡片（最多 20 条） Cookie 由调用方传入，服务端不存登录态
免责声明
仅返回抖音用户主页中的公开作品链接与公开字段，供检索、研究与合规审核。禁止用于侵权抓取、批量搬运或绕过平台限制。数据以抖音实时返回为准。Cookie 由调用方自行提供，本服务不存储登录态。