Facebook Reviews Scraper

Scrape Facebook business page reviews by direct URL, business name search, or Facebook Page ID — no login or cookies required. Returns full review data including review text, Recommended/Not Recommended status, author details, reaction breakdowns, structured recommendation tags, business owner replies, and page-level aggregate stats like follower count and overall recommendation percentage.

What This Actor Does

• Scrapes reviews from any public Facebook business page — restaurants, hotels, retailers, airlines, and services
• Three input modes: paste a /reviews URL, search by business name + city, or supply a numeric Facebook Page ID
• Filters results by date range, recommendation status (Recommended / Not Recommended), or keyword in the review text
• Extracts review photos, structured recommendation tags (e.g. "Outdoor dining", "Fast delivery"), reaction breakdowns (Like/Love/Wow/Haha/Sad/Angry/Care counts), and top comments including business/owner replies
• Returns page-level aggregate stats — total review count, recommendation percentage, and follower count
• Handles Facebook's bot detection automatically via a residential proxy — no configuration needed, no separate proxy subscription
• Empty/unavailable fields are omitted from each record rather than returned as null

Output

One record per review. Fields are only present when Facebook actually has that data — see the FAQ for why some fields (like reviewPhotos) are frequently absent.

Field	Example
reviewId	"UzpfSTEwMDAy..."
text	"Amazing food and great service!"
isRecommended	true
reviewTags	["Outdoor dining", "Fast delivery"]
createdAt	"2024-03-15T10:22:00+00:00"
timestamp	1710498120
authorName	"Julia Odan"
authorProfileUrl	"https://www.facebook.com/julia.odan"
authorIdType	"pfbid" or "numeric" — see FAQ
reactionCount	3
reactionBreakdown	[{"type": "Like", "count": 4}, {"type": "Haha", "count": 1}]
shareCount	0
reviewPhotos	["https://scontent.fbcdn.net/..."]
topComments	[{"authorName": "McDonald's", "text": "Thanks for the feedback!", "isOwnerReply": true, "authorIdType": "numeric", "commentPermalinkUrl": "https://facebook.com/...", "replyCount": 2}]
reviewUrl	"https://www.facebook.com/.../posts/..."
page.name	"McDonald's"
page.id	"100064458773195"
page.totalReviewCount	4821
page.recommendationPercentage	87
page.followerCount	82000000
recordType	"review"
scrapedAt	"2026-09-02T12:00:00+00:00"

Input

Field	Type	Default	Description
mode	string	url	url / search / pageId — how to specify the Facebook page
startUrls	array	[{"url": "https://www.facebook.com/mcdonalds/reviews"}]	Direct /reviews page URLs (mode=url)
searchQueries	array	–	Business name + location, e.g. "Starbucks Dallas TX" (mode=search)
pageIds	array	–	Numeric Facebook Page IDs, e.g. "100064458773195" (mode=pageId)
maxReviews	integer	100	Maximum total reviews across all input pages (1–500)
maxReviewsPerPage	integer	–	Cap per individual page, for an even spread across multiple pages (1–500)
sortBy	string	most_recent	most_recent or most_helpful (best-effort — see FAQ)
filterByRecommendation	string	all	all / recommended / not_recommended
filterByDateFrom	string	–	Only reviews on or after this date (YYYY-MM-DD)
filterByDateTo	string	–	Only reviews on or before this date (YYYY-MM-DD)
filterByKeyword	string	–	Only reviews containing this word or phrase (case-insensitive)
cookies	array	–	Optional logged-in session cookies to unlock more than ~10-15 reviews per page
proxyCountry	string	US	Proxy exit country: US / GB / CA / AU / IE

Example: scrape reviews from a direct URL

{
  "mode": "url",
  "startUrls": [{ "url": "https://www.facebook.com/mcdonalds/reviews" }],
  "maxReviews": 100
}

Example: find a business by name and city

{
  "mode": "search",
  "searchQueries": ["Starbucks Seattle WA"],
  "maxReviews": 50
}

Example: only negative reviews from the last 90 days

{
  "mode": "url",
  "startUrls": [{ "url": "https://www.facebook.com/IHOP/reviews" }],
  "filterByRecommendation": "not_recommended",
  "filterByDateFrom": "2026-06-01",
  "maxReviews": 100
}

Example: multiple pages by numeric Page ID, capped per page

{
  "mode": "pageId",
  "pageIds": ["100064458773195", "100044057870366"],
  "maxReviewsPerPage": 25,
  "maxReviews": 50
}

Use Cases

