Messaging Insights API

With the Messaging Insights API (provided via the Pages Insights API), you can programatically retrieve the same information that appears in the Page Insights tab of your Facebook Page.

Contents

Retrieving Insights Metrics

To retrieve one or more metrics, send a GET request to the /insights endpoint, and include a comma-separated list of metric names to retrieve:

curl -X GET "https://graph.facebook.com/v2.8/me/insights/?metric=<LIST_OF_METRICS>&access_token=<PAGE_ACCESS_TOKEN>"

Available Metrics

The following Messenger-specific metrics are available. For more information, see the Messaging Insights API Reference.

Metric NameDescription

page_messages_total_messaging_connections

The number of people your business can send messages to.


This metric shows the number of people who have ever sent a message to your business on Messenger, not including people who have blocked or reported your business on Messenger. There may be some constraints on your ability to send messages to connections, such as limitations on how many messages you can send during certain timeframes. This metric also only includes connections made since October 2016, when data became available.


This metrics replaces the page_messages_open_conversations_unique metric, which was deprecated on May 11, 2018.

page_messages_new_conversations_unique

The number of messaging conversations on Facebook Messenger that began with people who had never messaged with your business before.

page_messages_active_threads_unique

Daily unique active conversations count.

page_messages_blocked_conversations_unique

The number of conversations with the Page that have been blocked.

page_messages_reported_conversations_unique

The number of conversations from your Page that have been reported by people for reasons such as spam, or containing inappropriate content.

page_messages_reported_conversations_by_report_type_unique

The number of conversations from your Page that have been reported by people for reasons such as spam, or containing inappropriate content. broken down by report type:

  • SPAM
  • INAPPROPRIATE
  • OTHER

page_messages_feedback_by_action_unique

Deprecated

page_messages_feedback_by_action_unique is deprecated as of November 7, 2017.

This metric will be removed in Graph API v2.12.

Please migrate your code to use our other Messaging Insights metrics, which provide comparable information.

Daily unique conversation counts broken down by user feedback actions, including

  • messaging turn-ons
  • messaging turn-offs
  • thread deletions
  • report spams
  • others