Skip to content

List Music Tracks

FreshGET
GET 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

NameTypeRequiredDescription
categorystringNoFilter by category ID

Headers

HeaderTypeRequiredDescription
X-API-IDstringYesYour Creatify API ID
X-API-KEYstringYesYour 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

FieldTypeDescription
idstringUnique track identifier
namestringTrack name
categorystringCategory ID
durationintegerTrack duration in seconds
preview_urlstringShort preview audio URL
urlstringFull track URL

Status Codes

CodeDescription
200Success
401Unauthorized -- invalid API credentials
429Rate limit exceeded
500Internal server error

TIP

Use GET /api/music_categories/ first to browse available categories, then filter tracks by category for easier selection.