API で見る Instagram インサイト:アカウントと投稿の指標
Instagram の API は、プロアカウントと、その投稿・リール・ストーリーズごとのインサイトを返します。アカウント指標には、リーチ、ビュー、エンゲージしたアカウント数、フォローとフォロー解除、いいね、コメント、保存、シェアが含まれます。投稿の指標には、リーチ、ビュー、いいね、コメント、保存、シェアが含まれます。Meta によると、データは最大 48 時間遅れる場合があります。
easyCoexistence は get_social_insights で Instagram のインサイトを読み取ります。
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 で取得します。利用できる指標はフォーマットによって異なります。投稿またはリールでは、いいね、コメント、ビュー、総インタラクションはオーガニックな活動のみを数えます。そこから作成された広告へのエンゲージメントは含まれません。
- 投稿とリール:reach、views、likes、comments、saved、shares、
total_interactions、reposts。 - リールのみ:
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 は期間全体の値を 1 つ返し、内訳にはこれが必要です。time_series は日ごとの値を返し、reach でのみ利用できます。内訳では、合計値を media_product_type(投稿、カルーセル、リール、ストーリーズ、広告)、follow_type(フォロワーかどうか)、contact_button_type で分けます。
属性の指標は since と until の代わりに this_week や this_month などの timeframe を取ります。since と until を指定しない場合、その他の指標は過去 24 時間を対象とします。リクエストした指標の一つが対応していない内訳を指定すると、リクエスト全体が unknown error で失敗します。
どのような条件と遅延が適用されますか?
数値が表示される条件と、利用できる期間についての Meta のルール:
- データは最大 48 時間遅延することがあります。
- フォロワー 100 人未満のアカウントでは、
follows_and_unfollowsとfollower_demographicsは返されません。engaged_audience_demographicsは、期間内に 100 件のエンゲージメントが必要です。 - データが欠損または利用不可の場合、0 ではなく空のセットが返されます。
- 属性の指標は上位 45 件の値のみを返します。
- アカウント指標は最大 90 日間、メディアの指標は最大 2 年間保存されます。
ストーリーズとカルーセルでは何が違いますか?
ストーリーズの指標は 24 時間のみ利用できます。視聴者が 5 人未満の場合は、数値の代わりにエラーコード 10(not enough viewers)が返されます。欧州と日本のユーザーからのリプライは除外され、そこで作成されたストーリーズのリプライ数は 0 と報告されます。Instagram Login では story_insights の Webhook がないため、ストーリーズの数値はストーリーズが公開されている間に読み取る必要があります。
カルーセルは 1 つの投稿として報告されます。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 時間だけです。
- 複数の指標を指定したリクエストに内訳を追加すること。一つでも対応していない指標があると、呼び出し全体が失敗します。
Claude や ChatGPT に先週の投稿の結果を尋ねれば、アカウント全体、または 1 件の投稿について、リーチ、ビュー、いいね、コメント、保存、シェアを Meta から直接取得できます。接続ごとに月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。
よくある質問
Instagram API で impressions に代わるものは何ですか?
views です。コンテンツが再生または表示された回数を数えます。Meta は 2025 年 4 月 21 日にすべての API バージョンで impressions を廃止しました(2024 年 7 月 2 日より前に作成されたメディアを除く)。
フォロワーのデータが返されないのはなぜですか?
フォロワーが 100 人未満のアカウントでは、Meta は follows_and_unfollows もフォロワーの属性も返さないためです。
Instagram のインサイトはどこまで遡って読み取れますか?
アカウントの指標は最大 90 日間、メディアの指標は最大 2 年間です。online_followers は直近 30 日間のみを対象とします。
数値に広告は含まれますか?
一部含まれます。アカウントのリーチとエンゲージしたアカウント数には広告が含まれますが、投稿のいいね、コメント、ビューはオーガニックな活動のみを数えます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日