REST API · Creatives
List TikTok music
TikTok carousels: the music a launch plan can give its image ads
GEThttps://api.apogee.ad/api/v1/ad-accounts/{acc}/tiktok-music
What it does
TikTok runs images as carousels with a music, from its carousel library. q: a keyword; without one, the musics this ad account used. Each gives its music_id for POST /launch-plans tiktok.ad_settings.music_id; none given, TikTok picks one for each carousel at the launch.
Request
GET /ad-accounts/{acc}/tiktok-music on https://api.apogee.ad/api/v1.
Path parameters
-
accstring path requiredTikTok advertiser id (GET /ad-accounts?platform=tiktok)
Query parameters
-
qstring query optional -
pagestring query optional
Headers
-
Authorizationstring header requiredBearer apk_…: an API key with the scope of this route.
Response
200.
-
musicsarray of objectsFields of each item (5)
-
music_idstring or null -
titlestring or null -
authorstring or null -
duration_secnumber or null -
preview_urlstring or null
-
-
availableboolean -
querystring or null -
pagenumber or null -
usestring or null
Every answer carries X-Request-Id (give it to support), Apogee-Version: 2026-10-06, and the RateLimit and RateLimit-Policy headers.
Errors
Errors are application/problem+json with a stable code to switch on (all the codes).
| Status | Possible codes |
|---|---|
| 400 Bad request | idempotency_key_required, not_supported, request_refused, validation_failed |
| 401 Unauthorized | invalid_api_key |
| 403 Forbidden | account_not_connected, forbidden, insufficient_scope, meta_permission_denied, platform_permission_denied, upgrade_required |
| 404 Not found | not_found |
| 429 Too many requests | daily_read_cap, meta_rate_limited, platform_rate_limited, quota_exceeded, rate_limited |
| 500 Internal server error | internal_error |
| 502 Bad gateway | drive_error, launch_failed, meta_error, platform_error, upstream_error |
Example
With your key in APOGEE_API_KEY (create one):
curl 'https://api.apogee.ad/api/v1/ad-accounts/7000000000000000001/tiktok-music' \
-H "Authorization: Bearer $APOGEE_API_KEY"{
"available": false,
"query": "spring jacket",
"page": 1,
"musics": [
{
"music_id": "120200000000000001",
"title": "Example text",
"author": "120200000000000001",
"duration_sec": 1,
"preview_url": "https://www.example.com/products/nordlicht-jacket"
}
],
"use": "120200000000000001"
}Access and cost
| Plans | Pro and Scale. |
|---|---|
| Scope | read (scopes). |
| Credits | Free up to the daily free reads (5,000 a day on Pro, 10,000 on Scale), then 1 credit per read. A request that fails costs nothing, a replayed one neither (credits). |
| Rate limit | Read: 600 per 15 minutes on Pro, 1,200 on Scale (rate limits). |
| Daily cap | Counts 1 unit toward the 2,000 units one API key can use in 24 hours. |
In the MCP
An AI assistant does the same with this tool of the MCP server:
list_tiktok_music: TikTok carousels (image ads run with a music): the music of TikTok's carousel library a launch can use.q: a keyword (e.g. "upbeat"); without one, the music this ad account used. Each gives itsmusic_idforprepare_launch(tiktok.ad_settings.music_id); none given, TikTok picks one for each carousel at the launch.
Related operations
- Create import:
POST /imports - Get import:
GET /imports/{id} - List drive folder:
GET /drive-folders - Create uploads:
POST /uploads - Confirm uploads:
POST /uploads/confirm - List TikTok posts:
GET /ad-accounts/{acc}/tiktok-posts - List platform templates:
GET /ad-accounts/{acc}/platform-templates