• 后端

本文围绕 instagram-private-api（TypeScript 编写的 NodeJS Instagram 私有 API SDK）中的MediaInlineChildCommentsFeedResponseChildCommentsItem接口展开，系统讲解评论“楼中楼”（inline child comments）数据的字段语义、与之配套的父评论与用户类型，以及底层 Feed 分页拉取机制。读完本文，你将能够准确解析该 SDK 返回的子评论数据结构，并能在自己的脚本中利用ig.feed.mediaInlineChildComments()完整地遍历某条评论的全部回复。

一、接口定位：Instagram 评论楼中楼数据模型

在 Instagram 的评论体系中，一条帖子的评论区既包含顶层评论，也允许用户在顶层评论下继续“回复”，形成两级评论树。MediaInlineChildCommentsFeedResponseChildCommentsItem正是 instagram-private-api 为描述**顶层评论的子评论（回复）**而定义的核心响应接口之一。

它声明于响应类型文件 src/responses/media.inline-child-comments.feed.response.ts，并通过 src/responses/index.ts 的export *从包入口统一导出，可被业务代码直接 import 使用。从源码结构看，它与其他三个接口共同组成完整的“子评论”响应体系：

对应到 TypeDoc 文档模块中，可依次查看 RootObject 文档、Parent_comment 文档、ChildCommentsItem 文档 与 User 文档。

二、属性全解析：15 个字段的语义与类型

原文档完整列出了MediaInlineChildCommentsFeedResponseChildCommentsItem的 15 个属性。下面按“身份标识 → 内容 → 时间 → 状态 → 互动数据 → 嵌套用户”分组逐一说明。

2.1 身份标识字段

• pk：string。子评论的唯一主键（primary key），对应 Instagram 内部的评论 ID。注意它被定义为字符串，用于在parent_comment_id、评论点赞等后续请求中回传标识。定义见 media.inline-child-comments.feed.response.ts:37。
• user_id：number。评论发布者的用户 ID，是数字类型，与user.pk语义相同、格式不同，两者可配合用于跨接口关联（如拼接用户主页请求）。定义见 media.inline-child-comments.feed.response.ts:38。
• parent_comment_id：string。该字段是“子评论”语义的关键，指明本条回复隶属于哪一条顶层评论；它应该与响应根对象中的parent_comment.pk一致，可用于在客户端本地构建评论树、按父评论聚合回复。定义见 media.inline-child-comments.feed.response.ts:49。

2.2 内容与类型字段

• text：string。子评论的正文文本。定义见 media.inline-child-comments.feed.response.ts:39。
• type：number。评论的类型码。评论体系中的类型常量通常为固定数值（如常规评论与特定系统评论对应不同取值），SDK 原样透传该数值，未做枚举映射。定义见 media.inline-child-comments.feed.response.ts:40。
• content_type：string。内容类型标识，例如comment。定义见 media.inline-child-comments.feed.response.ts:43。

2.3 时间字段

• created_at：number。评论创建时间的 Unix 时间戳（秒级，本地展示可用）。定义见 media.inline-child-comments.feed.response.ts:41。
• created_at_utc：number。评论创建时间的UTC Unix 时间戳（秒级）。实践中通常优先使用created_at_utc换算为标准时间，避免时区歧义。定义见 media.inline-child-comments.feed.response.ts:42。

2.4 状态与标志字段

• status：string。评论的当前状态，正常情况多为Active之类的字符串；已被删除或违规的评论会携带其他状态值。定义见 media.inline-child-comments.feed.response.ts:44。
• bit_flags：number。评论的位标志（bit flags）整数值，用于编码一组布尔状态，Instagram 客户端通过位掩码解析，SDK 原样透传。定义见 media.inline-child-comments.feed.response.ts:45。
• did_report_as_spam：boolean。当前登录账号是否已将该评论举报为垃圾内容，为true时可用于前端界面高亮“已举报”状态。定义见 media.inline-child-comments.feed.response.ts:47。
• share_enabled：boolean。该评论是否允许被分享（转发为故事等）。定义见 media.inline-child-comments.feed.response.ts:48。

2.5 互动数据字段

• has_liked_comment：boolean。当前登录账号是否已赞过该子评论，可用于渲染点赞按钮的选中态。定义见 media.inline-child-comments.feed.response.ts:50。
• comment_like_count：number。该子评论累计收到的点赞数。定义见 media.inline-child-comments.feed.response.ts:51。

2.6 嵌套用户字段

