# 查询 Business 热门音乐

- API 版本：1.10.0
- 最后更新：2026-09-29
- 服务地址：`https://api.ailingtu.com`
- 网页文档：[查询 Business 热门音乐](/openapi/business-trending-music)
- 完整接口约束：[JSON Schema](/openapi/operations/listTikTokBusinessTrendingMusic.json)
- 接口发现：[接口索引](/openapi/operations/index.json)

## GET /v1/creator/tiktokBusiness/trendingMusic

接口标识：`listTikTokBusinessTrendingMusic`

查询 Business 热门音乐。

鉴权：请求头 `x-api-key: <YOUR_API_KEY>`；密钥仅保存在服务端。

成功判断：HTTP 2xx 且响应 code=0；异步任务还需查询最终状态。

### 请求参数

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

### 成功响应

```json
{
  "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 | 是 | — |

### 接入说明与限制

- 自有账号发布页选曲：查 TikTok 商用音乐库（CML）热门曲目，最多 100 首，平台已预授权，可用于自然流量内容与广告创建。

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

### 相关接口

- [创建发布任务](/openapi/create-post) · [Markdown](/openapi/operations/createCreatorPost.md)
- [编辑发布记录](/openapi/update-post) · [Markdown](/openapi/operations/updateCreatorPost.md)