🤖 Facebook Groups Search Scraper

Facebook Groups Search Scraper is an Apify actor that discovers public Facebook groups by keyword (via DuckDuckGo) or from direct group links, then runs every group through an AI model to classify and score it. Instead of a flat list of names and member counts, you get an AI-enriched Facebook groups dataset: niche, category, audience type, a 0–100 quality score, spam-risk rating, and a one-line summary for each group — ready for lead generation, market research, and community targeting.

It combines a fast Facebook groups scraper with an LLM enrichment layer, so you can go from a raw keyword to a ranked, categorized shortlist of communities in a single run. Choose your provider — Claude (Anthropic), ChatGPT (OpenAI), Grok (xAI), or Gemini (Google) — via aiProvider. No login, no cookies, no manual browsing.

💡 No API key? The actor automatically falls back to a built-in heuristic scoring engine so runs never fail — you still get category, niche, audience, quality score, and spam risk, just derived from rules instead of the model.

---

✨ Why use this over a plain Facebook group scraper?

A normal Facebook group finder tells you a group exists. This actor tells you whether it's worth your time. Each row is enriched with AI so you can sort, filter, and prioritize thousands of groups automatically — turning a Facebook groups search tool into a community intelligence pipeline.

Related keywords this tool covers: facebook groups scraper, facebook group finder, facebook groups search, ai data enrichment, facebook group classifier, community research tool, facebook lead generation, group quality scoring, spam detection, audience targeting, facebook groups api alternative, social media data enrichment, niche discovery, LLM classification, and facebook group data extractor.

---

📤 What data you get

Each dataset row is a superset of standard group fields plus six AI-enrichment fields:

Field	Description	Example
query	Originating keyword or direct_urls	"bmw"
id	Facebook group ID when detected	"123456789012345"
name	Group name from the page title	"BMW Enthusiasts Worldwide"
url	Canonical Facebook group URL	"https://www.facebook.com/groups/bmwfans/"
profilePictureUri	Group image URL (if found)	"https://scontent.xx.fbcdn.net/…jpg"
visibility	Public / Private	"Public"
memberInfo	Member count text	"22,345 total members"
postFrequency	Activity derived from the About page	"5.2 posts a day"
type	Item type label	"Group"
viewerJoinState	Join availability	"CAN_JOIN"
niche	🎯 Short topic phrase (AI)	"BMW car enthusiasts"
category	🗂️ One of Business, Hobby, Local Community, Buy/Sell, Support, Education, Entertainment, Technology, Health, News, Other	"Hobby"
audienceType	👤 Typical member profile (AI)	"Car owners and enthusiasts"
qualityScore	⭐ Integer 0–100 (activity + size + legitimacy)	82
spamRisk	🛡️ low / medium / high	"low"
aiSummary	📝 One-sentence AI summary	"Active hobby community for BMW owners with 22k members."

Results stream into the Apify dataset in real time and export to JSON, CSV, or Excel.

---

🚀 Key features

• 🤖 AI classification (multi-provider) — cheap, fast per-group categorization and scoring with Claude, ChatGPT (OpenAI), Grok (xAI), or Gemini.
• 🧮 Heuristic fallback — no API key required; the run never crashes on the AI layer.
• ⭐ Quality scoring (0–100) — rank groups by size, activity, and legitimacy in one pass.
• 🛡️ Spam-risk detection — automatically flag low-value, promotional, or scammy groups.
• 🎯 Niche & audience tagging — filter thousands of groups down to your exact segment.
• 🔗 Dual input — keyword discovery + direct group URLs in a single run.
• 🌐 Smart proxy fallback — no proxy by default, auto-upgrades to datacenter then residential when blocked.
• 🚪 No login required — works from public About pages only.
• 📤 Export anywhere — JSON / CSV / Excel, or pull the dataset via the Apify API.

---

🔧 How to use — step by step

