API で取得する Facebook 投稿インサイト: 表示回数、リーチ、エンゲージメント
Facebook 投稿のインサイトは、GET /{page-post-id}/insights に post_media_view(投稿が再生または表示された回数)、post_total_media_view_unique(投稿のユニーク視聴者数)、post_clicks、post_reactions_by_type_total などの指標を指定して取得します。Meta は 2025 年 11 月に post_impressions、2026 年 6 月に post_impressions_unique を非推奨にしたため、現在は表示回数とユニーク視聴者数がインプレッションとリーチの代わりとなります。
easyCoexistence は get_social_insights で Facebook 投稿のインサイトを読み取るため、Claude、ChatGPT、または独自のコードから投稿の結果を尋ね、Meta の最新の表示回数、ユニーク視聴者、クリック、リアクションを受け取れます。
Meta が推奨する post_impressions_unique の代替指標。全 API バージョンでの非推奨は 2026 年 6 月に設定された。
post_impressions がすべてのバージョンでデータを返さなくなった時点。Meta は代替として post_media_view を挙げている。
Meta が post_media_view、post_clicks、リアクション合計などの投稿指標について示す期間。
Meta のいいね数に含まれるもの。「いいね」と care の両方が含まれる。
アプリに read_insights 権限がない場合、エラーの代わりに Meta が返すもの。
2026 年に使える投稿指標はどれですか?
以下はいずれも Meta のインサイトリファレンスに掲載されており、2026 年 11 月 1 日時点で非推奨リストには含まれていません。各指標は投稿の ID を指定して読み取り、特記がない場合の期間は lifetime です:
post_media_view:投稿が再生または表示された回数。is_from_adsとis_from_followersの内訳を含む。post_total_media_view_unique:投稿のユニーク視聴者数。リーチの代わりとして Meta が提供する指標。post_clicks:ストーリーを生成しなかった投稿内のあらゆるクリック数。post_clicks_by_typeで消費タイプ別に分けられる。post_reactions_by_type_total:タイプ別のリアクション。post_reactions_love_totalやpost_reactions_anger_totalなど、タイプごとの合計も含む。post_video_views:3 秒以上再生された動画の再生数。期間は lifetime または day。
投稿のインプレッションとリーチは何に置き換わりましたか?
Meta は投稿の計測を 2 段階でインプレッションからメディアの表示へ移行しました。どちらも全 API バージョンで同時に適用され、廃止された名前を指定すると invalid metric エラーが返ります。Meta の変更履歴、非推奨指標のページ、Graph API v25 のメモには、次の代替指標が記載されています:
| Deprecated | Use instead | |
|---|---|---|
| Nov 15, 2025 | post_impressions | post_media_view |
| Nov 15, 2025 | post_impressions_paid | post_media_view with is_from_ads |
| Nov 15, 2025 | post_impressions_fan | post_media_view with is_from_followers |
| June 2026 | post_impressions_unique | post_total_media_view_unique |
| June 2026 | post_impressions_paid_unique, post_impressions_organic_unique | post_media_view breakdowns, which count views rather than people |
表示回数とユニーク視聴者の違いは何ですか?
表示回数は表示の回数を数え、ユニーク視聴者は人数を数えます。post_media_view は投稿が再生または表示されるたびに加算されるため、同じ人が 2 回見ると 2 回として数えられます。一方 post_total_media_view_unique は投稿のユニーク視聴者を 1 人につき 1 回ずつ数えます。Meta は _unique で終わる指標を概算として扱い、ユニーク値は独立して計算されるため、合計値が各部分の和と一致するとは限りません。
投稿のインサイトはどのように取得しますか?
GET /{page-post-id}/insights を使い、metric にカンマ区切りの指標リストを指定します。1 つだけ取得する場合は GET /{page-post-id}/insights/{metric} を使います。トークンは、ページに対して ANALYZE タスクを実行できる人のものである必要があり、read_insights と pages_read_engagement の権限が付与されている必要があります。各結果には name、period、values、title、description が含まれます。Meta の例では、リアクションの合計を取得しています:
GET /{page-post-id}/insights?metric=post_reactions_like_total,post_reactions_love_total
{
"data": [
{
"name": "post_reactions_like_total",
"period": "lifetime",
"values": [{ "value": 226 }],
"title": "Lifetime Total Like Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_like_total/lifetime"
},
{
"name": "post_reactions_love_total",
"period": "lifetime",
"values": [{ "value": 17 }],
"title": "Lifetime Total Love Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_love_total/lifetime"
}
]
}リアクション、コメント、シェアの数はどう数えますか?
投稿自身のフィールドから、インサイトと並べて取得します。fields=reactions.summary(total_count) でリアクションの合計が返り、reactions.type(LOVE).limit(0).summary(total_count) で 1 種類の数が返ります。種類は LIKE、LOVE、WOW、HAHA、SORRY、ANGRY から選べます。shares フィールドにはシェア数が入っており、Meta によると削除された投稿やトークンから見えない投稿も含まれる場合があります。また summary=true を付けた comments エッジには total_count が追加されます。
投稿指標とページ指標の関係は?
ページ指標は一定期間におけるページのコンテンツ全体を集計し、投稿指標は 1 つの投稿の lifetime 合計を示します。page_post_engagements は、リアクション、コメント、シェアなどを通じたページの投稿へのエンゲージメントを day、week、days_28 の単位で数えます。page_media_view と page_total_media_view_unique も同様に、表示と視聴者を集計します。Meta は 2024 年に post_engaged_users を削除したため、投稿ごとのエンゲージメントはクリック、リアクション、コメント、シェアから組み立てます。
データはどれくらい新しく、どこまで遡れますか?
ほとんどの指標は 1 日 1 回更新されます。post_clicks などアスタリスク付きの指標は、1 日に複数回更新されます。公開ページのインサイトは 2 年分保持されますが、非公開のページは 5 日分のみです。lifetime とは、データが利用可能な期間を指し、デフォルトでは 2 年以内です。ページインサイトのデータには 100 件以上のいいねが必要で、別のページからリシェアされた動画では、いくつかの動画指標が 0 を返します。
easyCoexistence は投稿インサイトをどう読み取りますか?
get_social_insights は指標を受け取り、1 つの投稿を指定する場合は object_id(list_social_posts が返す投稿 ID)を受け取ります。object_id を省略するとページを読み取ります。period や since、until などの追加パラメーターは Meta にそのまま渡されます。廃止された指標は Meta の invalid metric エラーとして返されるため、AI は現行の名前に切り替えることができます。
よくある間違い
- post_impressions_unique をリクエストすること。Meta は 2026 年 6 月に全 API バージョンでこの指標を非推奨にしました。ユニーク視聴者を数えるには post_total_media_view_unique を指定してください。
- 投稿をまたいでユニーク視聴者を合算すること。各投稿は自身の視聴者を概算で数えるため、2 つの投稿を見た人は 2 回数えられます。
- 別のページからリシェアされた動画のインサイトを読むこと。リシェアでは複数の動画指標が 0 を返し、動画を作成したページだけが正確な値を取得できます。
- 空のレスポンスの 0 を信じること。read_insights がないと、Meta はエラーではなく空のデータセットを返すため、先に権限を確認してください。
投稿の検索には list_social_posts を使います。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
Facebook の投稿リーチの代わりは何ですか?
post_total_media_view_unique です。Meta が 2026 年 6 月に post_impressions_unique を非推奨にした後、投稿のユニーク視聴者数を数える指標です。
ページの投稿に誰がリアクションしたか見られますか?
いいえ。Meta はタイプ別のリアクション数を返しますが、ページや個人が照会できるのは自分のリアクションだけで、ほかのリアクションは非公開のままです。
いいね数には care リアクションが含まれますか?
はい。いいねの合計には「いいね」と care の両方が含まれます。インサイトでもリアクションのエッジでも同じです。
別のページの投稿のインサイトは読めますか?
ページインサイトを通じては読めません。投稿を作成したページに対して ANALYZE タスクを実行できる人のトークンが必要です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日