--- title: "Get Drama Episodes" method: GET path: "/api/drama/episodes" tags: ["Drama"] --- # Get Drama Episodes `GET /api/drama/episodes` ## Request - Base URL: `https://tiktok-api23.p.rapidapi.com` - URL: `https://tiktok-api23.p.rapidapi.com/api/drama/episodes` - Auth: API key in header `x-rapidapi-key` Get Drama Episodes ## Query parameters - `dramaId` string, required: Drama ID - `count` integer: The number of results to be returned. The default and maximum value is 24 - `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[] - `AIGCDescription` string: AI-generated description of the video, if available - `CategoryType` number: Indicates the video category type defined by TikTok - `IsHDBitrate` boolean - `ShowAIGC` boolean - `author` 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 - `authorStats` 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 - `authorStatsV2` 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 - `backendSourceEventTracking` string: Internal backend event tracking identifier used by TikTok - `contents` object[] - `desc` string: The text description of the video - `createTime` number: Create time of the drama (timestamp) - `creatorAIComment` object - `eligibleVideo` boolean: Indicates whether the video is eligible for AI-powered comments - `hasAITopic` boolean: Indicates whether the video contains AI-generated topics - `notEligibleReason` number: Reason code explaining why the video is not eligible for AI comments - `desc` string: The text description of the video - `diversificationId` number: Identifier used by TikTok to diversify video distribution - `dramaInfo` object - `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 - `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 - `duetDisplay` number: Indicates duet visibility settings for this video - `forFriend` boolean: Indicates whether the video is shared only with friends - `id` string: Video ID - `isAd` boolean: Indicates whether the video is an advertisement - `isReviewing` boolean: Indicates whether the video is still under TikTok review - `itemCommentStatus` number: The comment status of the video - `item_control` object - `can_repost` boolean: Indicates whether the video can be reposted by users - `officalItem` boolean: Indicates whether the video is marked as official content - `originalItem` boolean: Indicates whether this is original content by the creator - `privateItem` boolean: Indicates whether the video is set to private - `secret` boolean: Indicates whether the video is set to private - `shareEnabled` boolean: Indicates whether sharing is enabled for this video - `stats` object - `collectCount` number: Number of times the post has been saved - `commentCount` number: Total number of comments on the post - `diggCount` number: Total number of likes the post has received - `playCount` number: Total number of views the post has generated - `shareCount` number: Number of times the post has been shared - `statsV2` object - `collectCount` string: Number of times the post has been saved - `commentCount` string: Total number of comments on the post - `diggCount` string: Total number of likes the post has received - `playCount` string: Total number of views the post has generated - `repostCount` string: Number of times the post has been reposted - `shareCount` string: Number of times the post has been shared - `stitchDisplay` number: Indicates stitch visibility settings for this video - `stitchEnabled` boolean: Indicates whether stitching is allowed for this video - `textLanguage` string: Detected language of the caption text - `textTranslatable` boolean: Indicates whether the caption text can be translated - `video` object - `cover` string: URL of the primary video thumbnail - `duration` number: Video duration in seconds - `dynamicCover` string: URL of the animated video cover (dynamic thumbnail) - `height` number: Video height in pixels - `id` string: Drama ID - `originCover` string: URL of the original (unprocessed) video thumbnail - `ratio` string: Video resolution ratio label - `volumeInfo` object - `Loudness` number: Measured loudness level of the audio track - `Peak` number: Peak volume value detected in the audio - `width` number: Video height in pixels - `zoomCover` object - `240` string - `480` string - `720` string - `960` string - `totalEpisodeCount` string: The total number of episodes in the drama ## 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/episodes/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)