ログイン無料トライアルを開始
easyCoexistence 公式 API

API で見る Instagram インサイト:アカウントと投稿の指標

Instagram の API は、プロアカウントと、その投稿・リール・ストーリーズごとのインサイトを返します。アカウント指標には、リーチ、ビュー、エンゲージしたアカウント数、フォローとフォロー解除、いいね、コメント、保存、シェアが含まれます。投稿の指標には、リーチ、ビュー、いいね、コメント、保存、シェアが含まれます。Meta によると、データは最大 48 時間遅れる場合があります。

easyCoexistence は get_social_insights で Instagram のインサイトを読み取ります。

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 で取得します。利用できる指標はフォーマットによって異なります。投稿またはリールでは、いいね、コメント、ビュー、総インタラクションはオーガニックな活動のみを数えます。そこから作成された広告へのエンゲージメントは含まれません。

  • 投稿とリール: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 時間だけです。
  • 複数の指標を指定したリクエストに内訳を追加すること。一つでも対応していない指標があると、呼び出し全体が失敗します。
EasyCoexistence で実現する

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 監視

確認日