---
title: "Explore Dramas"
method: GET
path: "/api/drama/explore"
tags: ["Drama"]
---

# Explore Dramas

`GET /api/drama/explore`

## Request

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

Explore Dramas

## Query parameters

- `type` '7' | '8' | '9' | '10': Theme type for filtering dramas - `10`: All (default) - `9`: Latest - `8`: Ranking - New releases - `7`: Ranking - Trending
- `count` integer: The number of results to be returned. The default and maximum value is 10
- `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
- `region` string: The region code used to determine the available dramas
- `releasePeriod` 'all' | '7d' | '30d': The release period used to filter dramas - `all`: All (default) - `7d`: In 7 days - `30d`: In 30 days

## 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[]
    - `author` object
      - `stats` object: User stats
        - `diggCount` number: Total number of likes the user has given to other videos
        - `followerCount` number: Total number of users following this account
        - `followingCount` number: Number of accounts this user is following
        - `friendCount` number: Number of mutual followers (users that this account follows and who also follow back)
        - `heart` number: Total number of likes the user has received across all videos
        - `heartCount` number: Same as "heart". Represents the total number of likes the user has received
        - `videoCount` number: Total number of videos the user has posted
      - `statsV2` object: An enhanced version of user stats where all metrics are exact values (not rounded)
        - `diggCount` string: Total number of likes the user has given to other videos
        - `followerCount` string: Total number of users following this account
        - `followingCount` string: Number of accounts this user is following
        - `friendCount` string: Number of mutual followers (users that this account follows and who also follow back)
        - `heart` string: Total number of likes the user has received across all videos
        - `heartCount` string: Same as "heart". Represents the total number of likes the user has received
        - `videoCount` string: Total number of videos the user has posted
      - `user` object
        - `avatarLarger` string: URL of the user’s large-size avatar image
        - `avatarMedium` string: URL of the user’s medium-size avatar image
        - `avatarThumb` string: URL of the user’s thumbnail-size avatar image
        - `commentSetting` number: User’s comment privacy setting for their posts
        - `downloadSetting` number: User’s download permission setting for their videos
        - `duetSetting` number: User’s duet permission setting
        - `ftc` boolean: Indicates whether the account is subject to child safety restrictions
        - `id` string: User ID
        - `isADVirtual` boolean: Indicates whether the account is a virtual or advertisement related profile
        - `nickname` string: The user’s profile display name
        - `openFavorite` boolean: Whether the user’s liked videos list is public
        - `privateAccount` boolean: Indicates whether the account is set to private
        - `secUid` string: User secUid
        - `secret` boolean: Indicates whether the account is set to private
        - `signature` string: The user’s profile bio
        - `stitchSetting` number: User’s Stitch permission setting
        - `uniqueId` string: User uniqueID. The user’s public TikTok handle (username)
        - `verified` boolean: Indicates whether the account is officially verified
    - `authorUID` string: The unique identifier of the user who created the drama
    - `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
    - `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
    - `labelHot` boolean
    - `labelNew` boolean

## 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/drama/explore/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)