Facebook Reviews Scraper

Scrape public Facebook business page reviews by direct URL, business name search, or Facebook Page ID. Returns full review data including author details, recommendation status, photos, reaction counts, and page-level aggregate statistics.

What This Actor Does

• Scrape reviews from any public Facebook business page — restaurants, hotels, retailers, services
• Three input modes: paste a /reviews URL, search by business name + city, or supply a numeric Page ID
• Filter results by date range, recommendation status (Recommended / Not Recommended), or keyword in review text
• Choose sort order: Most Recent or Most Helpful
• Extracts review photos, top comments, author review count, and page aggregate stats
• Handles Facebook's bot detection using Playwright stealth + Apify residential proxy

Input

Field	Description	Default
mode	url / search / pageId	url
startUrls	Direct /reviews page URLs	—
searchQueries	Business name + location (e.g. "Starbucks Dallas TX")	—
pageIds	Numeric Facebook Page IDs	—
maxReviews	Max reviews per page (1–500)	100
sortBy	most_recent or most_helpful	most_recent
filterByRecommendation	all / recommended / not_recommended	all
filterByDateFrom	Only reviews on or after this date (YYYY-MM-DD)	—
filterByDateTo	Only reviews on or before this date (YYYY-MM-DD)	—
filterByKeyword	Only reviews containing this word/phrase	—

Output

One record per review. Fields only present when data is available.

Field	Example
reviewId	"UzpfSTEwMDAy..."
text	"Amazing food and great service!"
isRecommended	true
createdAt	"2024-03-15T10:22:00+00:00"
authorName	"Julia Odan"
authorReviewCount	14
reactionCount	3
reviewPhotos	["https://scontent.fbcdn.net/..."]
topComments	[{"authorName": "Bob", "text": "Agree!"}]
page.name	"McDonald's"
page.totalReviewCount	4821
page.recommendationPercentage	87

FAQ

Does this require a Facebook account or cookies? No. The actor scrapes publicly visible reviews on public business pages without login.

Why does Facebook use Recommended/Not Recommended instead of star ratings? Facebook changed its review system to a binary recommendation model in 2018. There are no 1–5 star ratings.

How many reviews can I get per page? Up to 500 reviews per page. Facebook's pagination becomes unreliable beyond this volume.

Why is a residential proxy required? Facebook aggressively detects and blocks datacenter IP addresses. Residential proxies provide real-user IP addresses that avoid detection. This is handled automatically by the actor using Apify's proxy infrastructure.

Will search mode always find the right business? For common business names (e.g. "McDonald's"), the top result is usually correct. For precision, use url or pageId mode.

What if a page has no reviews? An error record is pushed with "recordType": "error" and a description. No crash.

Are review photo URLs permanent? Facebook CDN URLs expire after some time. Use the scrapedAt timestamp to track freshness.

Limitations

• 500 review cap per page — scraping beyond 500 is unreliable and costly
• Public pages only — private groups, user profiles, and Marketplace are not supported
• Sort selector targets English UI — most_helpful sort may not work on non-English Facebook interfaces
• Search mode is best-effort — ambiguous queries may return incorrect page matches