1. Sign in to Apify — create a free account if needed.
2. Open the actor — Actors → Facebook Groups Search Scraper.
3. Add inputs — put keywords (e.g. bmw, photography) and/or full group URLs into startUrls.
4. Set maxItems — how many groups to collect & enrich per keyword (1–500).
5. (Optional) Pick your AI provider — set aiProvider to claude, openai, grok, or gemini, then paste the matching key into aiApiKey. Leave blank for heuristic mode.
6. (Optional) Configure proxy — leave default for best compatibility.
7. Start the run — watch the log classify each group live (🏷️ Name → Category · ⭐ score · spam:level).
8. Review & export — open the Dataset tab and export or fetch via API.

---

🎯 Use cases

Use case	How enrichment helps
Lead generation	Rank groups by qualityScore, drop anything with spamRisk: high.
Market research	Group communities by category and niche to map a market.
Audience targeting	Filter by audienceType to find groups matching your persona.
Community management	Prioritize active, legitimate groups for brand presence.
Competitor tracking	Categorize communities around competitor keywords.
Data enrichment pipeline	Treat it as an AI-powered facebook groups API alternative for dashboards/ETL.

---

🧾 Input example

{
  "startUrls": [
    "bmw",
    "photography",
    "https://www.facebook.com/groups/1234567890/"
  ],
  "maxItems": 50,
  "aiProvider": "claude",
  "aiApiKey": "sk-ant-...",
  "aiModel": "claude-haiku-4-5-20251001",
  "proxyConfiguration": { "useApifyProxy": false }
}

Parameter	Type	Required	Description
startUrls	array	✅	Keywords and/or Facebook group URLs.
maxItems	integer	❌	Groups per keyword, 1–500 (default 100).
aiProvider	string	❌	AI backend: claude, openai, grok, or gemini. Blank → heuristics.
aiApiKey	string	❌	API key for the selected provider; blank → heuristics.
aiModel	string	❌	Optional model override for the chosen provider (defaults to a fast, cheap model).
proxyConfiguration	object	❌	Optional Apify Proxy settings.

📦 Output example (one dataset row)

{
  "query": "bmw",
  "id": "123456789012345",
  "name": "BMW Enthusiasts Worldwide",
  "url": "https://www.facebook.com/groups/bmwfans/",
  "profilePictureUri": "https://scontent.xx.fbcdn.net/…jpg",
  "visibility": "Public",
  "memberInfo": "22,345 total members",
  "postFrequency": "5.2 posts a day",
  "type": "Group",
  "viewerJoinState": "CAN_JOIN",
  "niche": "BMW car enthusiasts",
  "category": "Hobby",
  "audienceType": "Car owners and enthusiasts",
  "qualityScore": 82,
  "spamRisk": "low",
  "aiSummary": "Active hobby community for BMW owners with 22k members."
}

---

❓ FAQ

Do I need an AI API key?

No. Without a key the actor uses a deterministic heuristic scorer and still fills every AI field. Add a key and set aiProvider to switch on real LLM classification with Claude, ChatGPT (OpenAI), Grok (xAI), or Gemini.

Which model does it use?

Whichever provider you select via aiProvider. Each provider defaults to a cheap, fast model (e.g. claude-haiku-4-5-20251001 for Claude), ideal for high-volume classification, and you can override it with aiModel.

Do I need to log in to Facebook?

No. It only reads public group About pages — no cookies, no account.

Can it scrape group members or posts?

No. This is a group discovery + enrichment tool, not a members or posts extractor. It returns public group metadata plus AI tags.

How is qualityScore calculated?

In AI mode, the selected model weighs size, activity, and legitimacy. In heuristic mode, it's derived from member count, post frequency, visibility, and spam signals, clamped to 0–100.

What formats can I export?

JSON, CSV, and Excel from the dataset UI, or via the Apify API for automation.

Does it support proxies?

Yes. It starts without a proxy and auto-upgrades to datacenter, then residential if blocked. You can also supply your own Apify Proxy configuration.

---

⚖️ Ethical use

This actor collects only publicly accessible Facebook group metadata and does not access private or authenticated content. Respect applicable data-protection laws (GDPR, CCPA), platform terms, and use results responsibly.

---

🏁 Get started

Feed it your keywords, pick an AI provider and key (or don't), and get a ranked, categorized, spam-filtered dataset of Facebook communities — export to JSON/CSV/Excel or plug the dataset into your lead-gen and analytics pipelines today.