• Reputation monitoring — track new Recommended/Not Recommended reviews and business owner replies for a brand or franchise location
• Competitor analysis — compare recommendation percentages, review volume, and recurring complaint keywords across competing businesses
• Local business research — pull reviews for restaurants, hotels, or service providers before choosing where to eat, stay, or book
• Customer feedback analysis — export review text and recommendation tags (e.g. "Fast delivery", "Disappointing food") for sentiment or NLP pipelines
• Franchise/multi-location tracking — scrape reviews across many location-specific Page IDs in a single run to compare performance
• Market research — measure follower counts and recommendation trends across an industry vertical

FAQ

Does this require a Facebook account or cookies? No. The actor scrapes publicly visible reviews on public business pages without logging in. Cookies are an optional input for unlocking more than the ~10-15 reviews per page that Facebook shows to logged-out visitors.

Is this an official Facebook or Meta product? No. This is an independent, third-party actor that reads publicly available Facebook business page data. It is not affiliated with, endorsed by, or connected to Meta Platforms, Inc.

Why does Facebook use Recommended/Not Recommended instead of star ratings? Facebook replaced 1-5 star reviews with a binary Recommended/Not Recommended system in 2018. There is no per-review star rating. Facebook does still show a page-level aggregate percentage (page.recommendationPercentage), but that number is computed from an undisclosed blend of legacy star reviews and newer recommendations — it can look inconsistent with a simple count of the reviews returned here. Treat isRecommended (per review) as the reliable ground truth, not the page-level percentage.

Can I get the business's replies to reviews? Yes. When a business replies to a review, that reply appears inside topComments with isOwnerReply: true, identified by matching the replier's account to the page itself — not just by display name, so it stays accurate even if the business renames its page.

How many reviews can I get per page? Up to 500 reviews per page in a single run. Without cookies, Facebook typically stops serving new content to one unauthenticated session well before that (commonly in the 5-15 review range per page) — this is a Facebook-side limit, not a scraper failure; the run's status message notes it when it happens. Supply cookies for a logged-in session to raise this ceiling.

Do I need to configure a proxy? No. A residential proxy is required for reliable access to Facebook and is handled automatically — there's no separate proxy subscription or setup step. proxyCountry only controls which country the (already-included) proxy exits from.

Will search mode always find the right business? Facebook's own on-site search requires a login for automated visitors, so search mode resolves your query through an external web search instead. For distinctive business names this generally finds the correct page, but ambiguous queries (a common name with no location) can occasionally return an incorrect or no match. For a guaranteed exact match, use url or pageId mode instead.

Does "Most Helpful" sort actually work? It's attempted on a best-effort basis. Facebook's current review pages don't consistently expose a visible sort control the way they used to — when the control isn't found, the actor logs it and falls back to the page's default order rather than failing the run.

What is authorIdType? Facebook identifies most regular reviewers with a rotating pfbid token rather than a permanent numeric ID, meaning the same person isn't always reliably trackable as "the same reviewer" across separate runs. Business/Page accounts (e.g. a company replying to its own reviews) do get a stable numeric ID. authorIdType tells you which kind of identifier you got ("pfbid" or "numeric").

What happens if a page has no reviews or can't be reached? A record with "recordType": "error" and a description is pushed instead of the run failing or crashing.

Are review photo URLs permanent? Facebook CDN URLs can expire after some time — use the scrapedAt timestamp to track freshness. In practice most reviews are text-only or carry a recommendation tag rather than a photo, so reviewPhotos is frequently absent — that reflects real review behavior, not a gap in the scraper.

Can this scrape a business's About info (address, phone, hours, category)? No, that data lives on a different page (the business's main/About tab, not the reviews tab) and is out of scope for this actor. Pair it with a dedicated Facebook Page scraper if you need that data alongside reviews.

Limitations

• 500 review cap per page — beyond that, Facebook's own pagination becomes unreliable
• Public pages only — private groups, personal profiles, and Marketplace listings are not supported
• Sort control is inconsistently available — most_helpful is best-effort and silently falls back to default order when Facebook doesn't expose the control
• Search mode resolves via external web search, not Facebook's own search — most reliable for distinctive business names
• Reviewer identity isn't always a stable ID — see authorIdType in the FAQ
• Business "About" details are out of scope — see the FAQ
• A small number of individual pages are more heavily protected than others — most business pages work reliably, but occasionally a specific page (regardless of how popular the business is) may be blocked more consistently than average; this reflects that page's own bot-defense configuration, not a general reliability gap