search
Search API 返回模型定义.
pydantic-model
Bases: Song
搜索场景下的歌曲详尽模型.
| ATTRIBUTE | DESCRIPTION |
|---|---|
search_title |
搜索命中的标题 (可能包含高亮标签).
TYPE:
|
title_main |
歌曲主标题.
TYPE:
|
title_extra |
歌曲附加标题.
TYPE:
|
fav_show |
收藏数展示文案 (如 "5500w+").
TYPE:
|
tag |
标签 ID.
TYPE:
|
desc |
歌曲描述文案.
TYPE:
|
desc_icon |
描述文案前的图标链接.
TYPE:
|
content |
搜索结果内容摘要,当搜索命中歌词或特定评论时,该字段存放命中的文本片段.
TYPE:
|
hotness |
热度数据对象. |
hotness_desc |
热度描述 (如榜单名).
TYPE:
|
vec_hotness |
热度榜单详情列表. |
new_status |
新版状态位 (2: 正常).
TYPE:
|
protect |
是否受到版权保护.
TYPE:
|
relatedword_group |
相关搜索词推荐组. |
Fields:
-
id(int) -
mid(str) -
name(str) -
type(int) -
title(str) -
subtitle(str) -
singer(list[Singer]) -
album(Album) -
mv(MV) -
file(File) -
pay(Pay) -
interval(int) -
isonly(int) -
language(int) -
genre(int) -
index_cd(int) -
index_album(int) -
time_public(str) -
status(int) -
label(str) -
bpm(int) -
ov(int) -
sa(int) -
es(str) -
vs(list[str]) -
vi(list[int]) -
vf(list[float]) -
search_title(str) -
title_main(str) -
title_extra(str) -
fav_show(str) -
desc(str) -
desc_icon(str) -
hotness(dict[str, Any]) -
hotness_desc(str) -
vec_hotness(list[dict[str, Any]]) -
content(str) -
new_status(int) -
protect(int) -
relatedword_group(dict[str, Any])
pydantic-model
Bases: Album
搜索场景下的专辑详尽模型.
| ATTRIBUTE | DESCRIPTION |
|---|---|
album_type |
专辑类型标识 (来自 $.core_album_config.album_type).通常 1 代表正规专辑.
|
singer |
搜索命中的高亮歌手名称.通常包含
TYPE:
|
singer_list |
结构化的歌手对象列表.包含歌手的数字 ID 和标准名称. |
pic |
专辑封面图片 URL (通常为 180x180 或 300x300 规格).
TYPE:
|
pic_icon |
封面配套显示的勋章或类型图标链接.
TYPE:
|
publish_date |
专辑发行日期 (YYYY-MM-DD).
TYPE:
|
description |
简短描述文案.在搜索结果中常存放发行日期或厂牌.
TYPE:
|
description2 |
备用描述文案.
TYPE:
|
desc_detail |
详尽描述对象.包含长篇专辑介绍及背景信息. |
hotness |
热度数据对象.包含收藏量、趋势等原始数值. |
hotness_desc |
热度简述文案.如“全网热搜”、“飙升榜前十”.
TYPE:
|
audio_play |
播放排行信息.包含榜单名称及具体排名.
TYPE:
|
label_new |
专辑关联的特性标签对象. |
tag_list |
专辑标签列表.用于 UI 显示“数字专辑”、“独家”等勋章. |
url |
静态元数据下载链接.
TYPE:
|
Fields:
-
id(int) -
mid(str) -
name(str) -
title(str) -
subtitle(str) -
time_public(str) -
pmid(str) -
desc_detail(dict[str, Any]) -
description(str) -
description2(str) -
type(int) -
award_label(str) -
hotness(dict[str, Any]) -
hotness_desc(str) -
label_new(dict[str, Any]) -
audio_play(RankingInfo) -
pic(str) -
pic_icon(str) -
singer(str) -
singer_list(list[Singer]) -
tag_list(list[str]) -
url(str)
pydantic-model
pydantic-model
Bases: Singer
搜索场景下的歌手模型.
| ATTRIBUTE | DESCRIPTION |
|---|---|
pic |
歌手头像地址.
TYPE:
|
song_num |
歌曲数量.
TYPE:
|
album_num |
专辑数量.
TYPE:
|
mv_num |
MV 数量.
TYPE:
|
subtitle |
补充描述文案.
TYPE:
|
Fields:
-
id(int) -
mid(str) -
name(str) -
title(str) -
type(int) -
uin(int) -
pmid(str) -
pic(str) -
song_num(int) -
album_num(int) -
mv_num(int) -
subtitle(str)
pydantic-model
Bases: MV
搜索场景下的 MV 模型.
| ATTRIBUTE | DESCRIPTION |
|---|---|
pic |
MV 封面地址.
TYPE:
|
play_count |
MV 播放量.
TYPE:
|
duration |
MV 时长.
TYPE:
|
publish_date |
发布时间.
TYPE:
|
singer_id |
歌手 ID.
TYPE:
|
singer_mid |
歌手 MID.
TYPE:
|
singer_name |
歌手名称.
TYPE:
|
Fields:
-
id(int) -
vid(str) -
type(int) -
name(str) -
title(str) -
pic(str) -
play_count(int) -
duration(int) -
publish_date(str) -
singer_id(int) -
singer_mid(str) -
singer_name(str)
pydantic-model
pydantic-model
pydantic-model
Bases: Response
按指定类型搜索时的响应模型.
它将元信息与对应分类的实体列表放在同一对象中,便于直接消费该类型下的当前页结果.
| ATTRIBUTE | DESCRIPTION |
|---|---|
searchid |
搜索会话 ID,用于后续相关请求.
TYPE:
|
perpage |
每页结果数量.
TYPE:
|
nextpage |
下一页页码,-1 表示已加载全部结果.
TYPE:
|
estimate_sum |
搜索命中的预估总记录数.
TYPE:
|
total_num |
搜索命中的确切总记录数.
TYPE:
|
song |
单曲、歌词或节目类型下的结果列表.
TYPE:
|
singer |
歌手结果列表.
TYPE:
|
album |
专辑结果列表.
TYPE:
|
songlist |
歌单结果列表.
TYPE:
|
user |
用户结果列表. |
audio_alum |
节目专辑结果列表.
TYPE:
|
mv |
MV 结果列表. |
Fields:
-
searchid(str) -
perpage(int) -
nextpage(int) -
estimate_sum(int) -
total_num(int) -
song(list[SongSearch]) -
singer(list[SingerSearch]) -
album(list[AlbumSearch]) -
songlist(list[SongListSearch]) -
user(list[dict[str, Any]]) -
audio_alum(list[AlbumSearch]) -
mv(list[MvSearch])
pydantic-model
Bases: Response
综合搜索响应模型.
每个分类字段都是独立的结果容器,既给出当前已返回的数据,也保留该分类继续翻页所需的上下文.
| ATTRIBUTE | DESCRIPTION |
|---|---|
searchid |
搜索会话 ID,用于后续相关请求.
TYPE:
|
perpage |
每页结果数量.
TYPE:
|
nextpage |
下一页页码,-1 表示已加载全部结果.
TYPE:
|
nextpage_start |
综合搜索继续翻页的关键参数. |
song |
单曲结果容器. |
singer |
歌手结果容器. |
album |
专辑结果容器. |
mv |
MV 结果容器.
TYPE:
|
songlist |
歌单结果容器. |
audio |
节目结果容器. |
direct |
直接命中结果分组. |
related |
相关搜索词推荐结果容器. |
Fields:
-
searchid(str) -
perpage(int) -
nextpage(int) -
nextpage_start(dict[str, Any]) -
song(GeneralSearchRequestBody[SongSearch]) -
singer(GeneralSearchRequestBody[SingerSearch]) -
mv(GeneralSearchRequestBody[MvSearch]) -
album(GeneralSearchRequestBody[AlbumSearch]) -
songlist(GeneralSearchRequestBody[SongListSearch]) -
audio(GeneralSearchRequestBody[AlbumSearch]) -
direct(list[dict[str, Any]]) -
related(GeneralSearchRequestBody[RelatedSearchWord])