---
document_id: agent.collection.task.douyin_user_post_videos_v1
schema_version: 2
parent_document_id: agent.querying
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Creator posts / 创作者作品

Fetch a Douyin creator's posts by sec_uid. For one video's full data use douyin_video_detail_v1; for comments use douyin_video_comments_v1.

按作者 sec_uid 获取抖音创作者的作品列表。要取单个视频的完整数据用 douyin_video_detail_v1,要取评论用 douyin_video_comments_v1。

Task / 任务: `douyin_user_post_videos_v1`
Platform / 平台: Douyin / 抖音
Billing / 计费: 3 Credits per successful task / 每个成功任务 3 Credits
Estimate / 估价: call `estimate_collection`; start directly when `approval_required=false`, otherwise obtain approval for `upper_bound_credits`.
估价：调用 `estimate_collection`；`approval_required=false` 时直接启动，否则请用户确认 `upper_bound_credits`。

## Limitations / 限制

- 每次只获取一页;首次 cursor 留空(内部按 0 请求),后续把返回的 next_cursor 原样传回;只有严格前进的游标会继续发布。
- count 只能是 1 到 20;cursor 是非负 64 位整数的十进制字符串,长度最多 19 位。
- sort_type 0 为最新,1 为最热视频;channel 只能是 normal 或 lite。
- 不承诺返回作者的全部历史作品;私密、删除、地区限制或上游未返回的作品不在范围内。

## Inputs / 输入

- `author_sec_id` — Author sec_uid / 作者 sec_uid; kind=text; required=True; default=''; bounds=min_length=1, max_length=128
- `cursor` — Cursor / 翻页游标; kind=cursor; required=False; default=''; bounds=max_length=19
- `count` — Page size / 每页条数; kind=integer; required=False; default=20; bounds=min=1, max=20
- `sort_type` — Sort / 排序; kind=select; required=False; default=0; allowed=0, 1
- `channel` — Channel / 请求通道; kind=select; required=False; default='normal'; allowed=normal, lite

## Minimal call / 最小调用

`estimate_collection`

```json
{
  "task_query": "获取指定抖音作者的作品列表",
  "task_code": "douyin_user_post_videos_v1",
  "input": {
    "author_sec_id": "<搜索结果返回的 author_sec_id>",
    "cursor": "",
    "count": 20,
    "sort_type": 0,
    "channel": "normal"
  }
}
```


## Result and pagination / 结果与分页

- mode=cursor
- input: `cursor`; continuation: `data.has_more` → `data.next_cursor`

Only the fields listed below are part of the stable result contract. /
只有下方列出的字段属于稳定结果契约。

## Result fields / 结果字段

- `meta.request_id` — type=string; Asklear request identifier for tracing. / 用于追踪的 Asklear 请求 ID。
- `meta.api_name` — type=string; Executed collection operation name. / 实际执行的采集操作名称。
- `meta.latency_ms` — type=integer; Collection execution latency in milliseconds. / 采集执行耗时（毫秒）。
- `meta.credits_charged` — type=integer; Asklear user-side Credits settled for this task after completion. / 任务完成后 Asklear 用户侧实际结算的 Credits。
- `data.items` — type=array<object>; Creator videos returned by this page. / 本页返回的创作者视频。
- `data.item_count` — type=integer; Number of videos in this response page. / 本页返回的视频数。
- `data.has_more` — type=boolean; Whether another page is available and has a valid decimal-string cursor that advances the request. / 是否还有下一页且已返回严格前进的有效十进制字符串游标。
- `data.next_cursor` — type=string|null; Decimal-string cursor to pass back to the same task when has_more is true; it strictly advances the requested cursor. / has_more 为 true 时传回同一任务且严格前进的十进制字符串游标。
- `data.items[].video_id` — type=string|integer; Douyin video identifier. / 抖音视频 ID。
- `data.items[].title` — type=string|null; Video title or description. / 视频标题或描述。
- `data.items[].published_at` — type=integer|null; Publication time as Unix seconds. / 以 Unix 秒表示的发布时间。
- `data.items[].published_at_text` — type=string|null; Original publication-time text when supplied. / 上游提供的原始发布时间文本。
- `data.items[].share_url` — type=string|null; Public video share URL when supplied. / 如上游提供则返回视频公开分享链接。
- `data.items[].play_count` — type=scalar|null; Play count when supplied. / 如上游提供则返回播放数。
- `data.items[].digg_count` — type=scalar|null; Like count when supplied. / 如上游提供则返回点赞数。
- `data.items[].comment_count` — type=scalar|null; Comment count when supplied. / 如上游提供则返回评论数。
- `data.items[].share_count` — type=scalar|null; Share count when supplied. / 如上游提供则返回分享数。
- `data.items[].author_id` — type=scalar|null; Author identifier when supplied. / 如上游提供则返回作者 ID。
- `data.items[].author_sec_id` — type=string|null; Author sec_uid when supplied. / 如上游提供则返回作者 sec_uid。
- `data.items[].author_name` — type=string|null; Author display name when supplied. / 如上游提供则返回作者名称。
- `data.items[].is_top` — type=scalar|null; Whether the creator marked the video as pinned, when supplied. / 如上游提供则返回该作品是否置顶。

Use `list_collection_tasks` as the runtime authority, then `describe_collection_task` for one task's full input contract, examples and limits. Collection access is entitlement-gated. /
以 `list_collection_tasks` 返回为运行时准据，再用 `describe_collection_task` 取单个任务的完整入参契约、示例与限制；采集能力受 entitlement 控制。