Douyin User Videos

API docs
https://api.sandbase.ai/v1/api/douyin/app-v3/user-post-videos

Get 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.

Price
$0.001USD / call
Method
POST
Response
JSON
Parameters
1 required · 3 optional
100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.

Playground

Input
User sec_user_id
Maximum count number, do not exceed 20, it is recommended to keep it unchanged.
Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.
Sort type, optional values are as follows: `0`: Latest sorting - default; `1`: Hottest sorting
OutputExample
Responseoutputs · 581 B · 26 lines
[
  {
    "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"
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

API README

Douyin User Videos API

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.

Use cases

  • Track how often a Douyin creator posts by reading the create_time of each video.
  • Review an influencer's recent videos before a campaign.
  • Collect a brand account's videos and descriptions for content analysis.
  • Pull the most popular videos of an account with sort_type set to 1.

Request

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.

Parameters

NameTypeRequiredDescription
sec_user_idstringYesUser sec_user_id
countintegerNoMaximum count number, do not exceed 20, it is recommended to keep it unchanged.
max_cursorintegerNoMaximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.
sort_typeintegerNoSort type, optional values are as follows: 0: Latest sorting - default; 1: Hottest sorting

Example response

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": ""
}

Response fields

FieldMeaning
aweme_list[]One entry per video on the user's profile.
aweme_list[].aweme_idThe video ID, returned as a string of digits.
aweme_list[].create_timePublish time of the video, as a 10-digit number such as 1793087254.
aweme_list[].descThe video description text. It is an empty string when the creator wrote none.
aweme_list[].author_user_idNumeric ID of the user who posted the video.
aweme_list[].author.avatar_168x168.url_list / author.avatar_300x300.url_list / author.avatar_thumb.url_listAvatar 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_shareBooleans that show whether commenting, forwarding and sharing are allowed on the video.
aweme_list[].commerce_info.is_adBoolean that shows whether the video is marked as an ad.
aweme_list[].cityA city code attached to the video, such as 410100.

Notes

  • 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.
  • For the first page, send max_cursor as 0. For the next page, send the max_cursor value from the previous response.
  • Pass aweme_id values to Douyin Video Statistics (Batch), which takes comma-separated video IDs.

Pricing

$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Read the first page of a creator's videos

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.

Connect a known creator to your agent

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.

Explore more

Related APIs

All APIs
APIPriceResponse
Douyin$0.001 per callJSON
Douyin$0.001 per callJSON
Douyin$0.001 per callJSON
Douyin$0.001 per callJSON
Douyin$0.001 per callJSON
Douyin$0.001 per callJSON

Questions

FAQ

How do I use the Douyin User Videos API?

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.

How much does the Douyin User Videos API cost?

$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.

What parameters does the Douyin User Videos API accept?

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.

What does the Douyin User Videos API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Douyin developer account or API key?

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.

Which values should I use for the first video page?

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.

Does the first page contain every video or verified play counts?

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.

Can an agent call this without a Douyin login cookie?

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.