后端【免费下载链接】instagram-private-apiNodeJS Instagram private API SDK. Written in TypeScript.项目地址https://gitcode.com/gh_mirrors/in/instagram-private-api点击查看免费下载本文聚焦 instagram-private-apiNodeJS 版 Instagram 私有 API SDKTypeScript 编写中音乐「情绪Mood」分类的数据结构契约MusicRepositoryMoodsResponseMood。通过本文读者可以掌握该接口的id、name、cover_artwork_uri三个字段的确切含义与类型约束理解它如何嵌入「情绪列表 → 单曲列表」的完整数据链路并学会结合MusicRepository.moods()与MusicMoodFeed在真实业务中拉取 Instagram 音乐情绪分类及其曲库。一、接口定位音乐情绪Mood在响应模型中的角色在 Instagram 的私密 API 中音乐被分为两类顶层分类体系情绪Mood与流派Genre。MusicRepositoryMoodsResponseMood正是情绪分类条目的数据结构它由仓库源码 src/responses/music.repository.moods.response.ts 定义并经由 docs/modules/responses.md 作为responses模块的一部分对外暴露。从源码结构看该接口并非孤立存在而是嵌套在如下三级响应结构中// 顶层响应moods() 接口的完整返回体 export interface MusicRepositoryMoodsResponseRootObject { items: MusicRepositoryMoodsResponseItemsItem[]; // 情绪条目列表 status: string; // 请求状态通常为 ok } // 中间层每个列表项 export interface MusicRepositoryMoodsResponseItemsItem { mood: MusicRepositoryMoodsResponseMood; // 真正的情绪实体 } // 目标接口情绪实体 export interface MusicRepositoryMoodsResponseMood { id: string; name: string; cover_artwork_uri: string; }也就是说调用/api/v1/music/moods/后每个items[]元素内部都通过mood键承载一个MusicRepositoryMoodsResponseMood实例。这一「RootObject → ItemsItem → 实体」的三级设计与仓库中 music.repository.genres.response.ts 的MusicRepositoryGenresResponseGenre结构完全对称可推断这是该 SDK 对所有音乐分类接口遵循的统一建模惯例。二、字段详解三个属性的类型与业务含义TypeDoc 生成的接口文档 MusicRepositoryMoodsResponseMood.md 明确声明了三个属性全部为必填的string类型属性类型业务含义源码行号idstring该情绪分类在 Instagram 音乐库中的唯一标识用于后续按情绪拉取曲目列表src/responses/music.repository.moods.response.ts:9namestring情绪的展示名称如 Chill、Happy 等分类名src/responses/music.repository.moods.response.ts:10cover_artwork_uristring该情绪分类封面的图片资源 URL可直接用于客户端封面展示src/responses/music.repository.moods.response.ts:11其中id字段是整个数据链路的关键——它不仅是情绪的标识更是后续 MusicMoodFeed 构造请求 URL 时直接拼接进/api/v1/music/moods/${id}/的参数见下文第三节。而cover_artwork_uri与单曲实体MusicMoodFeedResponseTrack.cover_artwork_uri字段同名印证了该字段在音乐模块中作为统一封面资源约定的地位。三、数据来源MusicRepository.moods() 的底层调用链MusicRepositoryMoodsResponseMood的实例由MusicRepository.moods()返回。仓库源码 src/repositories/music.repository.ts 给出了该方法的完整实现public async moods(product?: IgAppModule): PromiseMusicRepositoryMoodsResponseRootObject { product product || story_camera_music_overlay_post_capture; const { body } await this.client.request.sendMusicRepositoryMoodsResponseRootObject({ url: /api/v1/music/moods/, method: POST, form: { _csrftoken: this.client.state.cookieCsrfToken, product, _uuid: this.client.state.uuid, browse_session_id: this.client.state.clientSessionId, }, }); return body; }关键实现细节HTTP 端点与方式POST /api/v1/music/moods/注意这里虽然是查询语义却使用 POST 并以form表单提交这是 Instagram 私有 API 的通行做法默认product参数不传时默认使用story_camera_music_overlay_post_capture即故事相机拍后阶段音乐贴纸场景。IgAppModule联合类型定义在 src/types/common.types.ts包含feed_timeline、story_camera_music_overlay_pre_capture、igtv_feed_timeline等大量取值可据此推测不同product会返回不同场景适配的情绪列表会话参数自动注入_csrftoken、_uuid、browse_session_id均取自client.state开发者无需手动维护SDK 已封装完成。四、实战用法从情绪 id 到曲库的完整数据链路拿到MusicRepositoryMoodsResponseMood后最常见的业务场景是「按情绪浏览曲目」。这需要把id交给MusicMoodFeed。SDK 通过 src/core/feed.factory.ts 的工厂方法musicMood()完成组装public musicMood( id: number | string, product: IgAppModule story_camera_music_overlay_post_capture, ): MusicMoodFeed { return plainToClassFromExist(new MusicMoodFeed(this.client), { id, product, }); }配合使用示例基于 MusicMoodFeed 的公开方法import { IgApiClient } from instagram-private-api; const ig new IgApiClient(); // ...完成登录后 // 1. 拉取全部情绪分类 const { items } await ig.music.moods(); // 2. 取第一个情绪读取其三个字段 const firstMood items[0].mood; console.log(firstMood.id); // 情绪唯一标识 console.log(firstMood.name); // 情绪展示名 console.log(firstMood.cover_artwork_uri); // 封面图 URL // 3. 用 id 进入该情绪下的曲库逐页读取 const moodFeed ig.feed.musicMood(firstMood.id); const tracks await moodFeed.items(); // MusicMoodFeedResponseItemsItem[]分页行为由 src/feeds/music-mood.feed.ts 的statesetter 驱动每页返回后从page_info.next_max_id更新nextCursor并以page_info.more_available决定isMoreAvailable()可配合observable()或items$持续翻页拉取全部曲目。五、曲目实体对照Mood 与单曲的字段呼应该情绪分类下的每一首曲目由 music-mood.feed.response.ts 中的MusicMoodFeedResponseTrack表示其字段设计与MusicRepositoryMoodsResponseMood形成清晰对照情绪实体字段对应曲目字段说明idid各自体系内的唯一标识nametitle/display_artist情绪为展示名曲目拆分为标题与歌手cover_artwork_uricover_artwork_uri另有cover_artwork_thumbnail_uri缩略图封面资源 URL 约定一脉相承曲目实体还额外携带progressive_download_url、dash_manifest、is_explicit、has_lyrics、highlight_start_times_in_ms等字段。由此可以推断MusicRepositoryMoodsResponseMood刻意保持极简——仅保留支撑「分类浏览」所需的最小字段集将丰富的音乐元数据下放到曲目层级这也是该接口仅有三字段的建模意图。六、关联 API 一览完整掌握音乐分类能力围绕MusicRepositoryMoodsResponseMood仓库中还提供了同族的音乐分类能力均定义于 music.repository.tsAPI端点说明对应响应类型ig.music.moods()POST /api/v1/music/moods/获取情绪分类列表MusicRepositoryMoodsResponseRootObjectig.music.genres()POST /api/v1/music/genres/获取流派分类列表MusicRepositoryGenresResponseRootObjectig.music.lyrics(trackId)GET /api/v1/music/track/${trackId}/lyrics/获取指定曲目的歌词MusicRepositoryLyricsResponseRootObjectig.feed.musicMood(id)POST /api/v1/music/moods/${id}/按情绪分页拉取曲目MusicMoodFeedResponseRootObjectig.feed.musicSearch(...)POST /api/v1/music/search/搜索音乐MusicSearchFeedResponseRootObjectig.feed.musicTrending(...)POST /api/v1/music/trending/热门音乐MusicTrendingFeedResponseRootObject其中MusicMoodFeed、MusicSearchFeed、MusicTrendingFeed都统一继承了 src/core/feed.ts 基类共享attemptOptions重试配置、observable()可观察流、serialize()/deserialize()序列化能力因此在设计音乐浏览功能时可以复用同一套分页与重试模式。七、小结MusicRepositoryMoodsResponseMood是 instagram-private-api 音乐模块中情绪分类的最小数据单元id驱动下游曲库请求name用于 UI 展示cover_artwork_uri提供封面资源。它的完整生命周期贯穿「MusicRepository.moods()拉取列表 →feed.musicMood(id)进入曲库 →MusicMoodFeed分页读取曲目」三个阶段理解这一接口即可串联起 Instagram 音乐情绪分类的整套玩法。若需进一步深挖可直接研读 src/repositories/music.repository.ts、src/feeds/music-mood.feed.ts 与 src/responses/music.repository.moods.response.ts 三处源码。赞分享后端【免费下载链接】instagram-private-apiNodeJS Instagram private API SDK. Written in TypeScript.项目地址https://gitcode.com/gh_mirrors/in/instagram-private-api点击查看免费下载相关推荐instagram-private-api 数据响应结构详解StorySliderVotersFeedResponseResponseRootObject 接口深度解析instagram private api 数据响应结构详解StorySliderVotersFeedResponseResponseRootObject 接后端instagram-private-api 账号数据洞察Insights接口详解InsightsServiceAccountResponseFollow_status 结构解析instagram private api 账号数据洞察Insights接口详解InsightsServiceAccountResponseFollow_后端instagram-private-api 响应结构解析DirectRepositoryCreateGroupThreadResponseInviter 接口详解instagram private api 响应结构解析DirectRepositoryCreateGroupThreadResponseInviter 接口后端上一篇惠普OMEN游戏本性能解锁神器OmenSuperHub完全使用手册下一篇OmenSuperHub终极指南解锁惠普暗影精灵游戏本性能的完整教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/16 1:31:16 · 阅读 1.2k instagram-private-api 音乐模块核心数据结构解析：MusicRepositoryMoodsResponseMood 接口详解
后端【免费下载链接】instagram-private-apiNodeJS Instagram private API SDK. Written in TypeScript.项目地址https://gitcode.com/gh_mirrors/in/instagram-private-api点击查看免费下载本文聚焦 instagram-private-apiNodeJS 版 Instagram 私有 API SDKTypeScript 编写中音乐「情绪Mood」分类的数据结构契约MusicRepositoryMoodsResponseMood。通过本文读者可以掌握该接口的id、name、cover_artwork_uri三个字段的确切含义与类型约束理解它如何嵌入「情绪列表 → 单曲列表」的完整数据链路并学会结合MusicRepository.moods()与MusicMoodFeed在真实业务中拉取 Instagram 音乐情绪分类及其曲库。一、接口定位音乐情绪Mood在响应模型中的角色在 Instagram 的私密 API 中音乐被分为两类顶层分类体系情绪Mood与流派Genre。MusicRepositoryMoodsResponseMood正是情绪分类条目的数据结构它由仓库源码 src/responses/music.repository.moods.response.ts 定义并经由 docs/modules/responses.md 作为responses模块的一部分对外暴露。从源码结构看该接口并非孤立存在而是嵌套在如下三级响应结构中// 顶层响应moods() 接口的完整返回体 export interface MusicRepositoryMoodsResponseRootObject { items: MusicRepositoryMoodsResponseItemsItem[]; // 情绪条目列表 status: string; // 请求状态通常为 ok } // 中间层每个列表项 export interface MusicRepositoryMoodsResponseItemsItem { mood: MusicRepositoryMoodsResponseMood; // 真正的情绪实体 } // 目标接口情绪实体 export interface MusicRepositoryMoodsResponseMood { id: string; name: string; cover_artwork_uri: string; }也就是说调用/api/v1/music/moods/后每个items[]元素内部都通过mood键承载一个MusicRepositoryMoodsResponseMood实例。这一「RootObject → ItemsItem → 实体」的三级设计与仓库中 music.repository.genres.response.ts 的MusicRepositoryGenresResponseGenre结构完全对称可推断这是该 SDK 对所有音乐分类接口遵循的统一建模惯例。二、字段详解三个属性的类型与业务含义TypeDoc 生成的接口文档 MusicRepositoryMoodsResponseMood.md 明确声明了三个属性全部为必填的string类型属性类型业务含义源码行号idstring该情绪分类在 Instagram 音乐库中的唯一标识用于后续按情绪拉取曲目列表src/responses/music.repository.moods.response.ts:9namestring情绪的展示名称如 Chill、Happy 等分类名src/responses/music.repository.moods.response.ts:10cover_artwork_uristring该情绪分类封面的图片资源 URL可直接用于客户端封面展示src/responses/music.repository.moods.response.ts:11其中id字段是整个数据链路的关键——它不仅是情绪的标识更是后续 MusicMoodFeed 构造请求 URL 时直接拼接进/api/v1/music/moods/${id}/的参数见下文第三节。而cover_artwork_uri与单曲实体MusicMoodFeedResponseTrack.cover_artwork_uri字段同名印证了该字段在音乐模块中作为统一封面资源约定的地位。三、数据来源MusicRepository.moods() 的底层调用链MusicRepositoryMoodsResponseMood的实例由MusicRepository.moods()返回。仓库源码 src/repositories/music.repository.ts 给出了该方法的完整实现public async moods(product?: IgAppModule): PromiseMusicRepositoryMoodsResponseRootObject { product product || story_camera_music_overlay_post_capture; const { body } await this.client.request.sendMusicRepositoryMoodsResponseRootObject({ url: /api/v1/music/moods/, method: POST, form: { _csrftoken: this.client.state.cookieCsrfToken, product, _uuid: this.client.state.uuid, browse_session_id: this.client.state.clientSessionId, }, }); return body; }关键实现细节HTTP 端点与方式POST /api/v1/music/moods/注意这里虽然是查询语义却使用 POST 并以form表单提交这是 Instagram 私有 API 的通行做法默认product参数不传时默认使用story_camera_music_overlay_post_capture即故事相机拍后阶段音乐贴纸场景。IgAppModule联合类型定义在 src/types/common.types.ts包含feed_timeline、story_camera_music_overlay_pre_capture、igtv_feed_timeline等大量取值可据此推测不同product会返回不同场景适配的情绪列表会话参数自动注入_csrftoken、_uuid、browse_session_id均取自client.state开发者无需手动维护SDK 已封装完成。四、实战用法从情绪 id 到曲库的完整数据链路拿到MusicRepositoryMoodsResponseMood后最常见的业务场景是「按情绪浏览曲目」。这需要把id交给MusicMoodFeed。SDK 通过 src/core/feed.factory.ts 的工厂方法musicMood()完成组装public musicMood( id: number | string, product: IgAppModule story_camera_music_overlay_post_capture, ): MusicMoodFeed { return plainToClassFromExist(new MusicMoodFeed(this.client), { id, product, }); }配合使用示例基于 MusicMoodFeed 的公开方法import { IgApiClient } from instagram-private-api; const ig new IgApiClient(); // ...完成登录后 // 1. 拉取全部情绪分类 const { items } await ig.music.moods(); // 2. 取第一个情绪读取其三个字段 const firstMood items[0].mood; console.log(firstMood.id); // 情绪唯一标识 console.log(firstMood.name); // 情绪展示名 console.log(firstMood.cover_artwork_uri); // 封面图 URL // 3. 用 id 进入该情绪下的曲库逐页读取 const moodFeed ig.feed.musicMood(firstMood.id); const tracks await moodFeed.items(); // MusicMoodFeedResponseItemsItem[]分页行为由 src/feeds/music-mood.feed.ts 的statesetter 驱动每页返回后从page_info.next_max_id更新nextCursor并以page_info.more_available决定isMoreAvailable()可配合observable()或items$持续翻页拉取全部曲目。五、曲目实体对照Mood 与单曲的字段呼应该情绪分类下的每一首曲目由 music-mood.feed.response.ts 中的MusicMoodFeedResponseTrack表示其字段设计与MusicRepositoryMoodsResponseMood形成清晰对照情绪实体字段对应曲目字段说明idid各自体系内的唯一标识nametitle/display_artist情绪为展示名曲目拆分为标题与歌手cover_artwork_uricover_artwork_uri另有cover_artwork_thumbnail_uri缩略图封面资源 URL 约定一脉相承曲目实体还额外携带progressive_download_url、dash_manifest、is_explicit、has_lyrics、highlight_start_times_in_ms等字段。由此可以推断MusicRepositoryMoodsResponseMood刻意保持极简——仅保留支撑「分类浏览」所需的最小字段集将丰富的音乐元数据下放到曲目层级这也是该接口仅有三字段的建模意图。六、关联 API 一览完整掌握音乐分类能力围绕MusicRepositoryMoodsResponseMood仓库中还提供了同族的音乐分类能力均定义于 music.repository.tsAPI端点说明对应响应类型ig.music.moods()POST /api/v1/music/moods/获取情绪分类列表MusicRepositoryMoodsResponseRootObjectig.music.genres()POST /api/v1/music/genres/获取流派分类列表MusicRepositoryGenresResponseRootObjectig.music.lyrics(trackId)GET /api/v1/music/track/${trackId}/lyrics/获取指定曲目的歌词MusicRepositoryLyricsResponseRootObjectig.feed.musicMood(id)POST /api/v1/music/moods/${id}/按情绪分页拉取曲目MusicMoodFeedResponseRootObjectig.feed.musicSearch(...)POST /api/v1/music/search/搜索音乐MusicSearchFeedResponseRootObjectig.feed.musicTrending(...)POST /api/v1/music/trending/热门音乐MusicTrendingFeedResponseRootObject其中MusicMoodFeed、MusicSearchFeed、MusicTrendingFeed都统一继承了 src/core/feed.ts 基类共享attemptOptions重试配置、observable()可观察流、serialize()/deserialize()序列化能力因此在设计音乐浏览功能时可以复用同一套分页与重试模式。七、小结MusicRepositoryMoodsResponseMood是 instagram-private-api 音乐模块中情绪分类的最小数据单元id驱动下游曲库请求name用于 UI 展示cover_artwork_uri提供封面资源。它的完整生命周期贯穿「MusicRepository.moods()拉取列表 →feed.musicMood(id)进入曲库 →MusicMoodFeed分页读取曲目」三个阶段理解这一接口即可串联起 Instagram 音乐情绪分类的整套玩法。若需进一步深挖可直接研读 src/repositories/music.repository.ts、src/feeds/music-mood.feed.ts 与 src/responses/music.repository.moods.response.ts 三处源码。赞分享后端【免费下载链接】instagram-private-apiNodeJS Instagram private API SDK. Written in TypeScript.项目地址https://gitcode.com/gh_mirrors/in/instagram-private-api点击查看免费下载相关推荐instagram-private-api 数据响应结构详解StorySliderVotersFeedResponseResponseRootObject 接口深度解析instagram private api 数据响应结构详解StorySliderVotersFeedResponseResponseRootObject 接后端instagram-private-api 账号数据洞察Insights接口详解InsightsServiceAccountResponseFollow_status 结构解析instagram private api 账号数据洞察Insights接口详解InsightsServiceAccountResponseFollow_后端instagram-private-api 响应结构解析DirectRepositoryCreateGroupThreadResponseInviter 接口详解instagram private api 响应结构解析DirectRepositoryCreateGroupThreadResponseInviter 接口后端上一篇惠普OMEN游戏本性能解锁神器OmenSuperHub完全使用手册下一篇OmenSuperHub终极指南解锁惠普暗影精灵游戏本性能的完整教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考