Douyin Fetch User Post Videos
Retrieve videos posted on a Douyin user's profile, with pagination and optional popularity ordering. Inputs: - sec_user_id (required string): the user's Douyin sec_user_id. - max_cursor (optional string, default "0"): use "0" for the first page, then use the max_cursor returned by the previous response. - count (optional integer, default 20): requested number of items per page; keeping it at 20 or fewer is recommended. - filter_type (optional string, default "0"): "0" for default ordering or "3" for popularity ordering. - cookie (optional string): the user's own Douyin web Cookie. Returns: a response containing the user's posted-video data in data. The detailed structure of this data is not specified; use a returned max_cursor, when available, to request the next page. This web-based retrieval may be unstable.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
count | integer | No | 每页数量/Number per page | 20 |
cookie | string | No | 用户网页版抖音Cookie/Your web version of Douyin Cookie | — |
max_cursor | string | No | 最大游标/Maximum cursor | 0 |
filter_type | string | No | 过滤类型/Filter type | 0 |
sec_user_id | string | Yes | 用户sec_user_id/User sec_user_id | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_fetch_user_post_videos' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"count": 20,
"filter_type": "3",
"max_cursor": "31898653285",
"sec_user_id": "MS4wLjABAAAAwmvtEgbmHaL1vqo8J1HFEOxptyBrI6fFLcVt1BD0E5lXotSruUIo78HhqY8I4GuL"
}
}'{
"code": 200,
"data": {
"aweme_list": [],
"has_more": 0,
"log_pb": {
"impr_id": "2026111118135169D7F199A9383691127A"
},
"max_cursor": 0,
"min_cursor": 1794392031000,
"post_serial": 2
},
"docs": "https://api.tikhub.io/#/Douyin-Web-API/fetch_user_post_videos_api_v1_douyin_web_fetch_user_post_videos_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"count": "20",
"filter_type": "3",
"max_cursor": "31898653285",
"sec_user_id": "MS4wLjABAAAAwmvtEgbmHaL1vqo8J1HFEOxptyBrI6fFLcVt1BD0E5lXotSruUIo78HhqY8I4GuL"
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

