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

# Search Music

> Searches TikTok music tracks for an advertiser account by keyword, liked, history, music IDs, or source

Searches TikTok music tracks for an advertiser account by keyword, liked, history, music IDs, or source. Returns music\_id values that can be used in TikTok image (carousel) ads.

|                      |                           |
| -------------------- | ------------------------- |
| **App**              | TikTok Ads                |
| **Operation ID**     | `tiktok_ads_search_music` |
| **Type**             | Action                    |
| **Connection**       | `tiktok_ads` (required)   |
| **Credits per run**  | 1                         |
| **Agent / MCP tool** | Yes                       |

## Inputs

| Field         | Type                       | Required | Default | Description                                                                                                                                                                            |
| ------------- | -------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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.                                                                                                                                |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `List[Dict]`

Returns matching TikTok music tracks, including music\_id, name, author, duration, sources, style, cover\_url, url, signature, file\_name, copyright, and liked.