account | DynamicAccount | Yes | - | Select the TikTok Ads account (advertiser) to search music for. |
music_scene | string or SelectableOption | No | - | Where the music will be used. Options: CAROUSEL_ADS (default), CREATIVE_ASSET. |
search_type | string or SelectableOption | No | - | How to search for music. Required when music_scene is CAROUSEL_ADS. Options: SEARCH_BY_KEYWORD, SEARCH_BY_LIKED, SEARCH_BY_HISTORY, SEARCH_BY_MUSIC_ID, SEARCH_BY_SOURCE. |
keyword | string | No | - | Keyword to search music by. Required when search_type is SEARCH_BY_KEYWORD. |
music_ids | string or array of string | No | - | List of music IDs to look up. Required when search_type is SEARCH_BY_MUSIC_ID. Max 100. |
sources | string or SelectableOption | No | - | Music source filter. Required when search_type is SEARCH_BY_SOURCE. USER = advertiser-uploaded music, SYSTEM = TikTok system music. For CAROUSEL_ADS, only USER is allowed. |
limit | integer | No | 100 | Maximum number of music tracks to return. Default: 100. |