Facebook Pages

Sync overview

The Facebook Pages source uses Facebook Graph API to read data from the Facebook social graph.

Output schema

This Source is capable of syncing the following core Streams:

The linked Facebook docs go into detail about the fields present on those streams.

Data type mapping

Integration Type

Airbyte Type

Notes

string

string

number

number

array

array

object

object

Features

Feature

Supported?(Yes/No)

Notes

Full Refresh Sync

Yes

Incremental Sync

No

Namespaces

No

Rate Limiting & Performance Considerations

Facebook heavily throttles API tokens generated from Facebook Apps by default, making it infeasible to use such a token for syncs with Airbyte. To be able to use this connector without your syncs taking days due to rate limiting follow the instructions in the Setup Guide below to access better rate limits.

See Facebook's documentation on rate limiting for more information on requesting a quota upgrade.

Getting started

Requirements

  • A Facebook Developer Account

  • A Facebook App

  • A Facebook API Page Access Token

  • A Facebook Page ID

Setup guide

Facebook Developer Account

Follow the Facebook Developer Account link to create new account.

Facebook App

If you don't have a Facebook App

Visit the Facebook Developers App hub and create an App and choose "Company" as the purpose of the app. Fill out the remaining fields to create your app, then follow along the "Connect a User Page" section.

Connect a User Page

Follow the Graph API Explorer link. 1. Choose your app at Facebook App field 2. Choose your Page at User or Page field 3. Add next permission:

  • pages_read_engagement

  • pages_read_user_content

  • pages_show_list

  • read_insights

    1. Click Generate Access Token and follow instructions.

After all the steps, it should look something like this

Now can copy your Access Token from Access Token field (This is a short live Page access token, if you need a long-lived Page access token, you can generate one from a long-lived User access token. Long-lived Page access token do not have an expiration date and only expire or are invalidated under certain conditions.)

Getting Page ID

You can easily get the page id from the page url. For example, if you have a page URL such as https://www.facebook.com/Test-1111111111, the ID would beTest-1111111111.

Changelog

Version

Date

Pull Request

Subject

0.1.0

2021-09-01

5158

Initial Release