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

# Music Library

> Get TikTok Music Library

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": {
      "code": 200,
      "message": "OK"
    },
    "music_list": [
      {
        "clip_id": "7086563693013518338",
        "singer": "INJI",
        "theme": "Dance",
        "title": "GASLIGHT",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/d5fc562a7b0d4d2d9a4d421404fb1a8c",
        "duration": 60,
        "genre": "Electronic",
        "is_on_ad": true,
        "meta_song_id": "7086563690816522241",
        "mood": "Dynamic",
        "music_id": "7147664051351339010",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/d5fc562a7b0d4d2d9a4d421404fb1a8c",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6956807804032944130",
        "singer": "Queens Road, Fabian Graetz",
        "theme": "Travel",
        "title": "FEEL THE GROOVE",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/os9tAffhF9izAzBaUMDDnCxvNrhaeGigADC4IG",
        "duration": 15,
        "genre": "R&B/Soul",
        "is_on_ad": true,
        "meta_song_id": "6769046027438655490",
        "mood": "Excited",
        "music_id": "7168130651333623810",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/os9tAffhF9izAzBaUMDDnCxvNrhaeGigADC4IG",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "7094567340917917697",
        "singer": "Carol Kay",
        "theme": "Game",
        "title": "AIN'T GONNA STOP",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/d1da98e284064782a4acfcc9a933b566",
        "duration": 30,
        "genre": "Country",
        "is_on_ad": true,
        "meta_song_id": "7471368488516634641",
        "mood": "Excited",
        "music_id": "7094803985860739074",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/d1da98e284064782a4acfcc9a933b566",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "7055830467014051841",
        "singer": "Glow City",
        "theme": "Dance",
        "title": "In USA",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/oIfKuMvm1F6fVz2fAQ46ODgP42SLkrQHDaCY5Y",
        "duration": 44,
        "genre": "Electronic",
        "is_on_ad": true,
        "meta_song_id": "7055830460383660033",
        "mood": "Dynamic",
        "music_id": "7285846988837683201",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/oIfKuMvm1F6fVz2fAQ46ODgP42SLkrQHDaCY5Y",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6945113454697826305",
        "singer": "DJ BAI",
        "theme": "Summer",
        "title": "Present Air",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/o01htqz4ICBWoxuAJ3azNA0sXBBfQx9wCoTxUG",
        "duration": 180,
        "genre": "Latin",
        "is_on_ad": true,
        "meta_song_id": "6945113454617298945",
        "mood": "Happy",
        "music_id": "7179960487451262977",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/o01htqz4ICBWoxuAJ3azNA0sXBBfQx9wCoTxUG",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6900961355197597698",
        "singer": "Turreekk",
        "theme": "Cool",
        "title": "MOMENTS IN LIFE",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/022a0681fbbb48e3b35c6a64c045d33d",
        "duration": 60,
        "genre": "Hip Hop/Rap",
        "is_on_ad": true,
        "meta_song_id": "6769569394411456513",
        "mood": "Dynamic",
        "music_id": "7057614092702728193",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/022a0681fbbb48e3b35c6a64c045d33d",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6900958795413850113",
        "singer": "Who's That Girl?",
        "theme": "Campus",
        "title": "U MAKE ME GO",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/c1d3ae8ab8cf4f68af8ada12d19b7bdf",
        "duration": 35,
        "genre": "Pop",
        "is_on_ad": true,
        "meta_song_id": "6775818060314970113",
        "mood": "Happy",
        "music_id": "7054993220783439873",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/c1d3ae8ab8cf4f68af8ada12d19b7bdf",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6945135004259190785",
        "singer": "DJ BAI",
        "theme": "",
        "title": "Vengeful Haircut",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/oUFJ8enaDo7QAfeaQybuq4GFzuTCGngADOsxCl",
        "duration": 30,
        "genre": "Electronic",
        "is_on_ad": true,
        "meta_song_id": "6945135004166916097",
        "mood": "Dynamic",
        "music_id": "7179950039800381442",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/oUFJ8enaDo7QAfeaQybuq4GFzuTCGngADOsxCl",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6945112449495123970",
        "singer": "DJ BAI",
        "theme": "Danceable",
        "title": "Well-off Ear",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/ogH3jjgZhr8eCf5dnHQIXgB0sMcdBnzKtUZtZK",
        "duration": 30,
        "genre": "Electronic",
        "is_on_ad": true,
        "meta_song_id": "6945112449397852162",
        "mood": "Dynamic",
        "music_id": "7179950237310222338",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/ogH3jjgZhr8eCf5dnHQIXgB0sMcdBnzKtUZtZK",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6945121906690197506",
        "singer": "DJ BAI",
        "theme": "Summer",
        "title": "Wholesale Change",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/o4cNIfwhBE8sLzHoU0GAggXxdbhWvxdowHA5I4",
        "duration": 30,
        "genre": "Electronic",
        "is_on_ad": true,
        "meta_song_id": "6945121906610456578",
        "mood": "Dynamic",
        "music_id": "7179967794892619778",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/o4cNIfwhBE8sLzHoU0GAggXxdbhWvxdowHA5I4",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6900963474646517762",
        "singer": "C. Paul Chantrill",
        "theme": "Travel",
        "title": "TIDE TO YOUR SOUL",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/667a045a16c441bbaf34a168ce6f1d8a",
        "duration": 35,
        "genre": "Easy Listening",
        "is_on_ad": true,
        "meta_song_id": "6769019969897236481",
        "mood": "Romantic",
        "music_id": "7055141839607988225",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/667a045a16c441bbaf34a168ce6f1d8a",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6900963471123318786",
        "singer": "Audrey Karrasch",
        "theme": "Beauty&Fashion",
        "title": "FOREVER",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/11a7c28cec9d4dceaf6c25880a03cdb9",
        "duration": 60,
        "genre": "Pop",
        "is_on_ad": true,
        "meta_song_id": "6774217158382585858",
        "mood": "Happy",
        "music_id": "7054381776655630338",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/11a7c28cec9d4dceaf6c25880a03cdb9",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6789835290321111041",
        "singer": "Bytedance",
        "theme": "Cool",
        "title": "打福歌",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/4f7f92d1363d469ba3545218926975ab",
        "duration": 30,
        "genre": "Electronic",
        "is_on_ad": true,
        "meta_song_id": "6789835290191087617",
        "mood": "Dynamic",
        "music_id": "7096088495832203265",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/4f7f92d1363d469ba3545218926975ab",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6945113137977526274",
        "singer": "DJ BAI",
        "theme": "Summer",
        "title": "Shaggy Rainstorm",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/owlegIRUnPqqGCasADbpFRQ22elfBGDaOUnz04",
        "duration": 120,
        "genre": "Latin",
        "is_on_ad": true,
        "meta_song_id": "6945113137886922753",
        "mood": "",
        "music_id": "7263431227994783745",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/owlegIRUnPqqGCasADbpFRQ22elfBGDaOUnz04",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6903461459506759682",
        "singer": "ByteTracks",
        "theme": "Dance",
        "title": "Literary Magic",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/749a279a45d54311ad4998b14c2af5a7",
        "duration": 30,
        "genre": "Electronic",
        "is_on_ad": true,
        "meta_song_id": "6828477965756532738",
        "mood": "Happy",
        "music_id": "7096095325458694145",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/749a279a45d54311ad4998b14c2af5a7",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6945110377399896065",
        "singer": "DJ BAI",
        "theme": "Dance",
        "title": "Next Exchange",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/oQZgI3AxAwYUm9sUBhPmNQmB4zLzvfKUGo1yLW",
        "duration": 90,
        "genre": "Electronic",
        "is_on_ad": true,
        "meta_song_id": "6945110377320187905",
        "mood": "Dynamic",
        "music_id": "7179960844065865729",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/oQZgI3AxAwYUm9sUBhPmNQmB4zLzvfKUGo1yLW",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6904659530097887233",
        "singer": "ByteTracks",
        "theme": "Game",
        "title": "In Atmosphere",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/536e12dc72904c19921885a1846295d7",
        "duration": 30,
        "genre": "Hip Hop/Rap",
        "is_on_ad": true,
        "meta_song_id": "6828821872155576322",
        "mood": "Dynamic",
        "music_id": "7096083107694002177",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/536e12dc72904c19921885a1846295d7",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6945111437324847106",
        "singer": "DJ BAI",
        "theme": "Sport",
        "title": "Talented Daisy",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/oErp3BvE7oOw5hUxJufNAAwTqYdzFRIWs1zDWN",
        "duration": 60,
        "genre": "Electronic",
        "is_on_ad": true,
        "meta_song_id": "6945111437236799489",
        "mood": "Dynamic",
        "music_id": "7179993130044899330",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/oErp3BvE7oOw5hUxJufNAAwTqYdzFRIWs1zDWN",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6904659547793672193",
        "singer": "ByteTracks",
        "theme": "Vlog",
        "title": "It Drinks",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/66afced12043486cb2ca5a81e8012a3e",
        "duration": 30,
        "genre": "Electronic",
        "is_on_ad": true,
        "meta_song_id": "6828828211057526786",
        "mood": "Dynamic",
        "music_id": "7096090283822055426",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/66afced12043486cb2ca5a81e8012a3e",
        "placement_allowed": [
          "TikTok"
        ]
      },
      {
        "clip_id": "6904663634165630978",
        "singer": "字节爱乐",
        "theme": "Spring",
        "title": "Successful Revolution",
        "detail": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/5b125638571f4c44b1351bfba1aa80a4",
        "duration": 30,
        "genre": "Electronic",
        "is_on_ad": true,
        "meta_song_id": "6777613642754951169",
        "mood": "Cute",
        "music_id": "7096085876611317761",
        "music_url": "https://sf-tk-sg.ibytedtos.com/obj/tos-alisg-ve-2774/5b125638571f4c44b1351bfba1aa80a4",
        "placement_allowed": [
          "TikTok"
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "totalPages": 98,
      "currentResults": 20,
      "totalCount": 1953,
      "hasNextPage": true
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml api-reference/openapi-3.0.json get /wf/tiktok-music-library
openapi: 3.0.3
info:
  title: Riona API Docs
  version: 1.0.0
  contact:
    email: info@riona.ai
    url: https://riona.ai
servers:
  - url: https://riona.ai/api/1.1
security:
  - bearerAuth: []
tags:
  - name: Workflow
    description: Use this to trigger a workflow
  - name: Data
    description: Use this to fetch, modify and delete data
paths:
  /wf/tiktok-music-library:
    get:
      tags:
        - Workflow
      description: Triggers the workflow tiktok-music-library
      operationId: get_wf_tiktok-music-library
      parameters:
        - name: page
          in: query
          required: true
          description: Requested page
          schema:
            type: number
            default: 1
        - name: country
          in: query
          required: false
          description: >-
            Two letter Country code. Example: `US`. To get the full list of
            country use this endpoint: [Get Social Country
            List](/api-reference/other/countries)
          schema:
            type: string
        - name: scenarios
          in: query
          required: false
          description: |-
            `0`: TikTok Commercial Use.
             `1`: TikTok Series
          schema:
            type: number
        - name: duration
          in: query
          required: false
          description: |-
            `0`: Get All 
            `1`: 0 - 20s
            `2`: 20 - 40s
            `3`: 40 - 60s
            `4`: Over 60s
          schema:
            type: string
        - name: placements
          in: query
          required: false
          description: >-
            You can combine multiple options with comma. For example:
            `TikTok,Helo`.

            Possible options: `TikTok` | `Helo` | `TBNR`
          schema:
            type: string
        - name: themes
          in: query
          required: false
          description: >-
            You can combine multiple options with comma. For example:
            `Food,Spring`. 

            Possible options: `Food` | `Sound Effect` | `Spring` | `Autumn` |
            `Danceable` | `Beauty&Fashion` | `Healing` | `Sport` | `Transition`
            | `DJ` | `ACG` | `Campus` | `Vlog` | `Pet` | `Cool` | `Game` | `DIY`
          schema:
            type: string
        - name: genres
          in: query
          required: false
          description: >-
            You can combine multiple options with comma. For example:
            `Rock,Latin,Reggae`. 

            Possible options: `Rock` | `Pop` | `Latin` | `Metal` | `Electronic`
            | `Hip Hop/Rap` | `Alternative/Indie` | `Folk` | `R&B/Soul` |
            `Country` | `Classical` | `Jazz` | `Reggae` | `Childhood` | `Blues`
            | `Easy Listening` | `New Age` | `World Music` | `Experimental` |
            `Devotional` | `Chinese Tradition`
          schema:
            type: string
        - name: moods
          in: query
          required: false
          description: >-
            You can combine multiple options with comma. For example:
            `Excited,Sweet`. Possible options: `Excited` | `Happy` | `Chill` |
            `Sorrow` | `Angry` | `Romantic` | `Cute` | `Dynamic` | `Tense` |
            `Weird` | `Inspirational` | `Sweet`.
          schema:
            type: string
        - name: music_name
          in: query
          required: false
          description: Filter by music name
          schema:
            type: string
        - name: singer_name
          in: query
          required: false
          description: Filter by singer name
          schema:
            type: string
        - name: api_key
          in: query
          required: true
          description: >-
            This is your account API Key. You can easily locate it in your
            account dashboard.
          schema:
            type: string
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````