Facebook Page Graph API Actor

Fetches public Facebook Page profile info and/or recent posts with engagement metrics (likes, comments, shares) using Facebook's official Graph API.

⚠️ This actor does not scrape Facebook's website. It calls the official Graph API using a Page Access Token you provide, and only works for Pages you own or have been granted access to. This keeps usage compliant with Facebook's Terms of Service.

What it does

• Accepts one or more Facebook Page IDs / usernames
• Fetches profile fields: name, about, category, fan_count, followers_count, link, website
• Fetches recent posts: message, created_time, permalink_url, like/comment/share counts
• Handles pagination up to a configurable maxPosts limit
• Pushes structured results to the Apify dataset (exportable as JSON/CSV/Excel)

Requirements

You need:

1. A Facebook App registered at developers.facebook.com
2. A Page Access Token with the following permissions:
   • pages_read_engagement
   • pages_read_user_content
3. Admin access to the Page(s) you want to query (or the Page must have granted your app access)

Facebook access tokens expire — for long-running or scheduled actor runs, use a long-lived Page Access Token or set up a token refresh flow outside this actor.

Input

Field	Type	Description
pageIds	array	Page IDs or usernames to fetch
accessToken	string (secret)	Your Page Access Token
fetchProfileInfo	boolean	Fetch profile fields (default: true)
fetchPosts	boolean	Fetch recent posts (default: true)
maxPosts	integer	Max posts per page (default: 20)
graphApiVersion	string	Graph API version to call (default: v19.0)

Example input:

{
  "pageIds": ["mypage"],
  "accessToken": "EAAxxxxxYOURTOKENxxxxx",
  "fetchProfileInfo": true,
  "fetchPosts": true,
  "maxPosts": 50,
  "graphApiVersion": "v19.0"
}

Output

Each Page produces one dataset item:

{
  "page_id": "mypage",
  "profile": {
    "id": "1234567890",
    "name": "My Page",
    "about": "...",
    "fan_count": 10234,
    "followers_count": 10500
  },
  "posts": [
    {
      "id": "1234567890_9876543210",
      "message": "Post text...",
      "created_time": "2026-07-20T10:00:00+0000",
      "permalink_url": "https://facebook.com/...",
      "likes_count": 120,
      "comments_count": 15,
      "shares_count": 4
    }
  ]
}

If a Page fails (invalid token, insufficient permissions, rate limit), the item will contain an error field instead.

Notes

• Rate limits are governed by Facebook's Graph API usage tiers — see the Graph API rate limiting docs
• Token expiration and permission errors will show up as error entries in the dataset per-page, not as a hard actor failure