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

API で取得する Facebook の Reels と動画インサイト

Facebookの動画とReelsのインサイトは GET /{video-id}/video_insights から取得します。total_video_views は3秒以上の再生を数え、total_video_avg_time_watched と total_video_view_total_time は視聴時間をミリ秒で返します。Reelsでは blue_reels_play_count、fb_reels_total_plays、fb_reels_replay_count が加わります。Metaは2026年6月、すべてのAPIバージョンで total_video_impressions などの動画インプレッション指標と一意視聴者の指標を廃止しました。

easyCoexistence は、Claude、ChatGPT、またはご自身のコードから、Facebookページと投稿のインサイトを get_social_insights で読み取ります。

3 seconds

total_video_views が数える最短の再生は3秒です。それより短い動画では、ほぼ動画の全長が対象になります。

June 2026

Metaが total_video_impressions、total_video_views_unique、post_video_views_unique をすべてのAPIバージョンで廃止した時期。

2 years

動画インサイトのデータを遡れる期間。

40 intervals

total_video_retention_graph が動画をどう区切り、各地点の再生数を全視聴に対する割合で報告するか。

1 ms

blue_reels_play_count でReelの再生として数えられる再生条件。リプレイは含まれません。

Reels left out

Reelsのインタラクションは、Metaのインサイトリファレンスの制限事項のとおり、Facebookページの指標には含まれません。

どの指標を video_insights で取得できますか?

これらの動画指標はMetaのリファレンスに載っており、2026年11月時点で廃止リストには含まれていません。いずれも動画のIDで読み取る累計値です。視聴は1回の再生内でのリプレイ時間を除外して数えます。organic と paid の版を持つものも多く、total_video_views_organic や total_video_views_paid がその例です:

total_video_viewsPlays of at least 3 seconds, or nearly the full length if shorter
total_video_complete_viewsPlays of 97% or more of the length
total_video_15s_viewsPlays of 15 seconds or more
total_video_60s_excludes_shorter_viewsPlays of 60 seconds or more
total_video_avg_time_watchedAverage viewing time, in milliseconds
total_video_view_total_timeTotal viewing time, in milliseconds
total_video_retention_graphPlays at each of 40 intervals, as a percentage of views
total_video_reactions_by_type_totalReactions to the video, by type

Reelsに関する指標はどれですか?

MetaのリファレンスにはReelsのセクションがあり、Reelの動画IDで読み取ります。値はいずれも累計です:

  • blue_reels_play_count: インプレッションのあとの1ミリ秒以上の再生を数えます。リプレイは含みません。
  • fb_reels_total_plays: 同じ再生をリプレイを含めて数えます。fb_reels_replay_count は同じセッション内のリプレイだけを数えます。
  • post_video_avg_time_watched と post_video_view_time: リプレイを含む再生の平均時間と合計時間(ミリ秒)。
  • post_video_followers: Reelからのフォロー数。
  • post_video_likes_by_reaction_type: Reelへのいいね。
  • post_video_social_actions: Reelへのコメントとシェア。
  • post_video_retention_graph: Reel内の地点ごとの再生数を、総再生数に対する割合で示したもの。

2026年にMetaが廃止した動画指標はどれですか?

Metaの Graph API v25 の発表で、2026年6月に2グループがすべてのAPIバージョンで廃止されました。代わりに Media Views と Media Viewers の指標を使うよう案内されています。一意視聴者の指標は post_total_media_view_unique と page_total_media_view_unique、有料とオーガニックの分割は post_media_view と page_media_view です:

  • 動画インプレッション: total_video_impressions とそのユニーク、有料、オーガニック、バイラル、ファンの版、および動画上の post_impressions_unique。
  • 3秒視聴者: total_video_views_unique とそのオーガニック・有料版、post_video_views_unique とそのオーガニック・有料版、page_video_views_unique。

post_video_views と page_video_views は今も有効ですか?

