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.