Facebook Groups Scraper

Scrape public Facebook group posts by group URL or group ID. The actor returns clean, MCP-friendly dataset records with post text, author details, publish time, engagement counts, media URLs, top-comment previews, provider source, and run telemetry.

What it extracts

• Group URL, group ID, and group slug
• Post ID and direct post URL
• Post text
• Author name, ID, and profile URL when available
• Published timestamp
• Reaction, comment, share, video-view, and engagement counts
• Image, thumbnail, and video URLs when available
• Top-comment previews when returned by the data source
• Cursor information in RUN_SUMMARY.nextCursors for resumable provider pagination

Data sources

This actor is designed for public Facebook group data.

1. ScrapeCreators provider API, using the actor owner's SCRAPECREATORS_API_KEY secret.
2. SociaVault provider API, using SOCIAVAULT_API_KEY or SOCIALVAULT_API_KEY.
3. Playwright browser fallback for public pages, optionally with a user-provided authorized Facebook cookie session.

Provider APIs currently return up to 3 posts per request and paginate with a cursor. Increase maxPagesPerGroup to collect more posts, and use RUN_SUMMARY.nextCursors to resume later.

Input

• groupUrls: Facebook group URLs such as https://www.facebook.com/groups/homemakingtips/.
• groupIds: Optional numeric group IDs.
• maxPosts: Maximum saved posts across all groups.
• maxPagesPerGroup: Provider pages per group.
• sortBy: RECENT_ACTIVITY, TOP_POSTS, CHRONOLOGICAL, or CHRONOLOGICAL_LISTINGS.
• dataSource: auto, provider, or browser.
• facebookCookies: Optional JSON cookie array or raw Cookie header for browser fallback only.
• includeRawData: Adds the raw source object to each row.

Output

Each dataset item is one Facebook group post. Run summaries are written to the default key-value store:

• RUN_SUMMARY: Full telemetry with counts, provider status codes, cursors, and stop reason.
• OUTPUT: Compact agent-friendly summary.

Limits and compliance

Closed, private, deleted, age-gated, or membership-only content may return no records. Use cookies only for Facebook accounts and group content you are authorized to access. The actor soft-fails with a summary instead of crashing when a group is unavailable or no public posts are found.

Pricing

Pay-per-event is configured at $0.004 per saved post plus a tiny actor-start event.