Facebook Pages, Reviews & Comments

An all-in-one Facebook collector that returns page info, reviews (recommendations), and comments in one unified, GDPR-aware schema — from either the official Facebook Graph API (for pages you own or manage) or a delegated Store scraper (for public pages).

This Actor is an intelligence layer, not another raw scraper: it normalizes, de-duplicates, and (optionally) anonymizes data from two very different sources into a single clean shape your app or BI tools can consume directly.

Two backends, two risk profiles

Backend	Use for	How it works	Compliance
Graph API (graph)	Pages your users own/manage	Official GET /{page}/ratings and /{object}/comments with a Page access token (pages_read_user_content) obtained via OAuth	ToS-compliant, reliable, no proxies
Delegated scraper (scrape)	Public pages you don't manage	Forwards your input to a maintained Store scraper via Actor.call, then normalizes its output	You choose the scraper and accept responsibility for scraping public data

For a SaaS, the Graph API path is strongly preferred: your customer connects their own Facebook Page, and you read their data with their consent. It doesn't break when Facebook changes its frontend, needs no residential proxies, and sidesteps the Terms-of-Service and CFAA-style exposure that comes with scraping logged-in or public data you weren't authorized to collect.

Input

{
    "backend": "graph",
    "pages": ["123456789012345"],
    "collectPageInfo": true,
    "collectReviews": true,
    "collectComments": false,
    "graphAccessToken": "<page-access-token>",
    "anonymizeReviewers": false,
    "maxItemsPerTarget": 100
}

Delegated-scraper example:

{
    "backend": "scrape",
    "scraperActorId": "apify/facebook-reviews-scraper",
    "scraperInput": { "startUrls": [{ "url": "https://www.facebook.com/SomePublicPage/reviews" }] },
    "scrapeItemType": "review",
    "anonymizeReviewers": true
}

Key fields: backend, pages, postUrls (object IDs for comments), collectPageInfo/Reviews/Comments, graphAccessToken (secret), graphApiVersion, scraperActorId + scraperInput, maxItemsPerTarget, and anonymizeReviewers.

Output

One unified item per page / review / comment. Note that modern Facebook reviews are positive/negative recommendations, not 1–5 stars — recommendation is the primary field; rating is legacy and usually null.

{
    "type": "review",
    "backend": "graph",
    "pageId": "123456789012345",
    "recommendation": "positive",
    "rating": null,
    "text": "Excellent service, highly recommend.",
    "createdAt": "2026-01-01T00:00:00+0000",
    "reviewerName": "Jane D.",
    "likes": null,
    "permalink": null
}

Privacy & GDPR

Reviews and comments contain personal data. Set anonymizeReviewers: true to hash reviewer/commenter names and drop their profile IDs when you don't have a lawful basis to store identifiers. You remain the data controller for anything this Actor outputs; document your lawful basis and retention policy.

Running locally

npm install
apify run        # reads storage/key_value_stores/default/INPUT.json

Deploy with apify push.

Acceptable use

The Graph API backend accesses only data the authorizing Page owner has granted via OAuth. The delegated-scraper backend runs a separate Actor of your choosing; automated access to Facebook is restricted by Facebook's Terms of Service, and you are responsible for ensuring your use of any scraper complies with those terms, applicable law (including GDPR/CCPA), and copyright. This Actor does not bypass authentication, manage Facebook credentials, or use fake accounts.