sec_user_idstringrequired
User sec_user_id
https://api.sandbase.ai/v1/api/douyin/app-v3/user-post-videosGet the videos on a Douyin user's profile with descriptions, publish time and play, like, comment and share counts. Sort by latest or most popular, with cursor pagination.
[
{
"data": {
"aweme_list": [],
"extra": {
"fatal_item_ids": [],
"logid": "202608201745362BFA943A600E44438037",
"now": 1787219136000
},
"has_more": 0,
"log_pb": {
"impr_id": "202608201745362BFA943A600E44438037"
},
"max_cursor": 0,
"min_cursor": 1787219136000,
"post_serial": 3,
"replace_series_cover": 1,
"request_item_cursor": 0,
"sec_uid": "example",
"status_code": 0,
"status_msg": "",
"uid": "1526545566403343",
"version": "normal"
}
}
]Select an example to load its inputs and result into the playground.
Returns the videos on a Douyin user's profile, with descriptions, publish time and play, like, comment and share counts. You pass the user's sec_user_id. You can sort by latest or most popular and page through the list with a cursor.
create_time of each video.sort_type set to 1.curl -X POST "https://api.sandbase.ai/v1/api/douyin/app-v3/user-post-videos" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sec_user_id": "MS4wLjABAAAAKzTVRAaDq7fTxkJteVYjRsyVPxxofLDAyViyWT43BNRdTjgmqCcolsU_UqRgbzBU", "count": 5, "max_cursor": 0, "sort_type": 0}'
The result is returned in outputs[0].data.
| Name | Type | Required | Description |
|---|---|---|---|
sec_user_id | string | Yes | User sec_user_id |
count | integer | No | Maximum count number, do not exceed 20, it is recommended to keep it unchanged. |
max_cursor | integer | No | Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response. |
sort_type | integer | No | Sort type, optional values are as follows: 0: Latest sorting - default; 1: Hottest sorting |
Historical provider response sample, trimmed: lists keep their first item and long strings are cut. The explicit first-page teaching request above was not re-run for this update.
{
"aweme_list": [
{
"activity_video_type": -1,
"admire_auth": {
"admire_button": 1,
"author_can_admire": 0,
"exit_admire_in_aweme_post": 0,
"is_admire": 0,
"is_click_admire_icon_recently": 0,
"is_fifty_admire_author_stable_fans": 0,
"is_iron_fans_in_aweme_post": 0,
"is_show_admire_button": 0
},
"anchors": null,
"authentication_token": "MS4wLjAA…",
"author": {
"account_cert_info": "{}",
"allow_story_normal_like": false,
"authority_status": 0,
"avatar_168x168": {
"height": 720,
"uri": "168x168/aweme-avatar/tos-cn-i-0813c000-ce_oQeCKAiB7QKAW81fnHIATQDRAl2FEJtuEglF4f",
"url_list": [
"https://p3.douyinpic.com/img/aweme-avatar/tos-cn-i-0813c000-ce_oQeCKAiB7QKAW81fn…"
],
"width": 720
},
"avatar_300x300": {
"height": 720,
"uri": "300x300/aweme-avatar/tos-cn-i-0813c000-ce_oQeCKAiB7QKAW81fnHIATQDRAl2FEJtuEglF4f",
"url_list": [
"https://p3.douyinpic.com/img/aweme-avatar/tos-cn-i-0813c000-ce_oQeCKAiB7QKAW81fn…"
],
"width": 720
},
"avatar_larger": {
"height": 720,
"uri": "1080x1080/aweme-avatar/tos-cn-i-0813c000-ce_oQeCKAiB7QKAW81fnHIATQDRAl2FEJtuEglF…",
"url_list": [
"https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-0813c000-ce_oQeCK…"
],
"width": 720
},
"avatar_medium": {
"height": 720,
"uri": "720x720/aweme-avatar/tos-cn-i-0813c000-ce_oQeCKAiB7QKAW81fnHIATQDRAl2FEJtuEglF4f",
"url_list": [
"https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-i-0813c000-ce_oQeCKAi…"
],
"width": 720
},
"avatar_thumb": {
"height": 720,
"uri": "100x100/aweme-avatar/tos-cn-i-0813c000-ce_oQeCKAiB7QKAW81fnHIATQDRAl2FEJtuEglF4f",
"url_list": [
"https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-0813c000-ce_oQeCKAi…"
],
"width": 720
}
},
"author_mask_tag": 0,
"author_user_id": 7565728661744845873,
"aweme_acl": {
"download_mask_panel": {
"code": 1,
"show_type": 0
}
},
"aweme_control": {
"can_comment": true,
"can_forward": true,
"can_share": true,
"can_show_comment": true
},
"aweme_id": "7701251112510949029",
"aweme_listen_struct": {
"listen_diversion": {
"extra": [
{
"key": "new_guide_prefix",
"val": "下载汽水"
}
],
"popup_scene": 4,
"side_desc": "听更多精彩内容",
"sub_title_type": "relation"
},
"trace_info": "{\"copyright_not_speech\":\"false\",\"copyright_reason\":\"has_listen_cp_new\",\"copyrigh…"
},
"aweme_type": 0
}
],
"extra": {
"fatal_item_ids": [],
"logid": "2026110315314151CAD125368591AA2FC7",
"now": 1793691101000
},
"has_more": 1,
"log_pb": {
"impr_id": "2026110315314151CAD125368591AA2FC7"
},
"max_cursor": 1793087105000,
"min_cursor": 1793087254000,
"post_serial": 3,
"replace_series_cover": 1,
"request_item_cursor": 0,
"sec_uid": "MS4wLjABAAAAKzTVRAaDq7fTxkJteVYjRsyVPxxofLDAyViyWT43BNRdTjgmqCcolsU_UqRgbzBU",
"status_code": 0,
"status_msg": ""
}
| Field | Meaning |
|---|---|
aweme_list[] | One entry per video on the user's profile. |
aweme_list[].aweme_id | The video ID, returned as a string of digits. |
aweme_list[].create_time | Publish time of the video, as a 10-digit number such as 1793087254. |
aweme_list[].desc | The video description text. It is an empty string when the creator wrote none. |
aweme_list[].author_user_id | Numeric ID of the user who posted the video. |
aweme_list[].author.avatar_168x168.url_list / author.avatar_300x300.url_list / author.avatar_thumb.url_list | Avatar image URLs of the author at different sizes. Each list holds a .heic and a .jpeg link. |
aweme_list[].aweme_control.can_comment / can_forward / can_share | Booleans that show whether commenting, forwarding and sharing are allowed on the video. |
aweme_list[].commerce_info.is_ad | Boolean that shows whether the video is marked as an ad. |
aweme_list[].city | A city code attached to the video, such as 410100. |
count should not exceed 20. The schema does not declare a numeric default; this teaching request explicitly uses 5.sort_type is 0 for latest first (default) and 1 for hottest first.max_cursor as 0. For the next page, send the max_cursor value from the previous response.aweme_id values to Douyin Video Statistics (Batch), which takes comma-separated video IDs.$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.
Pass the known creator's sec_user_id and set integer max_cursor to 0 for the first page. Set sort_type to 0 for latest or 1 for hottest, according to the current schema. The count description says not to exceed 20 but does not declare a numeric default. The teaching request explicitly asks for 5 items; this is a small requested limit, not a guaranteed result count or a provider default.
Read aweme_list only after checking provider status. An empty array is a returned empty page; a missing array is an unexpected payload. A first page is not the creator's entire catalogue. Compare the returned order and dates with your task before treating it as a posting history, and do not rank creators from unverified play_count values.
The reference documents max_cursor from the previous response for continuation and shows has_more. This update does not revalidate continuation and does not automatically request another page, batch video statistics or model analysis. Stop after the first response and review any next step and its cost separately.
Use User Profile if you need to review the selected account's profile instead of its posts.
Already have a key? Keep SANDBASE_API_KEY in your local environment and open this page's API tab for the POST /v1/api/ request and Bearer header. Already connected an agent? Give it the selected endpoint and the creator's sec_user_id. For a new project, share the setup Skill, Markdown quickstart and your task. Ask it to make one request and save the response before adding any research workflow.
The saved Playground input may contain the placeholder example. Replace it with the intended creator's sec_user_id before running. The API tab uses a schema example for teaching when the saved value is a placeholder; that example is not a promise that the creator remains available. These public-data requests do not provide access to a private account, an account's management tools or TikTok's separate API.
From a completed SandBase response, read outputs[0].data. In the dated reference samples, Douyin uses integer status_code 0 for success, with a user object for the profile or an aweme_list array for videos. Check that provider status and the expected field before using the data; HTTP 200 alone is insufficient. Preserve missing fields as unknown and treat explicit zero counters as provider-returned values, not independently verified audience measurements.
Pricing checked on 2026-11-08: both selected endpoints list $0.001 per call and eligibility for the organization's 100 daily free data API calls, shared across eligible APIs and reset at 00:00 UTC. Eligibility is not remaining allowance. Inspect current pricing and quota before executing. This update made no new business calls. The Douyin Python integration guide separates the bounded first request from dated historical research.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/douyin/app-v3/user-post-videos" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"sec_user_id": "MS4wLjABAAAAKzTVRAaDq7fTxkJteVYjRsyVPxxofLDAyViyWT43BNRdTjgmqCcolsU_UqRgbzBU",
"count": 5,
"max_cursor": 0,
"sort_type": 0
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
sec_user_idstringrequiredUser sec_user_id
countintegerMaximum count number, do not exceed 20, it is recommended to keep it unchanged.
max_cursorintegerMaximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.
sort_typeintegerSort type, optional values are as follows: `0`: Latest sorting - default; `1`: Hottest sorting
Saved example response for this API; no live request is made when viewing it.
[
{
"data": {
"aweme_list": [],
"extra": {
"fatal_item_ids": [],
"logid": "202608201745362BFA943A600E44438037",
"now": 1787219136000
},
"has_more": 0,
"log_pb": {
"impr_id": "202608201745362BFA943A600E44438037"
},
"max_cursor": 0,
"min_cursor": 1787219136000,
"post_serial": 3,
"replace_series_cover": 1,
"request_item_cursor": 0,
"sec_uid": "example",
"status_code": 0,
"status_msg": "",
"uid": "1526545566403343",
"version": "normal"
}
}
]Explore more
| API | Price | Response |
|---|---|---|
Douyin User VideosThis API Douyin | $0.001 per call | JSON |
Douyin | $0.001 per call | JSON |
Douyin | $0.001 per call | JSON |
Douyin | $0.001 per call | JSON |
Douyin | $0.001 per call | JSON |
Douyin | $0.001 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/douyin/app-v3/user-post-videos with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
$0.001 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.
Required: sec_user_id (string). Optional: count (integer), max_cursor (integer) and sort_type (integer). The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
No. Douyin User Videos runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.
Use the intended sec_user_id, integer max_cursor 0 and sort_type 0 for latest or 1 for hottest. The count description allows no more than 20 but declares no numeric default. The teaching example explicitly requests 5 and makes one call.
No. The returned aweme_list is one page. Missing metrics remain unknown and explicit zero values are provider-returned observations, not an independent measure of actual plays. This first request does not start continuation or batch statistics calls.
The selected schema uses sec_user_id with SandBase Bearer authentication and has no Douyin cookie field. Share the setup Skill and endpoint with your agent and keep your key locally. Check pricing and remaining quota first; eligibility for shared daily free calls does not guarantee this request is free.