如何获取任意授权用户的Instagram Audience insights数据？

很多开发者刚开始对接时都会误以为Instagram有独立的开放平台，实际上从2020年开始，Instagram的所有官方商业数据开放能力已经全部合并到Meta Graph API体系内，和你已经对接完成的Facebook接口属于同一套技术框架，不需要单独找独立的Instagram对接资源，具体落地方式如下：

• 前置条件确认：只有完成专业账号认证（商业号/创作者号）、且绑定了Meta公共主页的Instagram账号，才开放受众洞察类数据的读取权限，普通个人账号无相关数据接口，你在产品的授权引导环节需要提前给用户说明这个要求，避免用户授权后拿不到数据。
• 授权权限补充：在你现有Facebook OAuth授权流程的权限列表里，新增3个和Instagram数据相关的权限即可，不需要单独开发一套Instagram授权逻辑：
  • instagram_basic：读取Instagram账号的ID、名称、头像等基础信息
  • instagram_manage_insights：读取粉丝互动、受众画像类洞察数据的核心权限
  • pages_show_list：用于校验Instagram账号绑定的Meta主页状态，确认账号具备数据读取资格
• 目标数据拉取方式：
  拿到用户授权的有效access token后，调用Graph API中Instagram账号节点下的insights接口，指定对应指标参数即可拉取你需要的三类核心数据：
  • 粉丝互动（follower-engagement）数据：传入engagement、reach、follower_count、impressions等指标，可拉取指定时间周期内的粉丝增减量、内容互动率、触达人数、曝光量等互动相关数据，支持按日、周、月维度做聚合统计
  • 受众所属国家分布：传入audience_country指标，接口会返回各个国家的粉丝数量及占比统计
  • 受众年龄段分布：传入audience_gender_age指标，接口会返回分性别、分年龄区间的粉丝占比统计
• 开发与上线注意事项：
  • 开发阶段你仅能拉取应用后台手动添加的测试账号的全量洞察数据，普通用户完成授权后也无法拉取完整数据，需要你将应用提交到Meta审核，明确说明数据收集用途、前端展示场景、用户隐私保护规则，审核通过后相关权限才会对所有授权用户生效
  • 你之前为Facebook对接开发的请求签名、access token续期、错误码处理、限流处理逻辑可以完全复用，只需要调整请求的节点路径和传入的指标参数即可，不需要重构现有对接框架
  • 不要尝试对接早年独立版本的Instagram Platform API，那套接口已经全面废弃，所有洞察类数据能力都已经迁移到现有Meta Graph API中，调用旧接口会直接返回权限错误

内容的提问来源于stack exchange，提问作者Mikhail