---
title: "Get User Dramas"
method: GET
path: "/api/user/dramas"
tags: ["User"]
---

# Get User Dramas

`GET /api/user/dramas`

## Request

- Base URL: `https://tiktok-api23.p.rapidapi.com`
- URL: `https://tiktok-api23.p.rapidapi.com/api/user/dramas`
- Auth: API key in header `x-rapidapi-key`

Get User Dramas

## Query parameters

- `secUid` string, required: User secUid
- `count` integer: The number of results to be returned. The default and maximum value is 20
- `cursor` string: cursor parameter is used for pagination. In the first request, the default value of cursor is 0. For subsequent requests, the value of cursor will be taken from the response of the previous request

## Response `200`

Success

- object
  - `cursor` string: Cursor for pagination. Use this value in subsequent requests to fetch more data
  - `hasMore` boolean: Indicates whether there are more data available to fetch
  - `dramaList` object[]
    - `cover` object
      - `urlList` string[]: A list of URLs for the drama cover images
    - `description` string: The description of the drama
    - `dramaID` string: The unique identifier of the drama
    - `dramaName` string: The name of the drama
    - `isLimitedFree` boolean: Whether the drama has limited free access
    - `numVideos` number: The total number of episodes in the drama
    - `numWatched` string: The number of times the drama has been watched
    - `themes` object[]: The themes associated with the drama
      - `tagID` string: The unique identifier of the drama theme
      - `tagKey` string: The key identifying the drama theme
      - `tagVal` string: The display value of the drama theme
    - `totalDuration` string: The total duration of all episodes in the drama, in seconds
    - `zoomCover` object
      - `240` string
      - `480` string
      - `720` string
      - `960` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-11-03** `095fffd2c728`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api/changes/api/user/dramas/get.md)

---

[API](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api.md) - [All operations](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api/revisions/095fffd2c728?raw)