Instagram リールのインサイトを API で取得
Instagram のメディアインサイトのエンドポイント GET /<IG_MEDIA_ID>/insights は、リールについて次の指標を返します: views、reach、likes、comments、shares、saved、reposts、total_interactions、ig_reels_avg_watch_time、ig_reels_video_view_total_time、reels_skip_rate。クロスポストされたリールには、さらに crossposted_views と facebook_views が返されます。plays、clips_replays_count、ig_reels_aggregated_all_plays_count は 2025 年 4 月に廃止され、代わりに views を使用します。
easyCoexistence は get_social_insights でリールのインサイトを読み取るため、Claude、ChatGPT、または独自のコードから、接続済みアカウントのリールの視聴回数、リーチ、視聴時間、スキップ率を Meta から直接取得できます。
reels_skip_rate が測定する対象: リールの最初の 3 秒以内にスキップされた視聴の割合。
plays、clips_replays_count、ig_reels_aggregated_all_plays_count がすべての API バージョンで非推奨になった時期
reels_skip_rate、reposts、crossposted_views、facebook_views がメディアインサイトに追加された時期
メディア指標の元になるデータが遅延する可能性のある期間
Meta がメディア指標を保存する期間
リールはどの指標を返しますか?
Meta のメディアインサイトのリファレンスで media_product_type REELS に挙げられている指標です。GET /<IG_MEDIA_ID>/insights を、カンマ区切りの metric パラメータとともに呼び出して取得します。Meta が推定値または開発中とラベル付けしている指標は、各指標の横に記載しています。また、いいねとコメントはオーガニックなアクティビティとしてのみカウントされます:
リールのインサイトリクエストは何を返しますか?
data 内に指標ごとのオブジェクトが 1 つずつ返され、それぞれ name、period、values、title、description、id を含みます。period は常に lifetime です。メディア指標では Meta がこの値を設定しており変更できないため、リクエストで指定する必要はありません。Meta のリファレンスでは、2 つの視聴時間指標は単位を明記せずに時間量として説明されています。そのため、グラフ化する前に既知のリールと照らし合わせて確認してください。
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "views",
"period": "lifetime",
"values": [{ "value": <VALUE> }],
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"id": "<IG_MEDIA_ID>/insights/views/lifetime"
}
]
}どのリール指標が廃止され、何に置き換わりましたか?
Meta は最初の 3 つを、views が導入された日である 2025 年 1 月 21 日に Graph API v22.0 から非推奨にし、2025 年 4 月 21 日にはすべてのバージョンで非推奨にしました。video_views は v21.0 から非推奨となり、2025 年 1 月 8 日にすべてのバージョンで非推奨になりました。廃止された指標を指定したリクエストは失敗するため、2025 年より前に書かれた指標リストは更新が必要です:
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
リールの views と reach は何をカウントしますか?
views は、リールが Instagram で再生された回数です。Meta はこの指標を開発中とラベル付けしています。reach は、リールを少なくとも 1 回見たユニークアカウント数で、Meta は推定値とラベル付けしています。likes、comments、views、total_interactions はオーガニックなアクティビティのみをカウントし、リールから作成された広告でのエンゲージメントは含みません。プロモーションされたメディアを含む total_likes、total_comments、total_views は、Facebook Login の場合にのみ提供されます。
どの制限と遅延が適用されますか?
Meta のメディアインサイトのリファレンスでは、リールの数値について次のルールが定められています:
- 指標の元になるデータは最大 48 時間遅れる場合があります。
- メディア指標は最大 2 年間保存されます。
- データが欠けているか利用できない場合、0 ではなく空のデータセットが返されます。
crossposted_viewsとfacebook_viewsは、クロスポストされていないリールに対してはエラーになるため、それぞれ個別のリクエストで指定してください。- リクエストした指標がサポートしないブレイクダウンがあると、「An unknown error has occurred.」というエラーでリクエスト全体が失敗します。
- Instagram Login を使用する場合、トークンには
instagram_business_basicとinstagram_business_manage_insightsが必要で、エンドポイントは graph.instagram.com です。
get_social_insights はリールをどのように読み取りますか?
接続の account_id、リールのメディア ID を object_id として、指標のリストを渡します。easyCoexistence は、アカウントのトークンを使用して graph.instagram.com 上の GET /<IG_MEDIA_ID>/insights を呼び出し、指標名を与えられたとおりに Meta へ渡して、Meta のデータを返します。指標名が廃止されている場合は、Meta 自身のエラーをそのまま返します。list_social_posts は、アカウントの最近の投稿とリールのメディア ID を返します。
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<REEL_MEDIA_ID>",
"metrics": [
"views", "reach", "likes", "comments", "shares", "saved",
"total_interactions", "ig_reels_avg_watch_time",
"ig_reels_video_view_total_time", "reels_skip_rate"
]
}よくある間違い
- plays または clips_replays_count をリクエストすること。両方とも 2025 年 4 月 21 日にすべての API バージョンで非推奨になりました。代わりに views を指定してください。
- クロスポストされていないリールに対して crossposted_views や facebook_views を一般的なリクエストに混ぜること。その場合はエラーになり、呼び出し全体が失敗します。
- 視聴時間の単位を仮定すること。Meta のリファレンスは ig_reels_avg_watch_time と ig_reels_video_view_total_time の単位を示していないため、既知のリールで確認してください。
- 空の結果をゼロとして読むこと。データが存在しない、または現在利用できない場合、Meta は空のデータセットを返します。
指標名が廃止されている場合は Meta のエラーがそのまま返されます。料金は接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。
よくある質問
リールのインサイトリクエストが空の結果を返すのはなぜですか?
データが存在しない、または現在利用できない場合、Meta は 0 ではなく空のデータセットを返します。さらに、指標の元になるデータは最大 48 時間遅れることがあります。
API からリールの視聴時間を取得するにはどうすればよいですか?
平均には ig_reels_avg_watch_time、合計には ig_reels_video_view_total_time をリクエストしてください。合計にはリプレイ分も含まれます。どちらも GET /<IG_MEDIA_ID>/insights から取得します。
reels_skip_rate とは何ですか?
初回視聴のうち、リールの最初の 3 秒以内にスキップされた割合です。Meta は 2025 年 12 月 3 日にこの指標を追加し、推定値かつ開発中とラベル付けしています。
リールのインサイトには広告の視聴が含まれますか?
含まれません。likes、comments、views、total_interactions はオーガニックなアクティビティのみをカウントします。プロモーションされたメディアを含む total_views は、Facebook Login の場合にのみ提供されます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日