获取音乐搜索/Fetch music search

[中文]

用途:

• 获取抖音 App 中音乐内容的搜索结果。
• 支持关键词、排序方式、筛选条件等。

备注:

• 本接口专注于音乐类内容搜索，不包含其他类型内容。
• 初次请求时 cursor 传 0，search_id 传空字符串。
• 返回内容包含音乐基本信息、作者信息、封面、播放地址、标签等。

参数:

• keyword: 搜索关键词，例如 "游戏背景音乐"
• cursor: 翻页游标（首次请求传 0，翻页时使用上次响应的 cursor）
• sort_type: 排序方式
  • 0: 综合排序
  • 1: 最多点赞
  • 2: 最新发布
• publish_time: 发布时间筛选
  • 0: 不限
  • 1: 最近一天
  • 7: 最近一周
  • 180: 最近半年
• filter_duration: 视频时长筛选
  • 0: 不限
  • 0-1: 1 分钟以内
  • 1-5: 1-5 分钟
  • 5-10000: 5 分钟以上
• content_type: 内容类型筛选
  • 0: 不限
  • 1: 视频
  • 2: 图片
  • 3: 文章
• search_id: 搜索ID（分页时使用）

请求体示例：

payload = {
    "keyword": "游戏背景音乐",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

• music: 音乐结果列表
  • id_str: 音乐ID（字符串格式）
  • title: 音乐标题
  • author: 音乐作者昵称
  • album: 所属专辑（如果有）
  • play_url.url_list: 音乐播放地址列表
  • duration: 音乐时长（秒）
  • cover_thumb.url_list: 缩略封面图片列表
  • cover_medium.url_list: 中尺寸封面图片列表
  • cover_large.url_list: 高清封面图片列表
  • user_count: 使用该音乐的作品数量
  • is_original: 是否原创音乐
  • is_commerce_music: 是否为商业授权音乐
  • lyric_url: 歌词文件链接（如果有）
  • strong_beat_url.url_list: 音乐节奏点文件链接
  • tags: 音乐标签
    • 如：主题（如游戏、Vlog）、情绪（如Funny）、风格（如8-bit, Electronic）
  • artists: 音乐关联的创作者列表（如果有）
    • artist_name: 艺人昵称
    • uid: 艺人UID
  • cover_color_hsv: 封面主色调HSV值
  • can_background_play: 是否支持后台播放

[English]

Purpose:

• Fetch music content search results from Douyin App.
• Supports filtering by keyword, sort type, etc.

Notes:

• This API focuses on music content search, excluding other types.
• Set cursor to 0 and search_id to an empty string for the first request.
• Response includes music basic info, artist info, covers, play URLs, tags, etc.

Parameters:

• keyword: Search keyword, e.g., "game background music"
• cursor: Pagination cursor (0 for first request)
• sort_type: Sorting method
  • 0: Comprehensive
  • 1: Most likes
  • 2: Latest
• publish_time: Publish time filter
  • 0: Unlimited
  • 1: Last day
  • 7: Last week
  • 180: Last half year
• filter_duration: Video duration filter
  • 0: Unlimited
  • 0-1: Under 1 minute
  • 1-5: 1 to 5 minutes
  • 5-10000: Over 5 minutes
• content_type: Content type filter
  • 0: Unlimited
  • 1: Video
  • 2: Image
  • 3: Article
• search_id: Search ID for pagination

Request Body Example:

payload = {
    "keyword": "game background music",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}

Response (common fields, actual response may contain more fields):

• music: List of music search results
  • id_str: Music ID (as string)
  • title: Music title
  • author: Music author's nickname
  • album: Album name (if any)
  • play_url.url_list: List of music play URLs
  • duration: Duration in seconds
  • cover_thumb.url_list: List of thumbnail cover URLs
  • cover_medium.url_list: List of medium-sized cover URLs
  • cover_large.url_list: List of large-sized cover URLs
  • user_count: Number of videos using this music
  • is_original: Whether it is original music
  • is_commerce_music: Whether it is commercial music
  • lyric_url: Lyrics file URL (if available)
  • strong_beat_url.url_list: Beat timing file URLs
  • tags: Music tags
    • Themes (e.g., Game, Vlog), Moods (e.g., Funny), Genres (e.g., 8-bit, Electronic)
  • artists: List of associated artists (if any)
    • artist_name: Artist name
    • uid: Artist UID
  • cover_color_hsv: Dominant HSV color of the cover
  • can_background_play: Whether background playback is supported

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.