--- title: "Collect Facebook page insights with the Data Platform connector" description: "Collect data and insights from a Facebook page into the Data Platform, such as likes, views and comments" url: https://docs.ovhcloud.com/en/guides/public-cloud/data-platform/connectors-sources-facebook lang: en lastUpdated: 2026-09-14 --- > For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/en/llms-full.txt. # Collect Facebook page insights with the Data Platform connector ## Objective :::warning Uh oh! This article is outdated and needs to be rewritten. Please contact Support if you need help setting up this connector. ::: The Facebook connector lets you collect data and insights from a Facebook page into the Data Platform, such as likes, views and comments. ![FB1](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/FB1.png) ## Get your access credentials ### Learn how to get a Facebook Developer app token The following steps will guide you through the procedure of creating an app token on the Facebook Developer user interface. #### Pre-requisites: app token - Log into your Facebook account that has all the **Admin** permissions on the Pages you want the access tokens for.\ If you are not the page's admin, ask your admin to grant you Analyst access to the page. - Please note that if the account that granted access to the tokens doesn’t own the admin or analyst role for the page anymore, the access token will be revoked. #### Procedure: app token ##### Step 1. Create your Facebook Developer app - Go on : [https://developers.facebook.com/](https://developers.facebook.com/) and click on `Get Started` at the top right corner. ![Procedure: app token — Facebook dev2](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev2.png) - Follow the steps in the pop-up window that just opened. It is not mandatory to create a "First App", you can skip this step. ![Procedure: app token — Facebook dev3](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev3.jpg) - Go on [https://developers.facebook.com](https://developers.facebook.com). Enter the `My Apps` menu at the top right corner, right next to the search bar. You should now be able to click the `Add a New App` button at the top right corner. ![Procedure: app token — Facebook dev4](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev4.png) - Fill-in the blanks in the form that just popped up and click on `Create App ID` ![Procedure: app token — Facebook dev5](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev5.png) ##### Step 2. Retrieve your App ID and App Secret - You will now land on you new App Dashboard. Click on `Settings` on the left and then on `Basic`, right beneath it. ![Procedure: app token — Facebook dev6](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev6.png) - Just right to the `App Secret` field, click on `Show`. ![Procedure: app token — Facebook dev7](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev7.png) - You can now copy your App ID and App Secret and paste them in a new text editor window. ![Procedure: app token — Facebook dev8](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev8.png) #### How to validate your Facebook app - Go to [https://developers.facebook.com/apps](https://developers.facebook.com/apps). Click on the app you need to review ![How to validate your Facebook app — Step1](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step1.png) - Go to your basic settings. Click on "Settings", then "Basic" ![How to validate your Facebook app — Step2](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step2.png) - Give your basic settings. Give the following information in order to submit your app. ![How to validate your Facebook app — Step3](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step3.png) - Add a platform. At the bottom of the settings page, click on "Add Platform". Then click on Website, enter your company website URL and click on "Save changes", at the bottom right. ![How to validate your Facebook app — Step4](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step4.png) - Begin the app review by simply clicking on "App Review". Then click on "Add items" in the right corner. ![How to validate your Facebook app — Step5](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step5.png) - Then click on "Read\_insights" and click on add 1 item. ![How to validate your Facebook app — Step6](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step6.png) - Add details of sumissions. Go back to "App review tab" and click on "Add details" for read\_insights. ![How to validate your Facebook app — Step7](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step7.png) - Add details of read\_insights submission ![How to validate your Facebook app — Step8](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step8.png) - Submit the review. You must read the conditions, click on "I accept..." and then click on "Submit". - Conclusion of the review. Facebook review can take from 2-3 days, to some weeks in peak periods. If your review is not accepted : If that’s because of the screencast, kindly reajust the screencast in view of the facebook notices If that’s because of the review text, please reajust the text and gives us feedback about it If the reason seems more blocking or go in contradiction with the present document, you can contact the Data Platform Team and we will do our best to help. - Business creation. In the left menu, click on "Settings", then Advanced. Scroll down until you see "Business Manager", then click on "Get started". - Complete and validate the following form. ![How to validate your Facebook app — Step13](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step13.png) - Business verification. Once your app has been verified, you should receive a message in order to verify your business Go to App Review, and click on "Provide business details". Enter them and click on the Next button. ![How to validate your Facebook app — Step9](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step9.png) - You should provide business documents that show the legal name of your business plus at least one of the following which matches the information you just entered : - Business Phone Number - Address - Tax ID ![How to validate your Facebook app — Step14](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step14.png) - Provide basic information about you, then "Submit". ![How to validate your Facebook app — Step11](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/step11.png) - You will receive an email in order to accept the legal terms If you haven’t got the email : please check your spam box. Or redo the last step and correct your email information, the submission will re-send an email. Click on the link in order to accept the terms. - On the terms page, read attentively all the terms, Then click "I Agree" if you agree with all the terms. You're good to move to step 3! ##### Step 3. Generate your app's token - Go on [https://developers.facebook.com/tools/explorer/](https://developers.facebook.com/tools/explorer/) - Click on the `Graph API Explorer`dropdown menu at the top right and select your newly created app (called `Data Platform Connector` on the following screenshot). ![How to validate your Facebook app — Facebook dev10](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev10.png) - Now click on the `Get token` button and select `Get User Access Token` from the dropdown menu. ![How to validate your Facebook app — Facebook dev11](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev11.png) - In the window that just popped up, select the different permissions you need **(don't forget to tick the `read_insights` option)** and click on the `Get Access Token` button. :::info Note: as stated above, you need to be logged in to Facebook with an account that has either **Admin** or **Analyst** access for this to work ::: ![How to validate your Facebook app — Facebook dev12](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev12.png) - Click on the `Continue as` button. ![How to validate your Facebook app — Facebook dev13](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev13.jpg) - Then on `OK` at the bottom right. ![How to validate your Facebook app — Facebook dev14](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev14.jpg) - You just generated a short-term access token. Copy it and paste it in your text editor alongside your App ID and App Secret. ![How to validate your Facebook app — Facebook dev15](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev15.png) - Now edit the following URL template by replacing **\{app\_id}**, **\{app\_secret}** and **\{access\_token}** with your values. > `https://graph.facebook.com/v2.12/oauth/access_token?grant_type=fb_exchange_token&client_id={app_id}&client_secret={app_secret}&fb_exchange_token={access_token}` ![How to validate your Facebook app — Facebook dev17](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev17.png) - Once done, paste your URL in your web browser. Copy the result and paste it in your text editor. ![How to validate your Facebook app — Facebook dev18](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev18.png) - Copy this new URL and replace **\{access token}** with the content of the `"access_token"` field from last step's result: > `https://graph.facebook.com/v2.12/me?access_token={access_token}` ![How to validate your Facebook app — Facebook dev19](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev19.png) - Once again, copy the result from last step in your text editor and replace the **\{account\_id}** and **\{access\_token}** with the **id** and **access\_token** fields from the previous steps in the following URL template: > `https://graph.facebook.com/v2.12/{account_id}/accounts?access_token={access_token}` ![How to validate your Facebook app — Facebook dev21](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_dev21.png) - One last time, paste the URL in your web browser. You can now save the information displayed on your screen to a .json document. ### Learn how to find your Facebook page ID #### Pre-requisites: page ID - You need to be the page's Admin to get this information. #### Procedure: page ID ##### Step 1. Log into your Facebook account that has Admin access to the page. ![Procedure: page ID — Facebook page id1](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_page_id1.png) ##### Step 2. Click on the three horizontal dots and select `Edit Page Info` in the dropdown menu. ![Procedure: page ID — Facebook page id2](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_page_id2.png) ##### Step 3. Click on `See All Information` at the bottom of the window that just popped up. ![Procedure: page ID — Facebook page id3](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_page_id3.png) ##### Step 4. Copy your Page ID from the very bottom of the page. ![Procedure: page ID — Facebook page id4](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/facebook_page_id4.png) ## Add a Facebook source on Data Platform ### Configuration screen overview Once you have found _Facebook_ in the **Data Platform store**, click on _Select_ and you will be able to see the configuration screen as shown below: ![FB2](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/FB2.png) ### Configuring your source #### Connect to Facebook When creating the source, you will be required to input the following information : - **Account**: your Facebook Page ID - **Access Token**: your Facebook Developer app token - **Source default schema**: you can use this field to add columns to your data, if necessary. Use the following syntax _\{"name":"value"}_, where _name_ is the name of your column and _value_ is the value to be filled in all rows. Once you add the above details click on _Connect_ to establish a connection with Facebook. #### Add the Accounts and Endpoints Before moving on, you have to add accounts and endpoints. - [Accounts](#how-to-add-an-account) are Facebook pages referenced by the Page ID - just like in the previous screen - which you want to get data from. - [Endpoints](#how-to-add-an-endpoint) are the **different types of data** about accounts that Data Platform will get using the Facebook API. Each endpoint corresponds to a final table, aggregating data for all selected _accounts_. ![FB3](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/FB3.png) :::info Data Platform will use the credentials given in the [Connect to Facebook](#connect-to-facebook) step to access the Facebook API but **you can overwrite the credentials** to have multiple accounts and endpoints in the same source. Simply add the different accounts to the Source after the [Connect to Facebook](#connect-to-facebook) step. ::: ##### How to add an account? To add an account, click on _Add an Account_. This will open the following window: ![FB4](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/FB4.png) By default, it is using the same credentials you wrote previously when establishing the connection, which you can overwrite here. The _account name_ is the internal display name. ##### How to add an Endpoint? On Data Platform, each registered endpoint will correspond to a data source object, which you will be able to [load](https://docs.ovhcloud.com/en/guides/public-cloud/data-platform/dpe-actions-load.md) into a distinct [table](https://docs.ovhcloud.com/en/guides/public-cloud/data-platform/lakehouse-manager-tables.md). To add an endpoint, click on _Add an Endpoint_. This will open the following window: ![FB5](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/FB5.png) Next, select the type of Endpoint you wish to add. The Data Platform team is always adding new types of Endpoints to the connectors. You can click on the scroll-down list under the _Type_ field to see the ones available. Most common ones are: - _page\_data_: general data about the page. - _day\_insights_: data about the page sorted by day. - _post\_insights_: data about the page's posts. Some types require you to add _Insights_ to the endpoint, which is just a way of telling the Data Platform platform which data to get. To add an insight, just start typing inside the Insight field and click _Enter_ to select the data insight you want. ![FB6](/images/public-cloud/data-platform/product/connectors/sources/connectors/facebook/picts/insight-endpoint.png) :::info Note that you can add more than one insight to the same endpoint. ::: To finish, click on the _Create_ button on the top right-hand corner. :::warning Don't forget to name your source before creating it. The technical name cannot be changed after creating the source and will be used when trying to open the source using the [Data Platform SDK](https://docs.ovhcloud.com/en/guides/public-cloud/data-platform/landing-page-developers-python-sdk.md). ::: ## Go further If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](https://www.ovhcloud.com/en-gb/professional-services/) to get a quote and ask our Professional Services experts for a custom analysis of your project. Ask questions, give your feedback and interact directly with the team building the Data Platform on the dedicated [Discord channel](https://discord.gg/ovhcloud). If you need support with your OVHcloud services, create a request in our [Help Centre](https://help.ovhcloud.com/csm?id=csm_get_help). Join our [community of users](https://community.ovhcloud.com/).