• user：MediaInlineChildCommentsFeedResponseUser。发布者的完整用户信息对象。该内嵌接口包含 7 个字段，具体见 MediaInlineChildCommentsFeedResponseUser 文档 及源码 media.inline-child-comments.feed.response.ts:27-35：

2.7 字段类型速查表

interface MediaInlineChildCommentsFeedResponseChildCommentsItem { pk: string; // 子评论 ID user_id: number; // 发布者用户 ID text: string; // 评论文本 type: number; // 评论类型码 created_at: number; // 创建时间（秒级时间戳） created_at_utc: number; // UTC 创建时间（秒级时间戳） content_type: string; // 内容类型标识 status: string; // 评论状态 bit_flags: number; // 位标志 user: MediaInlineChildCommentsFeedResponseUser; // 发布者信息 did_report_as_spam: boolean; // 是否已举报 share_enabled: boolean; // 是否可分享 parent_comment_id: string; // 所属父评论 ID has_liked_comment: boolean; // 当前账号是否已点赞 comment_like_count: number; // 点赞总数 }

三、父评论与根对象：子评论的上下文

子评论不是孤立数据，它总是依附于某条顶层评论。接口MediaInlineChildCommentsFeedResponseRootObject提供了请求一次“内联子评论”端点后返回的完整上下文，其字段见 RootObject 文档：

• parent_comment：MediaInlineChildCommentsFeedResponseParent_comment。被回复的父评论完整对象。
• child_comments：MediaInlineChildCommentsFeedResponseChildCommentsItem[]。当前页返回的子评论数组，即items()的数据来源。
• child_comment_count：number。该父评论下的子评论总数。
• has_more_tail_child_comments/has_more_head_child_comments：boolean。指示尾部/头部是否还有更多子评论，是分页判断的依据之一。
• next_max_child_cursor：string。下一页的游标（cursor），Feed 用它驱动继续翻页。
• num_tail_child_comments：number。尾部剩余子评论数量。
• status：string。响应状态。

而MediaInlineChildCommentsFeedResponseParent_comment（见 Parent_comment 文档）与子评论拥有几乎完全一致的字段集合（pk、user_id、text、type、时间戳、bit_flags、user、举报/分享/点赞等），唯一区别是父评论没有parent_comment_id——因为父评论本身就是回复树的根节点。

从字段结构上可以推断：Instagram 将“顶层评论”与“子评论”建模为同构对象，仅通过是否携带parent_comment_id来区分层级，这解释了为什么两者在 SDK 中各自声明了一套几乎重复的接口。

四、底层实现：Feed 如何分页拉取子评论

子评论接口由MediaInlineChildCommentsFeed负责拉取，实现在 src/feeds/media.inline-child-comments.feed.ts。它是抽象基类Feed<Response, Item>（见 src/core/feed.ts）的子类，核心机制如下：

4.1 请求端点与参数

public async request(): Promise<MediaInlineChildCommentsFeedResponseRootObject> { const { body } = await this.client.request.send({ url: `/api/v1/media/${this.mediaId}/comments/${this.commentId}/inline_child_comments/`, qs: { min_id: this.nextMinId, max_id: this.nextMaxId, }, }); this.state = body; return body; }

关键点：

• 端点路径为/api/v1/media/{mediaId}/comments/{commentId}/inline_child_comments/，需要同时提供帖子媒体 ID（mediaId）与顶层评论 ID（commentId）；
• 查询参数min_id/max_id是双向分页游标：max_id从响应根对象的next_max_child_cursor获得，用于向后翻页；min_id用于向前翻页（首次调用时由mediaInlineChildComments(mediaId, commentId, minId?)的第三个可选参数注入）；
• 网络层通过this.client.request.send()发送，请求构造见 src/core/request.ts，其响应解析使用json-bigint将超长数字转为字符串（见 request.ts），这也是pk、parent_comment_id被声明为string的底层原因——Instagram 的评论 ID 常常超过 JavaScriptNumber.MAX_SAFE_INTEGER。

4.2 分页状态机

Feed 基类通过moreAvailable标志驱动循环翻页：

set state(state: MediaInlineChildCommentsFeedResponseRootObject) { this.moreAvailable = !!state.next_max_child_cursor; this.nextMaxId = state.next_max_child_cursor; this.nextMinId = undefined; }

每次request()都会把响应写回state，更新moreAvailable与游标；基类isMoreAvailable()（feed.ts）据此决定是否继续请求下一页。items()则直接返回req.child_comments，即本接口所对应的对象数组：

public async items(): Promise<MediaInlineChildCommentsFeedResponseChildCommentsItem[]> { const req = await this.request(); return req.child_comments; }

4.3 与媒体评论 Feed 的分工

注意区分MediaInlineChildCommentsFeed与 src/feeds/media-comments.feed.ts 中的MediaCommentsFeed：

• MediaCommentsFeed拉取顶层评论列表（端点/api/v1/media/{id}/comments/，携带can_support_threading: true），其响应条目MediaCommentsFeedResponseCommentsItem中会附带child_comment_count、preview_child_comments、has_more_tail_child_comments、next_min_child_cursor等字段（见 src/responses/media-comments.feed.response.ts），用于提示“该评论下有多少回复”；
• 当需要真正展开某条评论的全部回复时，再调用MediaInlineChildCommentsFeed按commentId精确拉取。

两者构成“先取列表、再按需展开”的两级评论消费链路。

五、实战用法：遍历某条评论的全部子评论

MediaInlineChildCommentsFeed通过 FeedFactory.mediaInlineChildComments() 暴露给上层，方法签名为mediaInlineChildComments(mediaId: string, commentId: string, minId?: string)。完整调用链为：IgApiClient.feed.mediaInlineChildComments(...)。

结合 examples/session.example.ts 展示的会话初始化方式，一个典型的子评论遍历脚本如下：

import { IgApiClient } from 'instagram-private-api'; (async () => { const ig = new IgApiClient(); ig.state.generateDevice(process.env.IG_USERNAME); // 生产环境建议按 session.example.ts 的方式持久化并恢复会话状态 await ig.account.login(process.env.IG_USERNAME, process.env.IG_PASSWORD); const mediaId = '1234567890123456789'; // 目标帖子的 media ID const commentId = '17845678901234567'; // 目标顶层评论的 pk（string） // ① 手动分页：逐页取 child_comments const feed = ig.feed.mediaInlineChildComments(mediaId, commentId); do { const page: MediaInlineChildCommentsFeedResponseChildCommentsItem[] = await feed.items(); for (const child of page) { console.log( `[${child.user.username}] ${child.text} (likes: ${child.comment_like_count}, parent: ${child.parent_comment_id})`, ); } } while (feed.isMoreAvailable()); // ② 或使用基类提供的 RxJS 流式迭代（自动处理 400/429/500/502 限流重试） const feed2 = ig.feed.mediaInlineChildComments(mediaId, commentId); feed2.items$.subscribe({ next: (items) => console.log(`page with ${items.length} child comments`), error: (err) => console.error('fetch failed', err), }); })().catch(console.error);

关于上述代码的几点说明：

• feed.items()每调用一次即发起一次网络请求并推进分页游标；feed.isMoreAvailable()在游标耗尽后返回false。
• 基类的items$属性（feed.ts）返回 RxJS Observable，内部对400 / 429 / 500 / 502等 Instagram 限流/临时错误按指数退避自动重试，默认maxAttempts: 10、初始延迟 60 秒（见 feed.ts），适合长时间大规模抓取场景。
• 每一条child均为MediaInlineChildCommentsFeedResponseChildCommentsItem实例，可放心访问上文列出的 15 个字段。

六、使用提示与限制

• ID 一律按字符串处理：由于请求层使用json-bigint把超长数字序列化为字符串，pk、user_id、parent_comment_id等字段在 TypeScript 类型中分别声明为string/number，读取与回传时应遵循接口声明的类型，避免精度丢失。
• 分页游标驱动：判断“是否还有下一页”应依赖根对象的next_max_child_cursor（经 Feed 内部转化为moreAvailable），而非仅靠child_comments数组长度判断。
• 字段可能缺省：user.profile_pic_id声明为可选字段（profile_pic_id?: string），实际响应中可能缺失；同时MediaCommentsFeedResponseCommentsItem中的has_more_tail_child_comments、next_min_child_cursor、num_head_child_comments等字段同样标记为可选，访问时建议做防御性判断。
• 请求频率：Instagram 对评论类端点有严格的频率限制，批量遍历时务必利用items$自带的重试与退避策略，或自行控制调用节奏，否则容易触发IgResponseError（400/429）。

结语

MediaInlineChildCommentsFeedResponseChildCommentsItem是 instagram-private-api 描述评论楼中楼回复的标准数据单元。通过本文的字段逐项解读与 Feed 实现 源码级分析，你现在可以准确解析子评论的全部 15 个字段，理解它与 父评论、根对象、用户 三类接口的关系，并借助ig.feed.mediaInlineChildComments()完成从单页拉取到全量分页遍历的完整流程。相关类型声明与 Feed 定义均可从 responses 模块文档 与 feeds 模块文档 继续深入查阅。

• 后端