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

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 の最新の表示回数、ユニーク視聴者、クリック、リアクションを受け取れます。

post_total_media_view_unique

Meta が推奨する post_impressions_unique の代替指標。全 API バージョンでの非推奨は 2026 年 6 月に設定された。

15 Nov 2025

post_impressions がすべてのバージョンでデータを返さなくなった時点。Meta は代替として post_media_view を挙げている。

lifetime

Meta が post_media_view、post_clicks、リアクション合計などの投稿指標について示す期間。

Like + care

Meta のいいね数に含まれるもの。「いいね」と care の両方が含まれる。

Empty dataset

アプリに 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 のメモには、次の代替指標が記載されています:

DeprecatedUse instead
Nov 15, 2025post_impressionspost_media_view
Nov 15, 2025post_impressions_paidpost_media_view with is_from_ads
Nov 15, 2025post_impressions_fanpost_media_view with is_from_followers
June 2026post_impressions_uniquepost_total_media_view_unique
June 2026post_impressions_paid_unique, post_impressions_organic_uniquepost_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 の例では、リアクションの合計を取得しています:

Meta's example request and response for one post, trimmed
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 はエラーではなく空のデータセットを返すため、先に権限を確認してください。
EasyCoexistence で実現する

投稿の検索には 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 監視

確認日