[中文]

用途:

获取音乐搜索的自动完成提示和推荐

帮助用户快速找到相关音乐

提供搜索建议优化音乐选择

参数:

keyword: 搜索关键词

period: 时间范围（天）

page: 页码，默认1

limit: 每页数量，默认5

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

country_code: 国家代码

filter_by_checked: 是否只看已验证音乐

commercial_music: 是否只看商业音乐

返回内容说明:

sound_list: 音乐提示列表

title: 音乐标题

author: 音乐作者

match_type: 匹配类型（标题/作者/标签）

popularity: 热度评分

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/search_sound_hint",
  "params": {
    "keyword": "taylor swift",
    "limit": 5
  },
  "data": {
    "sound_list": [
      {
        "title": "Anti-Hero",
        "author": "Taylor Swift",
        "match_type": "artist",
        "popularity": 98
      },
      {
        "title": "Blank Space",
        "author": "Taylor Swift",
        "match_type": "artist",
        "popularity": 95
      }
    ]
  }
}

[English]

Purpose:

Get auto-complete hints and recommendations for music search

Help users quickly find relevant music

Provide search suggestions to optimize music selection

Parameters:

keyword: Search keyword

period: Time period in days

page: Page number, default 1

limit: Items per page, default 5

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

country_code: Country code

filter_by_checked: Only show verified music

commercial_music: Only show commercial music

Return Description:

sound_list: Music hint list

title: Music title

author: Music author

match_type: Match type (title/artist/tag)

popularity: Popularity score

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/search_sound_hint",
  "params": {
    "keyword": "taylor swift",
    "limit": 5
  },
  "data": {
    "sound_list": [
      {
        "title": "Anti-Hero",
        "author": "Taylor Swift",
        "match_type": "artist",
        "popularity": 98
      },
      {
        "title": "Blank Space",
        "author": "Taylor Swift",
        "match_type": "artist",
        "popularity": 95
      }
    ]
  }
}

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
}

🟠422Unprocessable Entity

搜索音乐提示/Search sound hints

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request