Skip to main content
GET
/
api
/
audio
curl "https://api.musique.app/api/audio?page=1&limit=10&category=announcement" \
  -H "X-API-Key: msk_live_1234567890abcdef"

{
  "data": [
    {
      "audioId": "aud_9x8y7z6w5v4u3t",
      "name": "Store Announcement",
      "description": "New product launch",
      "category": "announcement",
      "url": "https://cdn.musique.app/audio/aud_9x8y7z6w5v4u3t.mp3",
      "duration": 45.2,
      "size": 1024000,
      "format": "mp3",
      "createdAt": "2024-01-15T10:30:00Z"
    },
    {
      "audioId": "aud_1a2b3c4d5e6f7g",
      "name": "Emergency Alert",
      "description": "Fire drill announcement",
      "category": "announcement",
      "url": "https://cdn.musique.app/audio/aud_1a2b3c4d5e6f7g.mp3",
      "duration": 30.5,
      "size": 768000,
      "format": "mp3",
      "createdAt": "2024-01-14T09:15:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "totalPages": 1
  }
}
Retrieve all audio files in your library with pagination and filtering options.

​
Request

​
Headers

​
X-API-Key
string
required
Your API authentication token

​
Query Parameters

​
page
number
default:"1"
Page number for pagination
​
limit
number
default:"20"
Number of results per page (max 100)
​
category
string
Filter by category
​
search
string
Search by name or description
​
sortBy
string
default:"createdAt"
Sort field: createdAt, name, duration
​
order
string
default:"desc"
Sort order: asc or desc

​
Response

​
data
array
Array of audio objects
​
pagination
object
Pagination metadata (page, limit, total, totalPages)
curl "https://api.musique.app/api/audio?page=1&limit=10&category=announcement" \
  -H "X-API-Key: msk_live_1234567890abcdef"

{
  "data": [
    {
      "audioId": "aud_9x8y7z6w5v4u3t",
      "name": "Store Announcement",
      "description": "New product launch",
      "category": "announcement",
      "url": "https://cdn.musique.app/audio/aud_9x8y7z6w5v4u3t.mp3",
      "duration": 45.2,
      "size": 1024000,
      "format": "mp3",
      "createdAt": "2024-01-15T10:30:00Z"
    },
    {
      "audioId": "aud_1a2b3c4d5e6f7g",
      "name": "Emergency Alert",
      "description": "Fire drill announcement",
      "category": "announcement",
      "url": "https://cdn.musique.app/audio/aud_1a2b3c4d5e6f7g.mp3",
      "duration": 30.5,
      "size": 768000,
      "format": "mp3",
      "createdAt": "2024-01-14T09:15:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "totalPages": 1
  }
}

​
Filtering Examples

# Search by name
curl "https://api.musique.app/api/audio?search=announcement"

# Filter by category, sorted by name
curl "https://api.musique.app/api/audio?category=promotion&sortBy=name&order=asc"

# Paginate through large libraries
curl "https://api.musique.app/api/audio?page=2&limit=50"