您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。
List TikTok Business trending music
Developer docs / Music and locations

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).

GET/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

FieldTypeRequiredDescription
idintegerYesCreator account ID
genrestringNoMusic genre; defaults to ALL
countryCodestringNoCountry code; defaults to US
dateRangestringNoChart period; defaults to 7DAY
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).
Success response
{
  "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.

FieldTypeRequiredDescription
codeintegerYes—
messagestringYes—
dataobjectYes—
data.musicobject[]Yes—
data.music[].musicSoundIdstringYesPassed as music_sound_id when publishing; use the platform song_clip_id
data.music[].commercialMusicIdstringNoCommercial music library track ID for display and troubleshooting only; never use it as music_sound_id
data.music[].namestringNoTrack title
data.music[].artiststringNoArtist
data.music[].durationintegerNoDuration in seconds; may be 0 when the platform only provides a clip
data.music[].coverUrlstringNoCover image URL
data.music[].previewUrlstringNoPreview URL; the platform guarantees it for six hours only
data.music[].genresstring[]No—
data.music[].rankPositionstringNoCurrent rank of the track in the selected region
timestampintegerYes—

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