Douyin User Liked Videos (App V3)

Name: Douyin User Liked Videos (App V3)
Price: 0.0015 USD
Availability: InStock
Author: Douyin

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

Returns a list of videos liked by a specific Douyin user. Supports cursor-based pagination and custom item counts per page.

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 · 2 optional

Production route

Try the model

Playground

Open playground

Input

Counts(integer)

Number per page

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

OutputExample

Responseoutputs · 433 B · 18 lines

[
  {
    "data": {
      "aweme_list": null,
      "extra": {
        "fatal_item_ids": [],
        "logid": "2026100620413283A3061FEC023751A465",
        "now": 1791290492000
      },
      "log_pb": {
        "impr_id": "2026100620413283A3061FEC023751A465"
      },
      "sec_uid": "MS4wLjABAAAAr52fXcfmzqOZJM_smap9Uuxtm16h8BupkCVaCt89BENq3E91mHCvtz5Z5TkXPHq_",
      "status_code": 0,
      "uid": "3635433641882579"
    }
  }
]

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
counts: integer · optional
max_cursor: integer · optional

Access

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

API README

Douyin User Liked Videos (App V3) API

Look up videos liked by a Douyin user using their sec_user_id. Supports cursor-based pagination with max_cursor and results sizing via counts.

Use cases

Inspect videos liked by a specific Douyin profile.
Analyze content preferences and audience interests from liked feeds.
Track historical video likes for research and monitoring.

Request

curl -X POST "https://api.sandbase.ai/v1/api/douyin/app-v3/user-like-videos" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sec_user_id": "MS4wLjABAAAAr52fXcfmzqOZJM_smap9Uuxtm16h8BupkCVaCt89BENq3E91mHCvtz5Z5TkXPHq_"}'

Parameters

Name	Type	Required	Description
`sec_user_id`	string	Yes	User sec_user_id
`counts`	integer	No	Number per page
`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.

Notes

Requires sec_user_id to identify the Douyin user.
For pagination, pass 0 to max_cursor on the first call, then use the returned max_cursor value on subsequent calls.
Use counts to set the number of items returned per page.

Related APIs

Douyin Brand Hot Search List: Returns the current Douyin brand hot search list and category data.
Douyin Brand Hot Search List Detail: Returns detailed brand hot search list data from Douyin for a specific category.
Douyin Short Link Generator: Converts a standard Douyin web link into a shortened Douyin URL.

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-like-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-like-videos" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "sec_user_id": "MS4wLjABAAAAr52fXcfmzqOZJM_smap9Uuxtm16h8BupkCVaCt89BENq3E91mHCvtz5Z5TkXPHq_"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
Douyin User Liked Videos (App V3)This 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 Liked Videos (App V3) API?

Send a POST request to https://api.sandbase.ai/v1/api/douyin/app-v3/user-like-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 Liked Videos (App V3) 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 Liked Videos (App V3) API accept?

Required: sec_user_id (string). Optional: counts (integer) and max_cursor (integer). The Parameters table and the Playground on this page list every field.

What does the Douyin User Liked Videos (App V3) API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Douyin developer account or API key?

No. Douyin User Liked Videos (App V3) 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.