Douyin User Videos

Name: Douyin User Videos
Price: 0.0015 USD
Availability: InStock
Author: Douyin

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.

Try this API Get API key

Price: $0.0015USD / callFirst 100 calls per day free (shared per organization)
Method: POST
Response: JSON
Parameters: 1 required · 3 optional

Production route

Try the model

Playground

Open playground

Input

Count(integer)

Maximum count number, do not exceed 20, it is recommended to keep it unchanged.

Max Cursor(integer)

Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.

Sec User Id(string)

User sec_user_id

Sort Type(integer)

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.

Model card

Specifications

Pricing

Base price: $0.0015 / run
Daily free calls: First 100 calls per day free (shared per organization)

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

sec_user_id: string · required
count: integer · optional
max_cursor: integer · optional
sort_type: integer · optional

Access

Provider: Douyin
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/douyin/app-v3/user-post-videos
Authentication: Bearer API key

API README

Douyin User Videos API

Pass a Douyin sec_user_id and get the videos on that user's homepage, newest first or most popular first, with full statistics.

Use cases

Track a creator's posting cadence and performance.
Audit an influencer's recent content before a campaign.
Collect a brand account's videos for analysis.

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}'

Parameters

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.
`sort_type`	integer	No	Sort type, optional values are as follows: `0`: Latest sorting - default; `1`: Hottest sorting
`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.

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "has_more": 1,
  "max_cursor": "<next max_cursor>",
  "aweme_list": [
    {
      "aweme_id": "7657847286442471077",
      "create_time": 1782981514,
      "duration": 6014,
      "author": {
        "nickname": "<user>",
        "sec_uid": "<sec_uid>"
      },
      "statistics": {
        "play_count": 0,
        "digg_count": 8,
        "comment_count": 0,
        "share_count": 0,
        "collect_count": 2
      },
      "share_url": "https://www.iesdouyin.com/share/video/7657847286442471077/?…"
    }
  ]
}

Notes

sort_type: 0 = latest (default), 1 = most popular.
Paginate with max_cursor from the previous response.

Related APIs

Douyin Hot Search List: Get the Douyin hot search list and other boards (seeding, entertainment, social and challenge lists): trending words with heat values and video counts.
Douyin Video Statistics (Batch): Get play, like, share and download counts for up to 50 Douyin videos in one request by passing comma-separated video IDs.
Get Douyin brand hot search list data: Get Douyin brand hot search category data.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

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

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# 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": "example"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
Douyin User VideosThis API `Douyin`	$0.0015 per call	JSON	Jul 31, 2026
Douyin Brand Hot Search List `Douyin`	$0.0015 per call	JSON	Jul 31, 2026
Douyin Brand Hot Search List Detail `Douyin`	$0.0015 per call	JSON	Jul 31, 2026
Douyin Short Link Generator `Douyin`	$0.0015 per call	JSON	Jul 31, 2026
Douyin Video Share QR Code `Douyin`	$0.0015 per call	JSON	Jul 31, 2026
Douyin Hashtag Details `Douyin`	$0.0015 per call	JSON	Jul 31, 2026

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