はい。どちらも非推奨マークなしでMetaのインサイトリファレンスに残っています。post_video_views は動画投稿の3秒以上の再生を、ライフタイムまたは日単位で数えます。page_video_views はページの再生を、日、週、days_28 単位で数えます。ユニーク版、post_video_views_unique と page_video_views_unique は、2026 年 6 月にすべての API バージョンで非推奨となりました。10秒指標(post_video_views_10s など)は v18 より新しいバージョンで非推奨です。

動画インサイトはどのようにリクエストしますか?

3つのオブジェクトがあり、それぞれ独自の指標を持ちます。metric にカンマ区切りのリストを指定して GET /{video-id}/video_insights を呼ぶと、動画またはReelを読み取ります。metric を指定しない場合は、その動画の累計値を返します。post_video_views などの投稿レベルの動画指標は GET /{page-post-id}/insights で、page_video_views などのページレベルの指標は period を指定して GET /{page-id}/insights で読み取ります。

Reading a video's views and watch time
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graph

必要な権限とタスクは何ですか?

ページに対して ANALYZE タスクを実行できる人のページトークンです。Metaの video_insights リファレンスでは read_insights と pages_manage_engagement、動画インサイトのガイドでは pages_read_engagement が挙げられています。データは過去2年分が対象です。ユーザーやグループの動画のインサイトは取得できません。クロスポストされた動画は、投稿された各ページごとに別の動画IDを持ちます。

ページレベルの指標にはReelsが含まれますか?

含まれません。Metaのインサイトリファレンスは、ページ指標を読み取る際の制限として、Reelsのインタラクションは含まれないと明記しています。Reelの再生数、フォロー、コメント、シェアは、Reel自身の動画IDを使い video_insights で読み取ります。

easyCoexistence ではどのように読み取りますか?

get_social_insights は、ページまたは1件の投稿のインサイトエッジを読み取ります。指標、期間、そして投稿の場合は object_id を指定し、since や until などの追加パラメータはそのまま渡されます。video_insights は独立したエッジで、どのツールからも読み取れないため、動画やReel自体の指標は Meta Business Suite で確認します。廃止された指標はMetaのエラーとして返るため、AIが指標名を切り替えられます。

よくある間違い

  • total_video_impressions を要求すること。Metaは2026年6月に動画インプレッション指標を廃止しました。代わりに post_media_view などの Media Views 指標を要求してください。
  • 視聴維持率グラフの値を合計すること。それらは各区間での視聴に対する割合であり、再生数ではありません。
  • Reelをページの合計値で探すこと。Metaのページインサイトは Reels のインタラクションを含まないため、各Reelの video_insights を読み取ってください。
  • 視聴時間を秒として読むこと。total_video_avg_time_watched、total_video_view_total_time、post_video_view_time はミリ秒単位です。
EasyCoexistence で実現する

AIがページとその投稿の状況を説明できます。動画やReel自体の video_insights は Meta Business Suite で確認します。接続ごとに月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の3日間は無料です。

よくある質問

total_video_views_unique は何に置き換わりましたか?

Metaは Media Viewers の指標を案内しています。投稿では post_total_media_view_unique、ページでは page_total_media_view_unique です。

APIでReelの再生数を取得するにはどうすればよいですか?

blue_reels_play_count を読み取るか、リプレイを含める場合は fb_reels_total_plays を、Reelの開始リクエストで返された動画IDを使って GET /{video-id}/video_insights から読み取ります。

post_impressions_unique はReelでもまだ使えますか?

いいえ。Metaの Reels の表にはまだ記載されていますが、v25 の発表で2026年6月に video_insights 上で廃止されました。post_total_media_view_unique が投稿の一意視聴者を数えます。

インサイトがない動画はどれですか?

ユーザーやグループに投稿された動画です。Metaの動画インサイトはページ上の動画が対象で、過去2年分のデータがあります。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日