[中文]

用途:

搜索符合条件的音乐列表

支持按关键词、热度、商业类型等多维度筛选

为广告配乐选择提供全面的搜索功能

参数:

keyword: 搜索关键词

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

page: 页码，默认1

limit: 每页数量，默认20

rank_type: 排行类型，"popular"=热门，"surging"=上升最快

new_on_board: 是否只看新上榜音乐

commercial_music: 是否只看商业音乐

country_code: 国家代码

返回内容说明:

sound_list: 音乐列表

id: 音乐ID

title: 音乐标题

author: 音乐作者

duration: 时长（秒）

trend: 趋势数据

related_items: 使用该音乐的视频数量

is_commercial: 是否商业音乐

pagination: 分页信息

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/search_sound",
  "params": {
    "keyword": "taylor swift",
    "period": 7,
    "page": 1
  },
  "data": {
    "sound_list": [
      {
        "id": "7156826385225353217",
        "title": "Karma",
        "author": "Taylor Swift",
        "duration": 30,
        "trend": [
          {"time": 1746000000, "value": 15000}
        ],
        "related_items": 5678,
        "is_commercial": true
      }
    ],
    "pagination": {
      "page": 1,
      "size": 20,
      "total": 156,
      "has_more": true
    }
  }
}

[English]

Purpose:

Search for music lists matching criteria

Support multi-dimensional filtering by keyword, popularity, commercial type, etc.

Provide comprehensive search functionality for ad soundtrack selection

Parameters:

keyword: Search keyword

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

page: Page number, default 1

limit: Items per page, default 20

rank_type: Ranking type, "popular"=Popular, "surging"=Fastest rising

new_on_board: Only show newly trending music

commercial_music: Only show commercial music

country_code: Country code

Return Description:

sound_list: Music list

id: Music ID

title: Music title

author: Music author

duration: Duration in seconds

trend: Trend data

related_items: Number of videos using this music

is_commercial: Whether commercial music

pagination: Pagination info

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/search_sound",
  "params": {
    "keyword": "taylor swift",
    "period": 7,
    "page": 1
  },
  "data": {
    "sound_list": [
      {
        "id": "7156826385225353217",
        "title": "Karma",
        "author": "Taylor Swift",
        "duration": 30,
        "trend": [
          {"time": 1746000000, "value": 15000}
        ],
        "related_items": 5678,
        "is_commercial": true
      }
    ],
    "pagination": {
      "page": 1,
      "size": 20,
      "total": 156,
      "has_more": true
    }
  }
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

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

🟠422Parameter Error

搜索音乐/Search sounds

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request