查询 Business 热门音乐 API｜灵途 AI 开发文档

开发者文档 / 带货内容发布

GET/v1/creator/tiktokBusiness/trendingMusic

鉴权：: 请求头 x-api-key: <YOUR_API_KEY>；密钥仅保存在服务端。
成功判断：: HTTP 2xx 且响应 code=0；异步任务还需查询最终状态。

Query 参数

字段	类型	必填	说明
`id`	`integer`	是	账号 ID（creator_account_tk.id）
`genre`	`string`	否	音乐类型，不传按 ALL；取值如 POP、FOLK、HIP_HOP/RAP、K-POP 等（平台 genre 列表）
`countryCode`	`string`	否	地区代码，不传按 US
`dateRange`	`string`	否	榜单时间范围：1DAY / 7DAY / 30DAY / 90DAY，不传按 7DAY

自有账号发布页选曲：查 TikTok 商用音乐库（CML）热门曲目，最多 100 首，平台已预授权，可用于自然流量内容与广告创建。 - 实时查平台，不落库不缓存：榜单每天都在变，试听地址平台只保证 6 小时有效。 - 返回的 musicSoundId 是平台的 song_clip_id，发布视频时作为 music_sound_id 传入；commercialMusicId 只用于展示与排查，拿它发布平台会拒绝。 - 取不到可发布 ID（song_clip_id）的曲目不会返回，避免用户选到发不出去的曲子。 - 账号的 open_id 作为平台的 business_id，后端自动取，不用前端传。 - 平台判定授权失效时会把该账号置为失效并返回「授权过期，请重新授权」；只是访问令牌需要续期时返回「账号授权需要续期，请稍后重试」。

成功响应

{
  "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
}

响应与错误

主要响应字段来自接口规范；完整层级、联合类型和校验规则见 JSON Schema。必填指字段所在对象中的约束。

字段	类型	必填	说明
`code`	`integer`	是	—
`message`	`string`	是	—
`data`	`object`	是	—
`data.music`	`object[]`	是	—
`data.music[].musicSoundId`	`string`	是	发布时传给 music_sound_id，取平台的 song_clip_id
`data.music[].commercialMusicId`	`string`	否	平台商用音乐库曲目 ID，只用于展示与排查，不能当 music_sound_id 用
`data.music[].name`	`string`	否	曲目名称
`data.music[].artist`	`string`	否	歌手
`data.music[].duration`	`integer`	否	时长（秒）；平台只给片段时可能为 0
`data.music[].coverUrl`	`string`	否	缩略图地址
`data.music[].previewUrl`	`string`	否	试听地址，平台只保证 6 小时有效
`data.music[].genres`	`string[]`	否	—
`data.music[].rankPosition`	`string`	否	该曲目在所选地区的当前排名
`timestamp`	`integer`	是	—

参数、权限或授权错误需先修正。创建发布或生成任务超时后先查询已有任务，避免重复创建；不要因轮询中断而重复提交。

最后更新 · 2026-09-29