后端【免费下载链接】instagram-private-apiNodeJS Instagram private API SDK. Written in TypeScript.项目地址https://gitcode.com/gh_mirrors/in/instagram-private-api点击查看免费下载本文聚焦 instagram-private-apiNodeJS Instagram private API SDKTypeScript 编写中帖子洞察响应模型的关键一环——PostsInsightsFeedResponseActions接口。该接口承载每篇帖子的「个人主页行为」Profile Actions指标是分析帖子带来的主页访问、关注、私信、电话、跳转链接等转化行为的入口。读完本文你将掌握该接口的结构、它在完整洞察响应树中的位置、底层 GraphQL 请求的调用链以及如何通过PostsInsightsFeed在实战中消费这些数据。一、接口定义一个属性一份职责PostsInsightsFeedResponseActions在 docs/interfaces/responses/PostsInsightsFeedResponseActions.md 中被定义为响应命名空间responses.PostsInsightsFeedResponseActions下的一个接口它只声明了一个属性属性类型说明edgesPostsInsightsFeedResponseEdgesItem[]行为明细的边列表每个元素代表一条独立的 Profile Action 记录对应的 TypeScript 源码位于 src/responses/posts-insights.feed.response.tsexport interface PostsInsightsFeedResponseActions { edges: PostsInsightsFeedResponseEdgesItem[]; }edges是 instagram-private-api 响应模型中 GraphQL 分页结构的惯用表示每条edge由node与可选的cursor组成。具体而言每个元素是PostsInsightsFeedResponseEdgesItemexport interface PostsInsightsFeedResponseEdgesItem { node: PostsInsightsFeedResponseNode; cursor?: string; }在帖子洞察场景下node内的name与value两个可选字段见 src/responses/posts-insights.feed.response.ts正是某类主页行为的名称与发生次数。二、它在洞察响应树中的位置PostsInsightsFeedResponseActions不是孤立存在而是嵌套在帖子洞察根响应PostsInsightsFeedResponseRootObject深处的叶子节点之一。从 src/responses/posts-insights.feed.response.ts 的完整类型链可以还原出如下层级PostsInsightsFeedResponseRootObject └── data: PostsInsightsFeedResponseData └── user: PostsInsightsFeedResponseUser └── business_manager: PostsInsightsFeedResponseBusiness_manager └── top_posts_unit: PostsInsightsFeedResponseTop_posts_unit └── top_posts: PostsInsightsFeedResponseTop_posts ├── edges: PostsInsightsFeedResponseEdgesItem[] // 帖子列表 └── page_info: PostsInsightsFeedResponsePage_info // 游标分页 └── node: PostsInsightsFeedResponseNode └── inline_insights_node: PostsInsightsFeedResponseInline_insights_node └── metrics: PostsInsightsFeedResponseMetrics └── profile_actions: PostsInsightsFeedResponseProfile_actions └── actions: PostsInsightsFeedResponseActions // 本文主角 └── edges: PostsInsightsFeedResponseEdgesItem[]即每篇帖子top_posts.edges[].node通过其inline_insights_node.metrics.profile_actions.actions指向一个PostsInsightsFeedResponseActions其中edges的每一条记录该帖带来的某类主页行为次数。相邻类型文档可相互印证PostsInsightsFeedResponseProfile_actions声明actions: PostsInsightsFeedResponseActionsPostsInsightsFeedResponseMetrics在impression_count曝光、reach_count触达、owner_profile_views_count主页浏览、owner_account_follows_count关注等核心指标旁将profile_actions作为独立指标成员PostsInsightsFeedResponseNode同时给出instagram_media_id、instagram_media_type、like_count、comment_count、save_count等帖子级基础数据方便与profile_actions交叉分析。三、Profile Actions 的业务含义与可选取值PostsInsightsFeedResponseActions.edges中每个node的name/value对应哪一类主页行为可以在帖子洞察的可选参数中找到完整枚举。在 src/types/insights.options.ts 中PostsInsightsFeedOptions.dataOrdering定义了数据排序维度其取值即 Instagram 洞察中可统计的主页行为类型枚举值含义推断CALL点击「拨打电话」EMAIL点击「发送邮件」FOLLOW点击「关注」GET_DIRECTIONS点击「获取路线」PROFILE_VIEW访问主页TEXT点击「发短信」BIO_LINK_CLICK点击主页简介链接当调用方以某一取值作为dataOrdering时对应行为的聚合值会出现在帖子级inline_insights_node.metrics中而PostsInsightsFeedResponseActions则以edges数组的形式把「该帖触发了哪些主页行为、各多少次」逐条列出。它反映的是帖子内容对主页流量的转化带动是评估「帖子 → 主页 → 转化」链路的关键证据。四、底层调用链ads GraphQL 与 PostsInsightsFeedPostsInsightsFeedResponseActions的数据由 src/feeds/posts-insights.feed.ts 驱动的 GraphQL 请求产生。PostsInsightsFeed.request()的核心实现如下async request(): PromisePostsInsightsFeedResponseRootObject { const body await this.client.ads.graphQLPostsInsightsFeedResponseRootObject({ surface: { friendlyName: IgInsightsPostGridSurfaceQuery }, documentId: 1981884911894608, variables: { count: 15, cursor: this.nextCursor, IgInsightsGridMediaImage_SIZE: 256, queryParams: { access_token: , id: this.client.state.cookieUserId, }, ...this.options, }, }); this.state body; return body; }值得注意的实现细节请求端点与承载仓库请求通过this.client.ads.graphQL()发出最终落到 src/repositories/ads.repository.ts 的AdsRepository.graphQLT()向/api/v1/ads/graphql/发送 POST 表单携带doc_idGraphQL 文档 ID、fb_api_req_friendly_name即IgInsightsPostGridSurfaceQuery、variablesJSON 序列化后的查询变量以及vc_policy: insights_policy。从「ads」端点与business_manager字段命名可以推断该数据面向具备商业账号管理能力的账户。分页状态机Expose() nextCursor保存游标set state()从top_posts.page_info取出end_cursor与has_next_page来驱动 src/core/feed.ts 基类的isMoreAvailable()循环实现多页拉取。结果提取items()直接返回body.data.user.business_manager.top_posts_unit.top_posts.edges即帖子列表每篇帖子的inline_insights_node.metrics.profile_actions.actionsPostsInsightsFeedResponseActions随 node 一并返回。五、实战如何消费 Profile Actions 数据结合 src/core/feed.factory.ts 中feed.postsInsightsFeed(options)的工厂方法一个典型的消费流程如下import { IgApiClient } from instagram-private-api; const ig new IgApiClient(); // 登录并设置会话此处省略具体登录代码 await ig.state.generateDevice(username); await ig.account.login(username, password); // 1. 创建帖子洞察 Feed需传入 timeframe / dataOrdering / postType const feed ig.feed.postsInsightsFeed({ timeframe: ONE_MONTH, dataOrdering: PROFILE_VIEW, postType: ALL, }); // 2. 拉取首批帖子及洞察数据 const items await feed.items(); // 3. 读取每篇帖子的 Profile Actions for (const item of items) { const node item.node; const actions node.inline_insights_node?.metrics?.profile_actions?.actions; console.log(帖子 ${node.instagram_media_id}类型 ${node.instagram_media_type}的 Profile Actions); for (const edge of actions?.edges ?? []) { console.log( - ${edge.node.name}: ${edge.node.value}); } } // 4. 若仍有下一页继续迭代 while (feed.isMoreAvailable()) { const next await feed.items(); // 处理 next ... }PostsInsightsFeedOptions的完整取值定义在 src/types/insights.options.tstimeframeONE_WEEK | ONE_MONTH | THREE_MONTHS | SIX_MONTHS | ONE_YEAR | TWO_YEARS洞察统计时间窗dataOrdering上文列出的主页行为枚举决定排序维度postTypeALL | IMAGE | VIDEO | CAROUSEL_V2 | SHOPPING按内容形态筛选。每条edge的node中还包含image.uri封面、creation_time发布时间、comment_count/like_count/save_count等字段可用于把 Profile Actions 与帖子基础表现做联合分析。六、进阶处理分页与响应序列化PostsInsightsFeed继承自 src/core/feed.ts 的抽象FeedResponse, Item基类因此在消费时可直接使用基类能力items$/observable()以 RxJS Observable 形式流式产出各页 items内置对400/429/500/502状态码的退避重试attemptOptions默认delay: 60000、maxAttempts: 10、jitter: true适合需要长时拉取全部数据的场景serialize()/deserialize()Feed 对象可通过class-transformer序列化为字符串再在后续进程反序列化恢复从而复用分页游标无需重新发起首页请求isMoreAvailable()配合has_next_page判断是否还有后续数据。借助这些机制PostsInsightsFeedResponseActions所代表的 Profile Actions 数据既可以被逐页实时消费也可以被打断后续传、跨进程复用分页状态从而构建完整的帖子洞察采集与分析管线。七、小结PostsInsightsFeedResponseActions是帖子洞察响应中「主页行为」指标的类型载体唯一属性edges逐条列出行为名称与次数它在类型链中位于rootObject.data.user.business_manager.top_posts_unit.top_posts.edges[].node.inline_insights_node.metrics.profile_actions.actions与Metrics中的曝光、触达、主页浏览等指标同层互补数据由PostsInsightsFeed通过ads.graphQL发送IgInsightsPostGridSurfaceQuerydocumentId1981884911894608获取响应模型定义于 src/responses/posts-insights.feed.response.ts类型链各节点均有对应文档见 docs/interfaces/responses/PostsInsightsFeedResponseActions.md 及其同级文件。对开发者而言把握住这一个接口的形态与位置就掌握了整个帖子洞察响应树中最细粒度转化数据的读取入口。赞分享后端【免费下载链接】instagram-private-apiNodeJS Instagram private API SDK. Written in TypeScript.项目地址https://gitcode.com/gh_mirrors/in/instagram-private-api点击查看免费下载相关推荐instagram-private-api 帖子数据洞察响应结构解析PostsInsightsFeedResponseTray 接口详解instagram private api 帖子数据洞察响应结构解析PostsInsightsFeedResponseTray 接口详解 PostsInsig后端instagram-private-api 帖子洞察数据模型解析PostsInsightsFeedResponseNode 接口完整指南instagram private api 帖子洞察数据模型解析PostsInsightsFeedResponseNode 接口完整指南 导读 PostsIn后端instagram-private-api 帖子数据洞察响应结构解析PostsInsightsFeedResponseTop_posts_unit 接口实战指南instagram private api 帖子数据洞察响应结构解析PostsInsightsFeedResponseTop_posts_unit 接口实战指后端上一篇ThinkingCap技术白皮书高效思维模型的训练与优化策略终极指南 下一篇Kimi-K2.7-Code-w4a8安全部署指南确保AI代码生成的可靠性与稳定性创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考