API で取得する Instagram ストーリーズのインサイト
Instagram の メディアインサイトのエンドポイントは、ストーリーズが公開されている間、次の指標を返します:reach、views、replies、shares、navigation、follows、profile_visits、profile_activity、reposts、total_interactions。navigation は story_navigation_action_type により TAP_FORWARD、TAP_BACK、TAP_EXIT、SWIPE_FORWARD に分けられます。ストーリーズの指標は 24 時間のみ取得でき、5 未満の値ではエラーコード 10 が返されます。また、Instagram Login には story_insights の Webhook がありません。
easyCoexistence は、ストーリーズが公開されている間に get_social_insights で指標を読み取ります。
ストーリーズのメディア指標を API で取得できる期間。
指標が 5 未満のとき、値の代わりに返される内容です。メディアにインサイトを表示するには視聴者が少なすぎることを示します。
Meta のインサイトガイドが story_insights Webhook に示す唯一の設定です。Instagram Login ではサポートされていません。
ヨーロッパまたは日本で作成されたアカウントのストーリーズの返信数の値。
Meta がストーリーズ向けに link_clicks を追加した時点。リンクステッカーなどのリンクのタップを数えるもので、Facebook Login のみで利用できます。
ストーリーズはどの指標を返しますか?
Meta のメディアインサイトのリファレンスで、media_product_type が STORY の指標として挙げられているものを、ストーリーズが公開されている間に GET /<STORY_MEDIA_ID>/insights で読み取ります。Instagram Login の場合は、instagram_business_basic と instagram_business_manage_insights のスコープを持つトークンを使い、graph.instagram.com に呼び出します。period は常に lifetime です:
ナビゲーションの操作別の内訳はどう読みますか?
breakdown=story_navigation_action_type を付けて navigation だけを単独でリクエストします。合計は total_value.value に、各操作は total_value.breakdowns[].results に返されます。これらを合計すると全体の値になります。TAP_FORWARD(前へ)、TAP_BACK(戻る)、TAP_EXIT(終了)、SWIPE_FORWARD(次のストーリーズ)です。Meta のサンプルレスポンスは、値を小文字で記載しています:
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
?metric=navigation
&breakdown=story_navigation_action_type
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "navigation",
"period": "lifetime",
"values": [{ "value": 25 }],
"total_value": {
"value": 25,
"breakdowns": [
{
"dimension_keys": ["story_navigation_action_type"],
"results": [
{ "dimension_values": ["tap_forward"], "value": 19 },
{ "dimension_values": ["tap_back"], "value": 4 },
{ "dimension_values": ["tap_exit"], "value": 1 },
{ "dimension_values": ["swipe_forward"], "value": 1 }
]
}
]
},
"id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
}
]
}ストーリーズの指標はどれくらい取得できますか?
24 時間です。Meta はストーリーズのメディア指標を 24 時間のみ提供します。これはストーリーズ自体の寿命に相当します。一方、指標の元になるデータは最大 48 時間遅れることがあります。ストーリーズが公開されている間にスケジュールに従って読み取り、取得した最後の値を保存しておきます。Meta によると、ストーリーズがハイライトに追加された場合、期限切れ後もデータが届くことがあり、その場合は API 呼び出し、Webhook、アプリで異なる結果が表示されることがあります。
ストーリーズの指標がエラーコード 10 を返すのはなぜですか?
その値が 5 未満だからです。Meta は小さな数値の代わりに、エラーコード 10 と、メッセージ「(#10) Not enough viewers for the media to show insights」を返します。そのため、見られた人の少ないストーリーズは、より多く見られたストーリーズが成功する一方で失敗することがあります。障害ではなく少ない件数として扱い、ループで再試行しないでください。
ストーリーズの返信数が 0 になるのはなぜですか?
地域のルールによるものです。ヨーロッパの人からの返信は 2020 年 12 月 1 日以降、日本の人からの返信は 2021 年 4 月 14 日以降、replies の指標から除外されます。そのため、これらの地域のアカウントで作成されたストーリーズは 0 を返します。Meta のリファレンスでは、replies を、ストーリーズのメディアオブジェクトに対する IG Comments と定義しています。
story_insights の Webhook はありますか?
Instagram Login ではありません。Meta のフィールド表では、story_insights が Instagram Login で利用できないと示されています。メディアインサイトのリファレンスでも、インサイトの Webhook は Instagram Login ではサポートされていないと書かれています。インサイトガイドでも、story_insights は Facebook Login のみと記載されています。Facebook Login では、このフィールドはストーリーズの期限切れ時に発火し、最初の 24 時間分の指標だけを含み、5 未満の数値は -1 として返されます。
廃止または制限された指標はありますか?
古いコードや Meta の変更履歴には、今も次の名前が残っていることがあります:
- impressions:2024 年 7 月 2 日以降に作成されたメディアでは非推奨のため、現在のストーリーズは代わりに views を返します。
taps_forward、taps_back、exits:2023 年 12 月 11 日に廃止されました。story_navigation_action_typeで分類された navigation が同じ操作を返します。link_clicks:リンクステッカーなどのリンクのタップです。2026 年 6 月 22 日に追加され、Facebook Login のみで利用できます。total_views:プロモーションされたメディアを含む、複数の表示面をまたいだ表示数です。Facebook Login のみで提供されています。
get_social_insights はストーリーズをどう読み取りますか?
object_id にストーリーズのメディア ID を指定します。これは、ストーリーズを公開する際に publish_instagram_post が media_id として返す値です。指標はリストで返されます。navigation は別の呼び出しで、params に breakdown=story_navigation_action_type を設定して依頼してください。1 つの指標が対応していない breakdown を一緒に指定すると、呼び出し全体が失敗するためです。エラーは Meta が書いたままの形で返されます。エラーコード 10 も同様です。
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<STORY_MEDIA_ID>",
"metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}よくある間違い
- 翌日にストーリーズの指標を読み取ること。Meta が提供するのは 24 時間のみなので、ストーリーズが公開されている間に収集してください。
- エラーコード 10 をループで再試行すること。これは 5 未満の値、つまり視聴者が少ないことを意味し、より多くの人が見るまで変わりません。
- 他の指標と一緒に breakdown 付きでナビゲーションを要求すること。story_navigation_action_type は navigation 単独でのみ動作し、対応していない breakdown は呼び出し全体を失敗させます。
- Instagram Login で story_insights を待つこと。Meta はそこで該当の Webhook を提供していないため、ストーリーズが期限切れになる前にインサイトエンドポイントをポーリングしてください。
そのため、Claude、ChatGPT、または独自のコードから、今日のストーリーズの結果を尋ねて、接続されたアカウントのリーチ、表示回数、返信、シェア、ナビゲーションを Meta から直接取得できます。ストーリーズの投稿は publish_instagram_post で行います。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
ハイライトに追加すると、インサイトは変わりますか?
変わることがあります。Meta によると、ハイライトに追加されたストーリーズは期限切れ後もデータを受け取り続けることがあるため、API、Webhook、アプリの結果が一時的に一致しない場合があります。
Instagram Login のストーリーズで total_views は使えますか?
いいえ。total_views は、プロモーションされたメディアを含む複数の表示面をまたいだ表示数で、Facebook Login でのみ提供されています。Instagram Login では views を取得してください。
API で Instagram ストーリーズのリンクステッカーのクリックを読み取れますか?
Facebook Login のみで可能です。Meta は 2026 年 6 月 22 日にストーリーズ向けの link_clicks を追加しました。これはリンクステッカーなどのリンクのタップを数えるもので、Instagram Login では提供されていません。
taps_forward、taps_back、exits の代わりになったものは何ですか?
story_navigation_action_type により TAP_FORWARD、TAP_BACK、TAP_EXIT、SWIPE_FORWARD に分類される navigation です。古い指標は 2023 年 12 月 11 日に廃止されました。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日