curl -X GET "https://api.hooked.so/v1/music/list?category=Electronic" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/music/list?category=Electronic', {
headers: { 'x-api-key': 'your_api_key_here' }
});
const { data } = await response.json();
console.log(data.music[0]?.id);
import requests
response = requests.get(
'https://api.hooked.so/v1/music/list',
params={'genre': 'Electronic'},
headers={'x-api-key': 'your_api_key_here'}
)
tracks = response.json()['data']['music']
{
"success": true,
"data": {
"music": [
{
"id": "1",
"name": "Bladerunner 2049",
"url": "https://.../music/audio/bladerunner-2049.mp3",
"thumbnail": "https://.../music/thumbnail/bladerunner-2049.jpg",
"category": "Futuristic",
"duration": "03:00",
"genres": ["Futuristic", "Electronic"]
}
],
"categories": [
{ "id": 1, "name": "Electronic", "description": "Electronic music collection" },
{ "id": 2, "name": "Pop", "description": "Pop music collection" }
],
"total": 1
}
}
Resources
List Music
Get the background music tracks you can use in videos
GET
/
v1
/
music
/
list
curl -X GET "https://api.hooked.so/v1/music/list?category=Electronic" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/music/list?category=Electronic', {
headers: { 'x-api-key': 'your_api_key_here' }
});
const { data } = await response.json();
console.log(data.music[0]?.id);
import requests
response = requests.get(
'https://api.hooked.so/v1/music/list',
params={'genre': 'Electronic'},
headers={'x-api-key': 'your_api_key_here'}
)
tracks = response.json()['data']['music']
{
"success": true,
"data": {
"music": [
{
"id": "1",
"name": "Bladerunner 2049",
"url": "https://.../music/audio/bladerunner-2049.mp3",
"thumbnail": "https://.../music/thumbnail/bladerunner-2049.jpg",
"category": "Futuristic",
"duration": "03:00",
"genres": ["Futuristic", "Electronic"]
}
],
"categories": [
{ "id": 1, "name": "Electronic", "description": "Electronic music collection" },
{ "id": 2, "name": "Pop", "description": "Pop music collection" }
],
"total": 1
}
}
Overview
Lists the library’s background music tracks. Pass a track’sid as musicId in the create endpoints. The list is not paginated: every matching track comes back in one response, with the category list (categories) for building a picker.
curl -X GET "https://api.hooked.so/v1/music/list?category=Electronic" \
-H "x-api-key: your_api_key_here"
const response = await fetch('https://api.hooked.so/v1/music/list?category=Electronic', {
headers: { 'x-api-key': 'your_api_key_here' }
});
const { data } = await response.json();
console.log(data.music[0]?.id);
import requests
response = requests.get(
'https://api.hooked.so/v1/music/list',
params={'genre': 'Electronic'},
headers={'x-api-key': 'your_api_key_here'}
)
tracks = response.json()['data']['music']
{
"success": true,
"data": {
"music": [
{
"id": "1",
"name": "Bladerunner 2049",
"url": "https://.../music/audio/bladerunner-2049.mp3",
"thumbnail": "https://.../music/thumbnail/bladerunner-2049.jpg",
"category": "Futuristic",
"duration": "03:00",
"genres": ["Futuristic", "Electronic"]
}
],
"categories": [
{ "id": 1, "name": "Electronic", "description": "Electronic music collection" },
{ "id": 2, "name": "Pop", "description": "Pop music collection" }
],
"total": 1
}
}
Errors
| Status | When |
|---|---|
| 401 | Missing or invalid API key (code: "not_authenticated") |
| 403 | The team does not have the Hooked app product (code: "entitlement_required") |
| 500 | { "success": false, "message": "Failed to fetch music tracks" } |
Authorizations
Query Parameters
Only tracks of this category, case-insensitive exact match (for example Electronic, Pop, Cinematic).
Only tracks tagged with this genre, case-insensitive exact match.