Pricing

Rating

Developer

Actor stats

Categories

Share

Facebook Multi-Group Scraper

Extract posts from one or many Facebook groups with robust parsing and production-focused outputs.

What this Actor does

• Scrapes group feed posts from facebook.com/groups/...
• Supports single-group and multi-group runs
• Handles authenticated scraping using your Facebook cookies
• Returns structured post data including text, author, engagement, comments, and media
• Supports incremental sync (new_only / refresh_recent)
• Emits run-level quality and summary reports in Key-Value Store

Key features

• Multi-group input via groupUrls
• Per-group overrides (count, cursor, sortType, scrapeUntil)
• Output profiles:
  • compact
  • analytics (default)
  • full
• Comments modes:
  • top (fast)
  • full (paginated per-post, capped)
• Reaction breakdown (like, love, haha, wow, sad, angry, care, total) when available
• Keyword and engagement filters
• Incremental state with change detection
• Optional webhook notification on run finish
• Optional trend package output (GROUP_TRENDS)

Input quickstart

Minimum input:

{
"groupUrls":[
"https://www.facebook.com/groups/587038730202575"
]
}

Recommended input:

{
"cookie":[],
"groupUrls":[
"https://www.facebook.com/groups/587038730202575"
],
"count":50,
"sortType":"new_posts",
"scrapeUntil":"30 days",
"outputProfile":"analytics",
"commentsMode":"top",
"includeReactionBreakdown":true,
"incrementalMode":"new_only",
"maxGroupsConcurrency":1,
"minDelay":2,
"maxDelay":5,
"proxy":{
"useApifyProxy":true
}
}

Example output item

{
"createdAt":1771803255,
"url":"https://www.facebook.com/groups/587038730202575/permalink/1238452188394556/",
"user":{
"id":"100090654480820",
"name":"Sample User",
"url":"https://www.facebook.com/nwr.alhyah.952812"
},
"text":"...",
"attachments":[
{
"type":"album",
"images":[
{
"url":"https://...jpg",
"alt":"No photo description available."
}
]
}
],
"reactionCount":12,
"reactionBreakdown":{
"like":8,
"love":2,
"haha":0,
"wow":1,
"sad":0,
"angry":0,
"care":1,
"total":12
},
"commentCount":4,
"topComments":[],
"groupId":"587038730202575"
}

Key-Value Store outputs

• OUTPUT_SUMMARY
• RUN_QUALITY_REPORT
• GROUP_SUMMARIES
• INCREMENTAL_SYNC_REPORT (when incremental mode is enabled)
• GROUP_TRENDS (when emitTrends=true)
• Per-group cursor/state keys:
  • SCRAPE_STATE__<groupKey>
  • lastCursor__<groupKey>
  • POST_INDEX__<groupKey>

Best practices

• For private/member-only groups, provide valid cookies.
• Use proxy in same region as account cookies.
• Start with commentsMode="top" for speed.
• Enable commentsMode="full" only when needed.
• Keep maxGroupsConcurrency conservative (1) for stability.

Limitations

• No automated login solving or checkpoint bypass.
• Facebook UI and GraphQL responses can change and may require selector/parser updates.
• OCR provider integration is not wired yet; OCR modes degrade gracefully.

Legal

Use this Actor only on data you are authorized to access and in compliance with Facebook terms and applicable laws.