> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tikfly.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Explore Dramas

> Explore Dramas



## OpenAPI

````yaml /api-reference/openapi.json get /api/drama/explore
openapi: 3.1.0
info:
  title: Tikfly API - Unoffical Tiktok API
  description: >-
    Tikfly API Documentation - Unoffical Tiktok API for scalable access without
    the usual limitations
  version: 1.0.0
servers:
  - url: https://tiktok-api23.p.rapidapi.com
    description: RapidAPI
security: []
paths:
  /api/drama/explore:
    get:
      tags:
        - Drama
      summary: Explore Dramas
      description: Explore Dramas
      operationId: getApiDramaExplore
      parameters:
        - in: query
          name: type
          schema:
            type: string
            enum:
              - '7'
              - '8'
              - '9'
              - '10'
            description: |
              Theme type for filtering dramas

              - `10`: All (default)
              - `9`: Latest
              - `8`: Ranking - New releases
              - `7`: Ranking - Trending
            default: '10'
            example: '10'
        - in: query
          name: count
          schema:
            type: integer
            exclusiveMinimum: 0
            default: 10
            description: >-
              The number of results to be returned. The default and maximum
              value is 10
            example: 10
        - in: query
          name: cursor
          schema:
            type: string
            description: >-
              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
            default: '0'
            example: '0'
        - in: query
          name: region
          schema:
            type: string
            description: The region code used to determine the available dramas
            default: US
            example: US
        - in: query
          name: releasePeriod
          schema:
            type: string
            enum:
              - all
              - 7d
              - 30d
            description: |
              The release period used to filter dramas

              - `all`: All (default)
              - `7d`: In 7 days
              - `30d`: In 30 days
            default: all
            example: all
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  cursor:
                    type: string
                    description: >-
                      Cursor for pagination. Use this value in subsequent
                      requests to fetch more data
                    example: '1:10'
                  hasMore:
                    type: boolean
                    description: Indicates whether there are more data available to fetch
                    example: true
                  dramaList:
                    type: array
                    items:
                      type: object
                      properties:
                        author:
                          type: object
                          properties:
                            stats:
                              type: object
                              properties:
                                diggCount:
                                  type: number
                                  description: >-
                                    Total number of likes the user has given to
                                    other videos
                                  example: 2276
                                followerCount:
                                  type: number
                                  description: Total number of users following this account
                                  example: 33300000
                                followingCount:
                                  type: number
                                  description: Number of accounts this user is following
                                  example: 0
                                friendCount:
                                  type: number
                                  description: >-
                                    Number of mutual followers (users that this
                                    account follows and who also follow back)
                                  example: 0
                                heart:
                                  type: number
                                  description: >-
                                    Total number of likes the user has received
                                    across all videos
                                  example: 263500000
                                heartCount:
                                  type: number
                                  description: >-
                                    Same as "heart". Represents the total number
                                    of likes the user has received
                                  example: 263500000
                                videoCount:
                                  type: number
                                  description: Total number of videos the user has posted
                                  example: 78
                              description: User stats
                            statsV2:
                              type: object
                              properties:
                                diggCount:
                                  type: string
                                  description: >-
                                    Total number of likes the user has given to
                                    other videos
                                  example: '2276'
                                followerCount:
                                  type: string
                                  description: Total number of users following this account
                                  example: '33265139'
                                followingCount:
                                  type: string
                                  description: Number of accounts this user is following
                                  example: '0'
                                friendCount:
                                  type: string
                                  description: >-
                                    Number of mutual followers (users that this
                                    account follows and who also follow back)
                                  example: '0'
                                heart:
                                  type: string
                                  description: >-
                                    Total number of likes the user has received
                                    across all videos
                                  example: '263479941'
                                heartCount:
                                  type: string
                                  description: >-
                                    Same as "heart". Represents the total number
                                    of likes the user has received
                                  example: '263479941'
                                videoCount:
                                  type: string
                                  description: Total number of videos the user has posted
                                  example: '78'
                              description: >-
                                An enhanced version of user stats where all
                                metrics are exact values (not rounded)
                            user:
                              type: object
                              properties:
                                avatarLarger:
                                  type: string
                                  description: URL of the user’s large-size avatar image
                                  example: >-
                                    https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-avt-0068/253fe33c9376d676341cd8964c188e78~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=537ee341&x-expires=1787378400&x-signature=Kuqi%2FplCTTU7c8yxqcLBcwNIxdI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a
                                avatarMedium:
                                  type: string
                                  description: URL of the user’s medium-size avatar image
                                  example: >-
                                    https://p19-common-sign.tiktokcdn-eu.com/tos-alisg-avt-0068/253fe33c9376d676341cd8964c188e78~tplv-tiktokx-cropcenter:720:720.jpeg?dr=10399&refresh_token=75c89642&x-expires=1787378400&x-signature=NUQNUVFFIN%2FuO%2BBdAsGjeivrlQA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a
                                avatarThumb:
                                  type: string
                                  description: >-
                                    URL of the user’s thumbnail-size avatar
                                    image
                                  example: >-
                                    https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-avt-0068/253fe33c9376d676341cd8964c188e78~tplv-tiktokx-cropcenter:100:100.jpeg?dr=10399&refresh_token=e1fc08c6&x-expires=1787378400&x-signature=E54li%2FobSxGkEyk5VeO4ZATUZ0A%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a
                                commentSetting:
                                  type: number
                                  description: >-
                                    User’s comment privacy setting for their
                                    posts
                                  example: 0
                                downloadSetting:
                                  type: number
                                  description: >-
                                    User’s download permission setting for their
                                    videos
                                  example: 0
                                duetSetting:
                                  type: number
                                  description: User’s duet permission setting
                                  example: 0
                                ftc:
                                  type: boolean
                                  description: >-
                                    Indicates whether the account is subject to
                                    child safety restrictions
                                  example: false
                                id:
                                  type: string
                                  description: User ID
                                  example: '7627304408481448981'
                                isADVirtual:
                                  type: boolean
                                  description: >-
                                    Indicates whether the account is a virtual
                                    or advertisement related profile
                                  example: false
                                nickname:
                                  type: string
                                  description: The user’s profile display name
                                  example: stardustdrama_mx
                                openFavorite:
                                  type: boolean
                                  description: >-
                                    Whether the user’s liked videos list is
                                    public
                                  example: true
                                privateAccount:
                                  type: boolean
                                  description: >-
                                    Indicates whether the account is set to
                                    private
                                  example: false
                                secUid:
                                  type: string
                                  description: User secUid
                                  example: >-
                                    MS4wLjABAAAA63WLj4gsA7Ad6V3caZ9l5PhxNJk7ZQTTdgEF4SZSVKmlOudPA56zl5rzl6SGCOEv
                                secret:
                                  type: boolean
                                  description: >-
                                    Indicates whether the account is set to
                                    private
                                  example: false
                                signature:
                                  type: string
                                  description: The user’s profile bio
                                  example: This is pretty much just a cat account
                                stitchSetting:
                                  type: number
                                  description: User’s Stitch permission setting
                                  example: 0
                                uniqueId:
                                  type: string
                                  description: >-
                                    User uniqueID. The user’s public TikTok
                                    handle (username)
                                  example: stardustdrama_mx
                                verified:
                                  type: boolean
                                  description: >-
                                    Indicates whether the account is officially
                                    verified
                                  example: false
                        authorUID:
                          type: string
                          description: >-
                            The unique identifier of the user who created the
                            drama
                          example: '7627304408481448981'
                        cover:
                          type: object
                          properties:
                            urlList:
                              type: array
                              items:
                                type: string
                              description: A list of URLs for the drama cover images
                              example:
                                - >-
                                  https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-i-xbj99bix8q-sg/d123fd5ec022495aa3730bc758d15cbd~tplv-tiktokx-origin.image?dr=10395&x-expires=1787378400&x-signature=zzjvekP1M%2BM3GEAJxdI3n%2FULjUA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a
                                - >-
                                  https://p19-common-sign.tiktokcdn-eu.com/tos-alisg-i-xbj99bix8q-sg/d123fd5ec022495aa3730bc758d15cbd~tplv-tiktokx-origin.image?dr=10395&x-expires=1787378400&x-signature=mVvxuQYvA9RvkVnj58rQ%2BkS5h2g%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a
                                - >-
                                  https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-i-xbj99bix8q-sg/d123fd5ec022495aa3730bc758d15cbd~tplv-tiktokx-origin.jpeg?dr=10395&x-expires=1787378400&x-signature=RLyraA8kZ%2BN3%2F3kHTrWKDnHZvpg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a
                        description:
                          type: string
                          description: The description of the drama
                          example: >-
                            Leo Lara sale de prisión y rescata a la hija de una
                            familia adinerada...
                        dramaID:
                          type: string
                          description: The unique identifier of the drama
                          example: '7674268460205364245'
                        dramaName:
                          type: string
                          description: The name of the drama
                          example: El regreso del rey dragón
                        numVideos:
                          type: number
                          description: The total number of episodes in the drama
                          example: 65
                        numWatched:
                          type: string
                          description: The number of times the drama has been watched
                          example: '2040026'
                        themes:
                          type: array
                          items:
                            type: object
                            properties:
                              tagID:
                                type: string
                                description: The unique identifier of the drama theme
                                example: '7628991192533095425'
                              tagKey:
                                type: string
                                description: The key identifying the drama theme
                                example: tag_Highsociety_GeneralSettings
                              tagVal:
                                type: string
                                description: The display value of the drama theme
                                example: Family Feud
                          description: The themes associated with the drama
                        totalDuration:
                          type: string
                          description: >-
                            The total duration of all episodes in the drama, in
                            seconds
                          example: '6596'
                        zoomCover:
                          type: object
                          properties:
                            '240':
                              type: string
                              description: ''
                              example: >-
                                https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-i-xbj99bix8q-sg/d123fd5ec022495aa3730bc758d15cbd~tplv-photomode-zoomcover:240:240.jpeg?dr=10375&x-expires=1787378400&x-signature=EJSNs1FRBQ%2FJJrUJ%2F1Z9zKZ%2BNdE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a&ftpl=1
                            '480':
                              type: string
                              description: ''
                              example: >-
                                https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-i-xbj99bix8q-sg/d123fd5ec022495aa3730bc758d15cbd~tplv-photomode-zoomcover:480:480.jpeg?dr=10375&x-expires=1787378400&x-signature=TATIhtRyaLJOccdSu50E1Zi4cEY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a&ftpl=1
                            '720':
                              type: string
                              description: ''
                              example: >-
                                https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-i-xbj99bix8q-sg/d123fd5ec022495aa3730bc758d15cbd~tplv-photomode-zoomcover:720:720.jpeg?dr=10375&x-expires=1787378400&x-signature=pu6IKlsYGWaU9VrIyBPalpy%2Be%2BQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a&ftpl=1
                            '960':
                              type: string
                              description: ''
                              example: >-
                                https://p19-common-sign.tiktokcdn-eu.com/tos-alisg-i-xbj99bix8q-sg/d123fd5ec022495aa3730bc758d15cbd~tplv-photomode-zoomcover:960:960.jpeg?dr=10375&x-expires=1787378400&x-signature=cR%2BLKHBnDyiEDigRACMen%2F0gTOU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a&ftpl=1
                        labelHot:
                          type: boolean
                          description: ''
                          example: true
                        labelNew:
                          type: boolean
                          description: ''
                          example: false
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Bad request
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: >-
                      Invalid API key. Go to https://docs.rapidapi.com/docs/keys
                      for more info.
        '403':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: You are not subscribed to this API.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: 'Request failed with status 500: Internal Server Error'
                  status_code:
                    type: number
                    example: 500
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-rapidapi-key
      description: >-
        Rapid API Key. [How can I get Rapid API
        Key?](https://docs.tikfly.io/getting-started/quickstart)

````