个人开发者如何获取Instagram Hashtag Graph API有效访问令牌？

必要前提 #

• 已将个人Instagram账号转为Instagram企业账号
• 已注册Meta开发者个人账号

1. 创建个人消费者应用（无需企业验证） #

• 进入Meta开发者平台，点击「创建应用」
• 选择「消费者」分类（面向个人开发者的应用类型，无需企业资质）
• 填写基础信息：项目名称可随意填写（比如「Instagram Tag Test」），邮箱用你的Meta账号邮箱，无需填写域名、服务器相关信息
• 应用创建完成后，在左侧菜单「产品」中添加「Instagram Graph API」产品

2. 关联你的Instagram企业账号 #

• 进入左侧菜单「角色」，添加你自己的Meta个人账号为应用的「管理员」或「开发者」角色
• 确保你的Instagram企业账号已绑定一个Facebook Page（转企业账号时系统会要求绑定，若未完成，先去Instagram设置里绑定一个个人Facebook Page）
• 进入「Instagram Graph API」的配置页面，点击「连接Instagram账号」，选择你的Instagram企业账号，确认授权时勾选以下权限：instagram_basic、pages_show_list、pages_read_engagement

3. 生成一次性测试访问令牌 #

• 进入左侧菜单「工具」->「访问令牌工具」
• 在页面中选择你绑定的Facebook Page（对应你的Instagram企业账号）
• 勾选权限：instagram_basic、pages_read_engagement
• 点击「生成令牌」，复制生成的短期访问令牌（有效期1小时，足够本地测试使用）

4. 获取话题ID并调用接口 #

获取话题ID #

使用生成的令牌调用接口（替换占位符）：

GET /ig_hashtag_search?user_id={你的Instagram企业账号ID}&q={目标标签名}&access_token={你的访问令牌}

你的Instagram企业账号ID可在「访问令牌工具」中选择对应账号后查看，或调用 GET /me/accounts?access_token={你的令牌} 获取返回结果中的id值

调用近期内容接口 #

拿到话题ID后，调用目标接口（替换占位符）：

GET /{话题ID}/recent_media?user_id={你的Instagram企业账号ID}&access_token={你的访问令牌}

• 接口返回的是当前账号有权限获取的公开话题内容
• 控制调用频率在Meta限制内，30秒一次符合要求

常见问题排查 #

• 令牌无效：确认令牌关联了正确的Facebook Page和Instagram账号，权限勾选完整；若令牌过期，重新生成即可
• 账号无效：检查Instagram账号是否为企业账号，是否已绑定Facebook Page，且已在应用中完成授权
• 权限不足：确保授权时勾选了instagram_basic和pages_read_engagement，未拒绝任何必要权限

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