# Facebook Group Posts Scraper (`valev-lab/facebook-groups-scraper`) Actor

Scrape public Facebook group posts without login or cookies. Extract text, author, date, reactions, comment counts, and the group name. Filter by keyword or date, or keep only new posts. From $1.20 per 1,000 posts.

- **URL**: https://apify.com/valev-lab/facebook-groups-scraper.md
- **Developed by:** [Daniel Valev](https://apify.com/valev-lab) (community)
- **Categories:** Social media, Marketing, Lead generation
- **Features:** Limited permissions
- **Stats:** 14 total users, 7 monthly users, 79.2% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 post saveds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

Scrape posts from **public** [Facebook groups](https://www.facebook.com/groups/) without a Facebook account. Get the **post text**, **author**, **date**, **reactions**, **comment count**, and **group name** in a spreadsheet-ready row. **No login, no cookies, and no browser.**

An untouched run is a small sample: **5 posts** from `https://www.facebook.com/groups/selftaughtprogrammers`. The form shows 100 because that is the schema default, and that exact default is rewritten to 5. Set **Max posts per group** to any other number (20, 50, 200, …) for a real cap. To save 100 posts, set both **Max posts per group** and **Max posts in the run** to 100.

### What does Facebook Group Posts Scraper do?

This Actor reads the public group feed and returns **one row per post**. Use it as a **Facebook Groups API alternative** for social listening, community research, and brand monitoring when you do not have a Facebook developer app.

Paste a group URL, a numeric id, or a slug. You can mix several groups in one run; the same group is read once. Optional filters keep only a date window, a keyword, or posts above a reaction or comment minimum. Monitoring mode remembers what you already saved and returns later posts.

### Who is it for?

- **Marketers** — Watch public communities for product mentions and campaign language.
- **Researchers** — Export a dated timeline of what a public group is talking about.
- **Community managers** — See which posts draw reactions and comments.
- **Analysts** — Build a repeatable dataset of public posts for reporting.

### Why scrape public Facebook groups?

- **No Facebook account** — Nothing to log into, and no cookies to paste.
- **No official API setup** — Skip app review and token rotation.
- **Structured export** — The same fields on every row, ready for Google Sheets, Excel, or a database.
- **Filters before you pay for a row** — Date skips are free. Keyword and engagement misses cost less than a saved post.
- **Only new posts** — Schedule a run and skip posts this Actor already delivered.
- **Latin and Cyrillic search** — `apartament` matches `апартамент`, and `kvartira` matches `квартира`.
- **Apify platform** — Schedule runs, call the API, and connect Zapier, Make, or n8n.

### What data can you extract?

| Field | Description |
| --- | --- |
| `url` | Link to the post, when Facebook sent one |
| `text` | Post text. A reshare with no caption falls back to the original text |
| `time` | Creation time. `null` when Facebook did not send one — never a fake date |
| `user.name` | Author name shown on the public post |
| `groupTitle` / `groupUrl` | Group name and canonical group link |
| `reactionsCount` / `commentsCount` / `sharesCount` | Engagement counts from the feed |
| `topComments` | Up to five comment texts already shown on the feed post |
| `postType` | `text`, `photo`, `video`, `listing`, or `unknown` |
| `attachedStoryText` | Original text of a reshare, when it differs from the caption |

Missing Facebook values stay `null`. The **Dataset** tab shows the full row. The default table is **Posts**: URL, time, group, author, text, reactions, and comments.

### How to scrape Facebook group posts

1. Open **Facebook Group Posts Scraper** and click **Try for free** or **Start**.
2. Paste one or more public group URLs, such as `https://www.facebook.com/groups/selftaughtprogrammers`. A numeric id or a slug also works.
3. Set **Max posts per group** to the number you want. Leave the untouched default only when you want the 5-post sample.
4. Optionally set a date window, a search phrase, or **Only new posts**.
5. Click **Start** and wait for the run to finish.
6. Download **JSON, CSV, Excel, or HTML**, or send the dataset to an integration.

No coding is required for a Console run. Developers can use the **API** tab or `apify call`.

### How much does it cost to scrape Facebook groups?

Pricing is [pay-per-event](https://docs.apify.com/platform/actors/running/pay-per-event). You pay for posts you save. There is no monthly minimum from this Actor.

| Event | Price | When |
| --- | ---: | --- |
| `post` | **$0.0012** ($1.20 / 1,000) | A post was saved |
| `filter-check` | $0.0003 | A post was read and dropped by search, keywords, or a minimum reaction/comment count |
| `seen-check` | $0.0002 | Monitoring recognized a post that was already delivered |
| `apify-actor-start` | $0.00005 | Once per run. Keep Apify's default |

**Example:** 100 saved posts ≈ `100 × $0.0012 = $0.12`, plus the tiny start event. A filter check and a seen check are charges only. Those posts are not saved.

Posts outside your date window are free. A blocked or private group is not charged. Comment text that was already on the feed post is included in `post` and is not a separate charge.

Platform usage (compute and proxy) stays inside these prices. In Console, leave **Pay per event + usage** off. Do not also enable `apify-default-dataset-item`, or each saved post is charged twice.

> Set the same numbers under **Publishing → Monetization** before you publish. If you add volume discounts later, update this table to match.

### Input

See the **Input** tab for the full form.

| Field | Default | Notes |
| --- | --- | --- |
| Group URLs | sample group | Public group URL, id, slug, post link, or `/groups/…/search/?q=`. Links that are not groups are skipped with a note. With no group at all, the run reads 5 posts from the sample group |
| Group ids or slugs | empty | Used when you do not have a full URL |
| Max posts per group | `100` in the form | Untouched `100` saves **5** posts. Any other number is that exact cap. `0` means no per-group cap |
| Max posts in the run | `0` | Cap across every group. `0` means no run-level cap |
| Feed order | Newest first | Also recent activity, top posts, or newest listings |
| Newer than / Older than | empty | `YYYY-MM-DD`, an ISO time, or a phrase such as `12 hours`, `30 days`, `3 months`, or `1 year`. Other formats are rejected before the run starts |
| Search | empty | All words must appear. A quoted phrase must appear as written |
| Exclude keywords | empty | Drop a post when any of these words appear |
| Match Latin and Cyrillic | on | Bulgarian transliteration for the search |
| Minimum reactions / comments | `0` | `0` keeps every post |
| Only new posts | off | Skip posts already delivered for this state key |
| Proxy | Apify proxy on | Direct first. Your proxy URLs, or Apify Residential, only after a login wall |

A group search URL (`/groups/<id>/search/?q=...`) fills the search from the link.

### Output

You can download the dataset as **JSON, CSV, Excel, HTML**, or XML. Example row:

```json
{
  "id": "1234567890123456",
  "url": "https://www.facebook.com/groups/selftaughtprogrammers/posts/1234567890123456",
  "groupId": "387875758242831",
  "groupTitle": "Self-Taught Programmers",
  "groupUrl": "https://www.facebook.com/groups/selftaughtprogrammers",
  "text": "What project did you finish this week?",
  "time": "2026-10-06T17:32:21.000Z",
  "timeSource": "story",
  "user": { "id": "100000000000000", "name": "Alex Rivera", "url": null },
  "reactionsCount": 12,
  "commentsCount": 4,
  "sharesCount": 0,
  "topComments": [{ "text": "A small CLI for my notes." }],
  "postType": "text",
  "scrapedAt": "2026-10-22T08:43:41.000Z"
}
```

The `SUMMARY` record in the run’s key-value store says how many posts were saved, why each group stopped, and whether the run reached its target.

A run can stop with partial results if proxy traffic becomes too expensive (`cost-limit`) or ten consecutive feed pages produce no matching posts (`low-yield`). Saved posts remain available. Try fewer groups or broader filters. Blocked groups get at most two proxy sessions before stopping.

### Tips for better runs

- Start with 20–50 posts while you check the filters, then raise the cap.
- Set **Max posts in the run** as well as **Max posts per group** when you want an exact total. The form default of 100 alone is the 5-post sample.
- Use **Newer than** `7 days` for a weekly digest. Posts that are too old are not charged.
- Turn on **Only new posts** and schedule the Actor. Already-seen posts cost a `seen-check`, not a full post.
- For a buy-and-sell group, search in the language of the posts. Latin and Cyrillic matching is on by default.
- Leave proxy settings alone unless you have your own proxy URLs. The run tries a direct request first and uses a proxy only after Facebook asks for a login.

### Limitations

- **Public groups only.** A private, deleted, or misspelled group finishes with a status that says so and is not billed as posts. Facebook shows such a group the same login page as a block, so the run then checks that a known public group still opens. The run fails only when that check is blocked too.
- **This version does not** download full comment threads, expand photo albums, parse listing price and location, or extract phone numbers and emails. Those switches are not in the form. If an older task or API call still sends them, they are ignored with a note and the posts are delivered. Up to five comments already visible on the feed post are included.
- The public feed only goes back so far. A date far in the past can stop with `seek-too-deep` instead of reading the whole history.
- Groups are read one after another.

### FAQ

#### Is this a Facebook Groups API?

It is an **API alternative**. You get structured public posts through Apify (Console, REST, or an integration) without a Facebook developer app. It is not Meta’s official Graph API.

#### Do I need a Facebook account or cookies?

No. The Actor reads what a logged-out visitor can see.

#### Can I scrape private Facebook groups?

No. If Facebook requires a login, that group is reported as blocked and no posts from it are charged.

#### How do I scrape only new Facebook group posts?

Turn on **Only new posts**. The next run skips posts already saved for that state key. Schedule it daily or weekly from the Apify Console.

#### How do I search inside a Facebook group?

Type the words in **Search**, or paste a group search URL that already contains `?q=`. A quoted phrase must appear as written. Words can appear in any order.

#### Why did my run save only 5 posts?

The untouched form default is a health check. Set **Max posts per group** to a number other than 100. To save exactly 100, set **Max posts in the run** to 100 as well.

#### What if a group returns nothing?

Open the same URL in a private browser window. If you see a login wall, the group is not public. If the group is public and the date or keyword filter is tight, widen it. The `SUMMARY` record names the stop reason.

### Legal and ethics

> This Actor only collects posts that are visible on a public Facebook group without logging in. It does not extract private profile data such as personal emails, gender, or private location, and it does not collect phone numbers. Results can still include names and text that people posted publicly. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you are unsure whether your reason is legitimate, consult your lawyers. Respect Facebook’s terms and the group’s own rules.

### Support

- Use the **Issues** tab on this Actor’s Store page for bugs and feature requests.
- Use the **API** tab for programmatic runs, webhooks, and dataset access.
- Built for scheduled monitoring of public groups on the Apify platform.

# Actor input Schema

## `startUrls` (type: `array`):

Public group URLs. Slugs, numeric ids, m. and web. hosts, a post permalink (the whole group is read), and a group search URL (/groups/<id>/search/?q=...) are accepted. Share links (facebook.com/share/g/...) are followed. Leave Group URLs and Group ids both empty to read 5 posts from a demo group.

## `groupIds` (type: `array`):

Numeric group ids or slugs, used when you do not have a full URL. Duplicates of startUrls are read once.

## `maxItems` (type: `integer`):

Posts saved per group. 0 means no cap. The form default 100 is the health-check sentinel: an untouched run saves 5 posts. Set 20, 50, 200, or any value other than 100 for that exact cap.

## `maxItemsTotal` (type: `integer`):

Cap across every group. 0 means no run-level cap. Each saved post still has to fit maxItems for its group.

## `viewOption` (type: `string`):

Order requested from the group feed.

## `postsPerRequest` (type: `integer`):

Asked from Facebook on each feed page. Facebook still returns a handful of posts; raising this does not make the run faster.

## `onlyPostsNewerThan` (type: `string`):

Keep posts at or after this time. YYYY-MM-DD, an ISO timestamp, or a phrase such as 12 hours, 30 days, 2 weeks, 3 months, or 1 year. The lower bound is inclusive. Pagination stops after 3 posts in a row that are older.

## `onlyPostsNewerThanHours` (type: `integer`):

How many hours back to keep. When set, this overrides Newer than.

## `onlyPostsOlderThan` (type: `string`):

Upper bound, exclusive. Same formats as Newer than. Posts newer than this are skipped for free while the run seeks backward, up to Max seek pages.

## `maxSeekPages` (type: `integer`):

How many feed pages may be skipped while seeking back to Older than. The run stops with seek-too-deep instead of reading the whole history.

## `search` (type: `string`):

All words must appear, in any order. A quoted phrase must appear as written. Posts that do not match are billed as filter-check, not as a saved post.

## `excludeKeywords` (type: `array`):

Drop a post when any of these words appear in its text. Matching is case and accent insensitive.

## `transliterateSearch` (type: `boolean`):

Also match Bulgarian transliteration, so apartament matches апартамент and kvartira matches квартира.

## `minReactions` (type: `integer`):

Drop posts with fewer reactions. 0 keeps every post. A missing count does not pass a minimum above 0.

## `minComments` (type: `integer`):

Drop posts with fewer comments. 0 keeps every post.

## `monitoringMode` (type: `boolean`):

Save posts this state key has not delivered before. Already-seen posts are billed as seen-check. In newest-first order the group stops after 3 seen posts in a row, so pinned posts do not end the run.

## `stateKey` (type: `string`):

Memory key for monitoring, up to 80 characters. Leave empty to derive one from the group list.

## `resetState` (type: `boolean`):

Forget posts already delivered under this state key, then start again.

## `refreshWindowDays` (type: `integer`):

In monitoring mode, deliver an already-seen post again when it is younger than this many days, so engagement can update. Billed as a normal post. 0 turns it off.

## `knownPostIds` (type: `array`):

Stop the group when one of these ids appears. That post is not billed. Use this when you keep your own memory outside the Actor.

## `resumeFromLastRun` (type: `boolean`):

Continue each group from the cursor saved by the previous run. The cursor is saved on every run, even when this is off.

## `resumeCursor` (type: `string`):

Advanced. A single cursor, used only when the run has one group. Overrides the saved cursor.

## `proxyCountry` (type: `string`):

Two-letter country for the proxy, used only after a direct request is blocked. Examples: US, BG, RO, GR, RS.

## `proxyConfiguration` (type: `object`):

Requests go out directly first. After a login wall, your proxy URLs are used when present (including the CUSTOM_PROXY_URLS secret). Otherwise Apify Residential is used. Turn useApifyProxy off to stay direct and stop at the wall.

## `debugLog` (type: `boolean`):

Log how many posts each feed page returned. Request bodies are not logged.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.facebook.com/groups/selftaughtprogrammers"
    }
  ],
  "groupIds": [],
  "maxItems": 100,
  "maxItemsTotal": 0,
  "viewOption": "CHRONOLOGICAL",
  "postsPerRequest": 3,
  "maxSeekPages": 300,
  "excludeKeywords": [],
  "transliterateSearch": true,
  "minReactions": 0,
  "minComments": 0,
  "monitoringMode": false,
  "resetState": false,
  "refreshWindowDays": 0,
  "knownPostIds": [],
  "resumeFromLastRun": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "debugLog": false
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.facebook.com/groups/selftaughtprogrammers"
        }
    ],
    "groupIds": [],
    "maxItems": 100,
    "maxItemsTotal": 0,
    "viewOption": "CHRONOLOGICAL",
    "postsPerRequest": 3,
    "maxSeekPages": 300,
    "excludeKeywords": [],
    "transliterateSearch": true,
    "minReactions": 0,
    "minComments": 0,
    "monitoringMode": false,
    "resetState": false,
    "refreshWindowDays": 0,
    "knownPostIds": [],
    "resumeFromLastRun": false,
    "proxyConfiguration": {
        "useApifyProxy": true
    },
    "debugLog": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("valev-lab/facebook-groups-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://www.facebook.com/groups/selftaughtprogrammers" }],
    "groupIds": [],
    "maxItems": 100,
    "maxItemsTotal": 0,
    "viewOption": "CHRONOLOGICAL",
    "postsPerRequest": 3,
    "maxSeekPages": 300,
    "excludeKeywords": [],
    "transliterateSearch": True,
    "minReactions": 0,
    "minComments": 0,
    "monitoringMode": False,
    "resetState": False,
    "refreshWindowDays": 0,
    "knownPostIds": [],
    "resumeFromLastRun": False,
    "proxyConfiguration": { "useApifyProxy": True },
    "debugLog": False,
}

# Run the Actor and wait for it to finish
run = client.actor("valev-lab/facebook-groups-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.facebook.com/groups/selftaughtprogrammers"
    }
  ],
  "groupIds": [],
  "maxItems": 100,
  "maxItemsTotal": 0,
  "viewOption": "CHRONOLOGICAL",
  "postsPerRequest": 3,
  "maxSeekPages": 300,
  "excludeKeywords": [],
  "transliterateSearch": true,
  "minReactions": 0,
  "minComments": 0,
  "monitoringMode": false,
  "resetState": false,
  "refreshWindowDays": 0,
  "knownPostIds": [],
  "resumeFromLastRun": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "debugLog": false
}' |
apify call valev-lab/facebook-groups-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,valev-lab/facebook-groups-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/u7qVFMowbcn0Ha07v/builds/QSB07SYFvbbu6a8Ul/openapi.json
