Skip to main content
GET
/
v2
/
musics
List background music
curl --request GET \
  --url https://api.jogg.ai/v2/musics \
  --header 'x-api-key: <api-key>'
{
  "code": 0,
  "msg": "Success",
  "data": {
    "music": [
      {
        "id": 1,
        "name": "Upbeat Background",
        "music_url": "https://res.jogg.ai/music/example.mp3",
        "duration": 120
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 10,
      "total_items": 100,
      "total_pages": 10
    }
  }
}
Browse JoggAI’s library of royalty-free background music.

​
Example Usage

curl --request GET \
  --url 'https://api.jogg.ai/v2/musics' \
  --header 'x-api-key: YOUR_API_KEY'

​
Query Parameters

  • genre - Filter by genre (e.g., “Corporate”, “Ambient”)
  • mood - Filter by mood (e.g., “Energetic”, “Calm”)

Authorizations

​
x-api-key
string
header
required

API key for authentication. Obtain your key from the JoggAI dashboard.

Query Parameters

​
page
integer
default:1

Page number

Required range: x >= 1
​
page_size
integer
default:10

Items per page

Required range: 1 <= x <= 100

Response

200 - application/json

Success

​
code
integer
required

Business status code:

  • 0 - Success
  • 10104 - Record not found
  • 10105 - Invalid API key
  • 18020 - Insufficient credit
  • 18025 - No permission to call APIs
  • 40000 - Parameter error
  • 50000 - System error
Example:

0

​
msg
string
required

Response message

Example:

"Success"

​
data
object