Search⌘ K
Home/
Courses/
Manage Profiles, Pages, and Groups Using Facebook Graph API

Ratings and Insights

Learn how to get a page's ratings and insights.

We'll cover the following...

View ratings

Page ratings
Page ratings
https://graph.facebook.com/v16.0/{page_id}/ratings

Request parameters

The following are the request parameters of the above endpoint.

Parameter

Type

Category

Description

access_token

String

Mandatory

This is the token that we received in response after making the call to the accounts edge of the `user` object.

summary

Boolean

Optional

This tells whether to include a summary of the page's ratings or not. The summary contains the number of ratings and the overall rating of the page.

limit

String

Optional

This specifies the maximum number of results we want in the response.

To view ratings on the page using the Facebook Graph API, we can make a GET request to the ratings edge of the page object using the page's ID and a page access token that has the pages_read_user_content permission. Click the “Run” button to see the response.

Javascript (babel-node)
// Importing libraries here
import fetch from "node-fetch"
// Define endpoint URL here
const endpointUrl = new URL("https://graph.facebook.com/v16.0/{{PAGE_ID}}/ratings");
const headerParameters = {
    contentType: "application/json",
};
// Setting API call options
const options = {
    method: "GET",
    headers: headerParameters,
};
// Define Query Parameters here
const queryParameters = new URLSearchParams({
    access_token: '{{PAGE_ACCESS_TOKEN}}',
    limit: '10'
});
// Function to make API call
async function fetchPageRatings() {
    try {
        endpointUrl.search = queryParameters;
        const response = await fetch(endpointUrl, options);
        // Printing response
        printResponse(response);
    } catch (error) {
        // Printing error message
        printError(error);
    }
}
// Calling function to make API call
fetchPageRatings();

In the code widget above:

  • Line 5: We define the endpoint URL in the endpointUrl variable.

  • Lines 18–21: We add the access_token and set the limit to 10 to specify the maximum number of results to return in response in the queryParameters variable.

  • Line 27: We use the fetch function to make the API call.

Response fields

The response fields for the above endpoints are given in the table below.

Name

Type

Description

id

String

This is the ID of the user associated with the role.

rating

String

This is the rating value, an integer between 1 and 5.

reviewer

String

This is the information about the reviewer, including ID and name.

reviewer_text

String

This is the text written by the reviewer as part of the rating.

created_time

String

This is the time the rating was created. The time is in ISO 8601 format.

paging

Object

This is the information about the pagination of the feed. It contains fields such as next and previous, which we can use to retrieve the next and previous pages of the feed, respectively.

summary

Object

This is a summary of the feed containing information such as total_count (number of total posts in the feed) and can_like (indicating whether or not the feed can be liked).

Insights

Page insights
Page insights

The base URL for the endpoint above is:

https://graph.facebook.com/v16.0/{page_id}/insights

Request parameters

The request parameters for the above endpoint are provided in the table below.

Parameter

Type

Category

Description

access_token

String

Mandatory

This is the token that we received in response after making the call to the accounts edge of the `user` object.

metric

String

Mandatory

This is the metric that we want in the response. For example, page_impressions, page_engagements, page_fans, and so on.

period

String

Optional

This is the period over which the metric is returned. For example, day, week, days_28, and so on.

fields

String

Optional

These are the fields we want in the response from the API call.

since

DateTime

Optional

This date represents the lower bound of the range to query data. This is a UNIX timestamp or ISO 8601 date.

until

DateTime

Optional

This date represents the upper bound of the range to query data. This is a UNIX timestamp or ISO 8601 date.

limit

String

Optional

This specifies the maximum number of results we want in the response.

To get insights for a Facebook page using the Facebook Graph API, we can make a GET request to the insights edge of the page object using the page's ID and a page access token with the read_insights and pages_read_engagement permissions. Click the “Run” button to see the response.

Javascript (babel-node)
// Importing libraries here
import fetch from "node-fetch"
// Define endpoint URL here
const endpointUrl = new URL("https://graph.facebook.com/v16.0/{{PAGE_ID}}/insights");
const headerParameters = {
    contentType: "application/json",
};
// Setting API call options
const options = {
    method: "GET",
    headers: headerParameters,
};
// Define Query Parameters here
const queryParameters = new URLSearchParams({
    access_token: '{{PAGE_ACCESS_TOKEN}}',
    metric: 'page_impressions',
    limit: '10'
});
// Function to make API call
async function fetchPageInsights() {
    try {
        endpointUrl.search = queryParameters;
        const response = await fetch(endpointUrl, options);
        // Printing response
        printResponse(response);
    } catch (error) {
        // Printing error message
        printError(error);
    }
}
// Calling function to make API call
fetchPageInsights();

In the code widget above:

  • Line 5: We define the endpoint URL in the endpointUrl variable.

  • Lines 18–22: We add the access_token, specify the metric, and set the limit to 10 to specify the maximum number of results to return in response in the queryParameters variable.

  • Line 28: We use the fetch function to make the API call.

Response fields

The response fields for the above endpoint are mentioned in the table below.

Name

Type

Description

id

String

This is the ID of the insight.

name

String

This is the name of the metric for this insight.

period

String

This is the period over which the data was aggregated.

title

String

This is the title of the insight.

description

String

This is the description of the insight.

values

Array

This is the array of objects, and each one contains the value and `end_time` of the insight.

paging

Object

This is the information about the pagination of the feed. It contains fields such as next and previous, which we can use to retrieve the next and previous pages of the feed, respectively.

summary

Object

This is a summary of the feed containing information such as total_count (number of total posts in the feed) and can_like (indicating whether or not the feed can be liked).