KuGouMusicApi功能清单详解131个接口分类梳理从登录、榜单到AI推荐全覆盖【免费下载链接】KuGouMusicApi酷狗音乐 Node.js API service项目地址: https://gitcode.com/gh_mirrors/ku/KuGouMusicApiKuGouMusicApi 是一款酷狗音乐 Node.js API 服务将酷狗官方接口逆向封装为 130 个 REST 风格路由覆盖登录认证、歌曲播放、歌单专辑、榜单推荐、评论互动、AI 推荐、听书曲谱等全部场景。本文按分类完整梳理这 131 个接口的功能清单帮助你快速定位需要的酷狗音乐 API 接口并给出快速上手与进阶使用建议。一、为什么选择 KuGouMusicApi对于想搭建酷狗音乐播放器、听歌小程序、音乐数据工具的新手来说这个项目解决了三大痛点痛点KuGouMusicApi 的解法酷狗接口有签名校验调用复杂自动完成签名Android/Web/Register 三种你只需传业务参数设备标识MID/GUID/MAC难以伪造服务启动时自动生成设备指纹请求自动注入接口分散、文档零散一个文件一个接口文件名即路由见 docs/README.md项目核心架构极简服务端入口server.js 负责 Express 路由注册、CORS、Cookie 解析与 2 分钟响应缓存接口模块module/ 目录每个.js文件对应一个接口签名与加密util/helper.js 与 util/crypto.js请求封装util/request.js 统一处理签名、代理与响应 一个巧妙的细节文件名中的下划线_会被自动替换为/作为路由例如user_detail.js→/user/detail。二、131个接口分类总览分类接口数约代表接口登录与账号17手机登录、二维码登录、QQ/微信登录用户与个人中心28用户详情、云盘、听歌历史、偏好设置歌单管理16歌单详情、增删歌曲、相似歌单专辑与唱片4新碟上架、专辑详情、动态封面歌手相关11歌手详情、歌手专辑、关注歌手歌曲与播放15获取音乐URL、高潮片段、K歌数量搜索7综合搜索、热搜榜、歌词搜索榜单排行5排行榜信息、往期榜单、歌曲列表评论互动11歌曲评论、楼层评论、弹幕推荐与 AI12每日推荐、私人FM、AI推荐听书长音频9听书推荐、听书搜索、专辑详情曲谱Sheet6曲谱广场、曲谱详情、曲谱排行音效6耳机音效、明星音效、汽车音效一起听/房间7音乐室聊天、发现、房间管理视频/MV5视频详情、视频URL、MV列表场景音乐8场景歌单、场景视频、场景讨论区频道youth17频道详情、音乐故事、频道订阅概念版 VIP17领VIP、组队领VIP、VIP升级其他11服务器时间、刷刷、IP专区三、登录与账号体系17个接口登录是使用需要鉴权的接口用户数据、收藏、云盘等的前提。项目提供了业内少见的六种登录方式3.1 登录方式速查登录方式接口路由源码手机验证码登录/login/cellphonemodule/login_cellphone.js密码登录/loginmodule/login.jsQQ 授权登录/login/qqmodule/login_qq.js微信扫码登录/login/wx/create/login/wx/checkmodule/login_wx_create.js酷狗二维码登录/login/qr/create/login/qr/checkmodule/login_qr_create.js概念版开放平台登录/login/openplatmodule/login_openplat.js3.2 账号管理辅助接口发送验证码/captcha/sentmodule/captcha_sent.js刷新登录态/login/token延长 token 过期时间踢设备下线module/login_device_kick.js用户校验module/user_verify.js 获取 Auth供歌曲 Auth 接口使用⚠️新手提示文档明确提醒不要频繁调登录接口不然可能会被风控。另外标准版和概念版lite的 token不通用通过.env中的platform环境变量切换。四、用户与个人中心28个接口这是接口数量最多的分类之一让你的应用拥有账号感基础信息用户详情 module/user_detail.js、VIP 信息 module/user_vip_detail.js听歌数据听歌历史排行 module/user_listen.js、最近历史 module/user_history.js、继续播放 module/lastest_songs_listen.js云盘云盘列表、上传、删除、URL 获取module/user_cloud_upload.js听歌偏好读取/更新偏好标签 module/user_preference.js、module/user_preference_update.js可调整推荐风格权重等级体系听歌等级 module/user_grade_info.js、听歌时长上报 module/user_listen_report.js五、歌单与专辑20个接口5.1 歌单 CRUD 全覆盖功能路由源码歌单详情/playlist/detailmodule/playlist_detail.js歌单全量歌曲/playlist/track/allmodule/playlist_track_all.js收藏/新建歌单/playlist/addmodule/playlist_add.js删除歌单/playlist/delmodule/playlist_del.js歌单加歌/删歌/playlist/tracks/addmodule/playlist_tracks_add.js相似歌单推荐/playlist/similarmodule/playlist_similar.js导入外部歌单/import/playlistmodule/import_playlist.js5.2 专辑功能新碟上架module/album.js专辑详情/歌曲列表module/album_detail.js、module/album_songs.js动态封面module/album_dycover.js2026-09 新增专辑购买module/album_shop.js六、歌曲播放核心接口15个这是播放器的心脏新手必看的三个接口获取音乐 URL—/song/urlmodule/song_url.js输入歌曲 hash 返回播放地址搜索歌曲—/searchmodule/search.js拿到 song id 和 hash 的桥梁获取歌词—/lyricmodule/lyric.js自动解码加密歌词进阶能力歌曲高潮片段module/song_climax.js实现15秒试听功能音乐版本module/audio_related.js 获取同一首歌的不同翻唱版本K歌数据module/audio_ktv_total.js多版本 URL 接口module/song_url_new.js、module/song_url_auth.js概念版鉴权版本搜索家族7个接口接口说明/search单曲搜索核心/search/complex综合搜索module/search_complex.js/search/hot热搜榜/search/suggest输入联想建议/search/lyric以词搜曲/search/mixed混合搜索/search/default默认搜索关键词七、榜单排行与推荐系统17个接口7.1 排行榜5个接口榜单数据是音乐 App 的流量入口榜单列表module/rank_list.js榜单歌曲module/rank_top.js往期榜单module/rank_audio.js榜单信息module/rank_info.js7.2 个性化推荐12个接口推荐类型接口每日推荐module/everyday_recommend.js私人 FM猜你喜欢module/personal_fm.js歌曲推荐module/recommend_songs.jsAI 推荐module/ai_recommend.jsAI 推荐歌曲module/ai_recommend_song.js风格推荐module/everyday_style_recommend.js其中AI 推荐接口是 2024-07 新加入的亮点基于用户听歌画像生成推荐配合user/preference偏好接口可实现高度个性化的推荐闭环。八、评论与互动17个接口歌曲评论module/comment_music.js支持按分类/热词过滤楼层评论module/comment_floor.js发送评论comment/*_send.js系列如 module/comment_music_send.js弹幕歌曲弹幕/视频弹幕的读取与发送module/song_barrage.js评论计数module/comment_count.js九、特色内容生态听书/曲谱/音效/一起听9.1 听书长音频9个接口module/longaudio_daily_recommend.js 每日推荐、module/longaudio_rank_recommend.js 排行榜、module/longaudio_search.js 搜索覆盖有声书完整消费链路。9.2 曲谱6个接口吉他谱爱好者的福音曲谱广场 module/sheet_explore.js、曲谱详情 module/sheet_detail.js、曲谱排行 module/sheet_rank.js。9.3 音效6个接口2026-08 新增的音效生态耳机音效列表 module/effects_brand.js、明星音效 module/effects_artist.js、汽车音效 module/effects_car_brand.js。9.4 一起听7个接口2026-08 新增的实时社交功能音乐室聊天 module/listen_together_chat.js、房间管理 module/listen_together_room.js、众乐房发现 module/listen_together_discovery.js。十、频道与概念版youth专属34个接口频道体系youth是 KuGouMusicApi 独有的大型模块频道发现module/youth_channel_detail.js 详情、module/youth_channel_similar.js 相似频道音乐故事module/youth_channel_song_detail.js动态module/youth_dynamic.js概念版 VIP 体系17个接口提供领 VIP、组队领 VIP、月度 VIP 记录等接口均为测试性质如 module/youth_day_vip.js使用前请仔细阅读项目免责声明。十一、快速上手三步跑起来git clone https://gitcode.com/gh_mirrors/ku/KuGouMusicApi cd KuGouMusicApi npm install npm run dev服务默认运行在3000 端口之后即可直接访问GET /search?keyword晴天 GET /song/url?hashxxx GET /playlist/detail?idxxx关键配置环境变量作用platformlite切换酷狗概念版token 不通用注意区分PORT/HOST自定义端口与监听地址KUGOU_API_PROXY配置 HTTP 代理KUGOU_API_GUID自定义设备指纹建议 UUID v4十二、使用注意事项避坑指南缓存机制所有接口有 2 分钟缓存util/apicache.js登录、二维码轮询等需实时结果的接口请追加timestamp参数Cookie 传递登录后的token;userid可通过 URL 参数、请求体或Authorization头三种方式传入跨域请求需携带withCredentials: trueaxios风控风险不要高频调用登录接口本项目仅供学习24 小时内清除版权数据请勿商用部署支持提供 Dockerfile、vercel.json一键部署到 Vercel/Docker十三、总结KuGouMusicApi 以一个文件一个接口的极简设计把酷狗音乐的 131 个能力封装成了开箱即用的 REST API。无论你是想做一个私人音乐播放器搜索 播放URL 歌词三件套还是数据可视化看板榜单 听歌历史 推荐抑或AI 音乐助手AI推荐 偏好设置都能在这份功能清单中找到对应接口。完整接口文档见 docs/README.md启动服务后访问/docs还可在线查阅交互式文档。【免费下载链接】KuGouMusicApi酷狗音乐 Node.js API service项目地址: https://gitcode.com/gh_mirrors/ku/KuGouMusicApi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
