Facebook Groups Post Scraper

Collect hundreds to thousands of public Facebook group posts that contain your keyword. No Facebook login. No account. No API key. The actor scans public groups and returns only the posts whose text actually matches your keyword — with date and country filters.

---

Why This Actor?

Most Facebook scrapers force you to already know which group you want, and require a logged-in session. This actor finds matching posts across all public groups — and keeps only the ones whose text contains your keyword, so your dataset is relevant, not noise.

Feature	This Actor	Typical scrapers
Hundreds–thousands of posts per keyword	✅	❌
Keeps only posts whose text contains the keyword	✅	❌
No Facebook account / login	✅	❌
Date filtering on real post dates	✅	Partial
70 countries	✅	Partial

---

How It Works

1. You enter one or more keywords (and, optionally, a start date and country).
2. The actor scans public Facebook groups and collects candidate posts, scaling how deeply it scans to your Max posts target.
3. Each post is read and kept only if it has text, the keyword appears in that text (accent/case-insensitive), and — when a start date is set — its real publication date is on or after it.
4. Posts are de-duplicated by URL, and the run stops the moment it reaches your target.

No login, cookies, or browser automation are involved.

---

Input Parameters

Field	Required	Description
keywords	✅	Phrases to look for; only posts whose text contains the phrase are kept
maxPosts	❌	Target posts per keyword (1–3000, default 100). The actor scales scan depth to this target and stops once reached
countryCode	❌	Country bias — 70 supported (e.g. us, gb, it, br). Leave empty for global

---

Input Examples

Collect 1 000 gardening posts in the US:

{
    "keywords": ["gardening"],
    "maxPosts": 1000,
    "countryCode": "us"
}

---

Output Fields

One item per post.

Field	Type	Description
result_type	string	Always "post"
post_url	string	Canonical URL of the post
text	string	Full post text content
image_url	string	URL of the post's main image (if any)
author_name	string	Display name of the post author
author_id	string	Facebook author ID (pfbid)
date	string	Publication timestamp (ISO 8601)
reaction_count	integer	Total number of reactions
comment_count	integer	Total number of comments
share_count	integer	Total number of shares
group_name	string	Name of the group the post belongs to
group_url	string	URL of the parent group
group_id	string	Numeric group ID
processed_at	string	When this item was scraped (ISO 8601)

Example item

{
    "result_type": "post",
    "post_url": "https://www.facebook.com/groups/raisedbedgardening/posts/30238911095722702/",
    "text": "Hi everybody. My raised beds are suffering from a major issue this year…",
    "author_name": "Jane Doe",
    "date": "2025-05-15T14:02:11.000Z",
    "reaction_count": 42,
    "comment_count": 13,
    "share_count": 1,
    "group_name": "Raised Bed Gardening",
    "group_url": "https://www.facebook.com/groups/raisedbedgardening/",
    "group_id": "1156935537680311",
    "processed_at": "2026-06-05T22:51:00.000Z"
}

---

Notes

• maxPosts is a target and ceiling (max 3000). For niche keywords with few matching posts, the run may return fewer.
• Larger targets take longer, since the actor scans more deeply to find enough matching posts.

---

FAQ

Does this require a Facebook account or API key? No — no account, no login, no cookies, no API key.

Can I scrape private groups? No. Only posts in public groups are accessible.

Why might fewer posts come back than maxPosts? The keyword may simply be sparse across public groups. Widen the date range or try related keywords.

Does it work for non-English keywords? Yes — matching is accent- and case-insensitive across all languages.

---

Legal & Compliance

This actor only accesses publicly available Facebook group posts. It does not log in, bypass authentication, or access private data. Users are responsible for ensuring their use complies with applicable laws including GDPR, CCPA, and Facebook's Terms of Service.