[中文]

用途:

获取抖音 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

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

Example

{
    "keyword": "猫咪",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}

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": "2025-09-16 03:14:36",
    "time_stamp": 1758017676,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取音乐搜索/Fetch music search

[中文]#

用途:#

备注:#

参数:#

请求体示例：#

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

[English]#

Purpose:#

Notes:#

Parameters:#

Request Body Example:#

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

Request

Request Code Samples

Responses

[中文]

用途:

备注:

参数:

请求体示例：

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

[English]

Purpose:

Notes:

Parameters:

Request Body Example:

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