通过 API 查看 Instagram 洞察:账户与帖子指标
Instagram API 可返回专业账户及其帖子、Reels 和限时动态的洞察数据。账户指标包括覆盖人数、观看次数、互动账户数、关注与取消关注、点赞、评论、收藏和分享;帖子指标包括覆盖人数、观看次数、点赞、评论、收藏和分享。Meta 指出,数据最多可能延迟 48 小时。
easyCoexistence 通过 get_social_insights 读取 Instagram 洞察,因此您可以询问 Claude 或 ChatGPT 上周的帖子表现如何,直接从 Meta 获取账户或单条帖子的覆盖人数、观看次数、点赞、评论、收藏和分享。
Instagram 指标背后的数据可能延迟多久。
低于此数值,账户将不会返回关注与取消关注数据以及粉丝人口统计数据。
Meta 存储媒体指标的时长。
限时动态指标通过 API 保留的时长。
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 小时。
- 为多个指标的请求添加细分。若其中某个指标不支持该细分,整个调用都会失败。
每个连接每月 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 监控
验证时间