List TikTok Business trending music
Queries up to 100 live commercial music library tracks without local storage or caching. Preview URLs are guaranteed for only six hours. Publish using musicSoundId (song_clip_id), never commercialMusicId. Tracks without song_clip_id are omitted. The server resolves business_id from the account open_id. Expired authorization returns “授权过期,请重新授权” (authorization expired, reauthorize); token renewal returns “账号授权需要续期,请稍后重试” (authorization needs renewal, retry later).
/v1/creator/tiktokBusiness/trendingMusic- Authentication:
- Request header x-api-key: <YOUR_API_KEY>; keep the key on the server and never expose it in client code, logs or shared files.
- Success criteria:
- HTTP 2xx with code=0; for asynchronous tasks, also query the final status.
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | Creator account ID |
genre | string | No | Music genre; defaults to ALL |
countryCode | string | No | Country code; defaults to US |
dateRange | string | No | Chart period; defaults to 7DAY |
{
"code": 0,
"message": "success",
"data": {
"music": [
{
"musicSoundId": "7123456789012345678",
"commercialMusicId": "1234567890",
"name": "Sunrise",
"artist": "Example artist",
"duration": 123,
"coverUrl": "https://cdn.example.com/cover.jpg",
"previewUrl": "https://cdn.example.com/preview.mp3",
"genres": [
"POP"
],
"rankPosition": "3"
}
]
},
"timestamp": 1790640000000
}Response and errors
Main response fields come from the published contract; see the JSON Schema. Required refers to the constraint in the containing object.
| Field | Type | Required | Description |
|---|---|---|---|
code | integer | Yes | — |
message | string | Yes | — |
data | object | Yes | — |
data.music | object[] | Yes | — |
data.music[].musicSoundId | string | Yes | Passed as music_sound_id when publishing; use the platform song_clip_id |
data.music[].commercialMusicId | string | No | Commercial music library track ID for display and troubleshooting only; never use it as music_sound_id |
data.music[].name | string | No | Track title |
data.music[].artist | string | No | Artist |
data.music[].duration | integer | No | Duration in seconds; may be 0 when the platform only provides a clip |
data.music[].coverUrl | string | No | Cover image URL |
data.music[].previewUrl | string | No | Preview URL; the platform guarantees it for six hours only |
data.music[].genres | string[] | No | — |
data.music[].rankPosition | string | No | Current rank of the track in the selected region |
timestamp | integer | Yes | — |
Fix parameter, permission or authorization errors before retrying. If task creation times out, query existing tasks first and do not submit duplicates after an interrupted poll.
Last updated · 2026-11-16