List Music Tracks
FreshGETGET https://api.creatify.ai/api/musics/Retrieve a list of all available background music tracks. These tracks can be used as background music in video creation tasks.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
category | string | No | Filter by category ID |
Headers
| Header | Type | Required | Description |
|---|---|---|---|
X-API-ID | string | Yes | Your Creatify API ID |
X-API-KEY | string | Yes | Your Creatify API key |
Example Request
bash
curl -X GET 'https://api.creatify.ai/api/musics/' \
-H 'X-API-ID: your-api-id' \
-H 'X-API-KEY: your-api-key'With category filter:
bash
curl -X GET 'https://api.creatify.ai/api/musics/?category=cat-001' \
-H 'X-API-ID: your-api-id' \
-H 'X-API-KEY: your-api-key'Response
json
[
{
"id": "music-001",
"name": "Sunrise Energy",
"category": "cat-001",
"duration": 120,
"preview_url": "https://cdn.creatify.ai/music/music-001-preview.mp3",
"url": "https://cdn.creatify.ai/music/music-001.mp3"
},
{
"id": "music-002",
"name": "Corporate Motion",
"category": "cat-002",
"duration": 90,
"preview_url": "https://cdn.creatify.ai/music/music-002-preview.mp3",
"url": "https://cdn.creatify.ai/music/music-002.mp3"
}
]Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique track identifier |
name | string | Track name |
category | string | Category ID |
duration | integer | Track duration in seconds |
preview_url | string | Short preview audio URL |
url | string | Full track URL |
Status Codes
| Code | Description |
|---|---|
200 | Success |
401 | Unauthorized -- invalid API credentials |
429 | Rate limit exceeded |
500 | Internal server error |
TIP
Use GET /api/music_categories/ first to browse available categories, then filter tracks by category for easier selection.