[中文]

用途:

获取特定音乐的详细信息和使用数据

分析音乐的受众分布、使用趋势等多维度数据

帮助选择合适的背景音乐提升广告效果

参数:

clip_id: 音乐ID，必填参数

period: 时间范围（天），如7、30、120天

country_code: 国家代码，如US、UK、JP等

返回内容说明:

disliked: 是否不喜欢（可能为null）

like_count: 点赞数（可能为null）

liked: 是否点赞（可能为null）

sound: 音乐详细信息

audience_ages: 受众年龄分布

age_level: 年龄级别

score: 分数

audience_countries: 受众国家分布

country_info: 国家信息

id: 国家ID

label: 国家标签

value: 国家名称

score: 分数

audience_interests: 受众兴趣分布

interest_info: 兴趣信息

score: 分数

author: 音乐作者

clip_id: 片段ID

country_code: 国家代码

cover: 封面图URL

duration: 时长（秒）

if_cml: 是否商业音乐

is_search: 是否搜索结果

link: 音乐链接

longevity: 持久度信息

popular_days: 流行天数

current_popularity: 当前流行度

music_url: 音乐播放URL（可能为null）

on_list_times: 上榜次数（可能为null）

promoted: 是否推广

rank: 排名（可能为null）

rank_diff: 排名变化（可能为null）

related_items: 相关视频列表

item_id: 视频ID

cover_uri: 封面URI

song_id: 歌曲ID

title: 音乐标题

trend: 趋势数据

time: 时间戳

value: 数值

url_title: URL标题

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_sound_detail",
  "params": {
    "clip_id": "7251810329461147649",
    "period": 120,
    "country_code": "US"
  },
  "data": {
    "sound": {
      "title": "Upbeat Summer Vibes",
      "author": "Music Producer",
      "duration": 30,
      "music_url": "https://music.tiktok.com/xxx",
      "cover_url": "https://p16-sign-sg.tiktokcdn.com/xxx",
      "audience_ages": [
        {"age_level": "18-24", "percentage": 45.2},
        {"age_level": "25-34", "percentage": 32.8}
      ],
      "audience_countries": [
        {"country": "US", "percentage": 35.6},
        {"country": "UK", "percentage": 18.4}
      ],
      "related_items": ["7213258221116751874", "7213258221116751875"],
      "usage_trend": [
        {"date": "2025-01-01", "count": 1234},
        {"date": "2025-01-02", "count": 1456}
      ]
    }
  }
}

[English]

Purpose:

Get detailed information and usage data for specific music

Analyze multi-dimensional data like audience distribution and usage trends

Help select appropriate background music to enhance ad effectiveness

Parameters:

clip_id: Sound clip ID, required parameter

period: Time period in days, e.g., 7, 30, 120 days

country_code: Country code, e.g., US, UK, JP

Return Description:

sound: Sound detailed information

title: Music title

author: Music author/artist

duration: Duration in seconds

music_url: Music playback URL

cover_url: Cover image URL

audience_ages: Audience age distribution

age_level: Age range

percentage: Share percentage

audience_countries: Audience country distribution

country: Country code

percentage: Share percentage

related_items: List of popular video IDs using this music

usage_trend: Usage trend data

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_sound_detail",
  "params": {
    "clip_id": "7251810329461147649",
    "period": 120,
    "country_code": "US"
  },
  "data": {
    "sound": {
      "title": "Upbeat Summer Vibes",
      "author": "Music Producer",
      "duration": 30,
      "music_url": "https://music.tiktok.com/xxx",
      "cover_url": "https://p16-sign-sg.tiktokcdn.com/xxx",
      "audience_ages": [
        {"age_level": "18-24", "percentage": 45.2},
        {"age_level": "25-34", "percentage": 32.8}
      ],
      "audience_countries": [
        {"country": "US", "percentage": 35.6},
        {"country": "UK", "percentage": 18.4}
      ],
      "related_items": ["7213258221116751874", "7213258221116751875"],
      "usage_trend": [
        {"date": "2025-01-01", "count": 1234},
        {"date": "2025-01-02", "count": 1456}
      ]
    }
  }
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

{ "code": 200, "request_id": "string", "message": "Request successful. This request will incur a charge.", "message_zh": "请求成功，本次请求将被计费。", "support": "Discord: https://discord.gg/aMEAS8Xsvz", "time": "string", "time_stamp": 0, "time_zone": "America/Los_Angeles", "docs": "string", "cache_message": "string", "cache_message_zh": "string", "cache_url": "string", "router": "", "params": {}, "data": null }

获取音乐详情/Get sound detail

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response:

Request

Responses

获取音乐详情/Get sound detail

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request

Responses

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response: