登录开始免费试用
easyCoexistence 官方 API

通过 API 查看 Instagram 洞察:账户与帖子指标

Instagram API 可返回专业账户及其帖子、Reels 和限时动态的洞察数据。账户指标包括覆盖人数、观看次数、互动账户数、关注与取消关注、点赞、评论、收藏和分享;帖子指标包括覆盖人数、观看次数、点赞、评论、收藏和分享。Meta 指出,数据最多可能延迟 48 小时。

easyCoexistence 通过 get_social_insights 读取 Instagram 洞察,因此您可以询问 Claude 或 ChatGPT 上周的帖子表现如何,直接从 Meta 获取账户或单条帖子的覆盖人数、观看次数、点赞、评论、收藏和分享。

48 hours

Instagram 指标背后的数据可能延迟多久。

100 followers

低于此数值,账户将不会返回关注与取消关注数据以及粉丝人口统计数据。

2 years

Meta 存储媒体指标的时长。

24 hours

限时动态指标通过 API 保留的时长。

21 Apr 2025

impressions 在所有 API 版本中停止生效的时间,2024 年 7 月 2 日前创建的媒体除外;views 取代了它。

哪些账户指标可用?

使用 GET /<IG_ID>/insights 读取,多数情况下设置 period=day 和 metric_type=total_value:

  • reach:看到该内容的唯一账户数,包括广告;为估算值。
  • views:内容被播放或展示的次数。
  • accounts_engaged:与该内容互动的账户数,包括广告;为估算值。
  • follows_and_unfollows:统计期内的关注与取消关注数;需要至少 100 名粉丝。
  • likes、comments、saves、shares、replies 和 reposts,另加 total_interactions。
  • profile_links_taps:商业地址、通话、电子邮件和短信按钮的点击次数。
  • follower_demographics 和 engaged_audience_demographics:年龄、城市、国家和性别。

哪些帖子指标可用?

使用 GET /<IG_MEDIA_ID>/insights 读取;适用的指标取决于内容格式。对于帖子或 Reel,点赞、评论、观看次数和总互动数仅统计自然互动,不包括基于该内容投放的广告互动。

  • 帖子和 Reels:reach、views、likes、comments、saved、shares、total_interactions 和 reposts。
  • 仅限 Reels:ig_reels_avg_watch_time、ig_reels_video_view_total_time 和 reels_skip_rate。
  • 帖子和限时动态:follows、profile_visits 和 profile_activity。
  • 限时动态:reach、views、shares、replies、navigation、reposts 和 total_interactions。

period、metric_type 和细分如何工作?

账户指标使用 period=day。metric_type=total_value 返回统计范围内的单一数值,是细分所必需的;time_series 按天返回数值,仅适用于 reach。细分会按 media_product_type(帖子、轮播、Reels、限时动态和广告)、按 follow_type(粉丝或非粉丝)或按 contact_button_type 拆分总数。

人口统计指标使用 this_week 或 this_month 等 timeframe,而非 since 和 until;若不设置 since 和 until,其他指标默认回溯 24 小时。若请求的细分不被其中某个指标支持,整个请求会以未知错误失败。

哪些门槛与延迟适用?

Meta 关于数值何时出现以及可用多久的规则:

  • 数据最多可能延迟 48 小时。
  • 粉丝不足 100 的账户不会返回 follows_and_unfollows 或 follower_demographics;engaged_audience_demographics 需要统计期内有 100 次互动。
  • 缺失或不可用的数据以空集形式返回,而不是 0。
  • 人口统计指标仅返回前 45 个值。
  • 账户指标最多保存 90 天,媒体指标最多保存 2 年。

限时动态和轮播有何不同?

限时动态指标仅保留 24 小时,若数值低于 5,则返回错误代码 10(观看人数不足),而不返回数字。来自欧洲和日本用户的回复会被排除,在该地区创建的限时动态回复数会显示为 0。使用 Instagram Login 时没有 story_insights Webhook,因此必须在限时动态展示期间读取其数据。

轮播在 API 中作为一个帖子报告:Meta 不会返回其中照片和视频的洞察数据。

为什么指标名称会变化?

因为 Meta 会在 API 版本之间淘汰并重命名指标。impressions 在 v22.0 中被弃用,并于 2025 年 4 月 21 日在所有版本中停止生效,但 2024 年 7 月 2 日前创建的媒体除外;views 随之引入取代它。plays、clips_replays_count 和 ig_reels_aggregated_all_plays_count 同时被移除。video_views 以及包括 profile_views 在内的若干资料时间序列此前已被移除。使用已淘汰名称的请求会失败,因此为早期 API 版本编写的指标列表可能需要更新。

常见错误

  • 请求 impressions。它已在所有 API 版本中失效;请改为请求 views。
  • 把空结果当作零。当某指标不可用时,Meta 返回空数据集,这与没有活动并不相同。
  • 在限时动态结束后读取其指标。它们仅保留 24 小时。
  • 为多个指标的请求添加细分。若其中某个指标不支持该细分,整个调用都会失败。
使用 EasyCoexistence 完成这些操作

每个连接每月 US$ 9 至 US$ 0.75,连接越多价格越低,并提供前 3 天免费试用。

常见问题

What replaced impressions in the Instagram API?

views,即统计内容被播放或展示的次数。Meta 已于 2025 年 4 月 21 日在所有 API 版本中停用 impressions,但 2024 年 7 月 2 日前创建的媒体除外。

Why does my account return no follower data?

对于粉丝少于 100 的账户,Meta 不会返回 follows_and_unfollows 或粉丝人口统计数据。

How far back can I read Instagram insights?

账户指标最多 90 天,媒体指标最多 2 年;online_followers 仅覆盖最近 30 天。

Do the numbers include ads?

部分包含。账户的覆盖人数和互动账户数包含广告,而帖子的点赞、评论和观看次数仅统计自然互动。

继续阅读

两分钟连接您的第一个渠道。

无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。

  • 免费试用 3 天
  • 随时取消
  • 仅使用官方 API
  • 全天候 24/7 监控

验证时间