# Facebook Post Scraper (`futurizerush/facebook-post-scraper`) Actor
Collect posts from public Facebook Pages — captions, reactions, comments, shares, image/video URLs, and Page details. Paste a Page URL and run. (Beta)
- **URL**: https://apify.com/futurizerush/facebook-post-scraper.md
- **Developed by:** [Rush](https://apify.com/futurizerush) (community)
- **Categories:** AI, Agents, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet
## Pricing
from $10.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Facebook Post Scraper
Collect posts from public Facebook Pages with engagement metrics, media URLs, and author details. Just paste a Page URL and run.
Built for marketers, researchers, and lead-gen teams who need clean Facebook content data ready to drop into spreadsheets, dashboards, or downstream pipelines.
---
### What you get
For every post collected, you receive a flat record with:
| Group | Fields |
|---|---|
| **Identifiers** | post_id, post_url, post_type |
| **Page** | page_id, page_username, page_name, page_url, page_avatar_url, page_is_verified, page_category |
| **Content** | text, hashtags, mentioned_users |
| **Timing** | creation_timestamp_utc, creation_iso, creation_human |
| **Engagement** | reaction_count, like_count, love_count, haha_count, wow_count, sad_count, angry_count, care_count, comment_count, share_count, view_count |
| **Media** | image_urls, video_url, video_thumbnail_url, video_duration_seconds |
| **Live indicator** | is_live_video |
| **Provenance** | extracted_at_utc, source_url |
| **Status** (filled when an input couldn't be collected) | error |
Successful records have `error: null`. When a Page can't be loaded — or when an input URL is rejected up front — the dataset also includes one row for that input with the `error` field filled in. On these rows, post-content fields stay empty, `extracted_at_utc` is always populated, and `source_url` carries the input you submitted. `page_username` and `page_url` are populated when the input was a recognisable Page URL. To get successful posts only, filter where `error` is null.
A note on the three timing fields: `creation_timestamp_utc` is a number for sorting and date math, `creation_iso` is a standard date string most data tools expect, and `creation_human` is a friendly format like `April 24, 2026 at 21:25 UTC` for reports. Pick whichever your tool prefers — they all describe the same moment.
---
### Inputs
| Field | Type | Description |
|---|---|---|
| `startUrls` | array of URLs | Public Facebook Page URLs (e.g. `https://www.facebook.com/nasa`). Up to 20 per run. |
| `resultsLimit` | integer | Maximum posts per Page (10–100, default 20). |
| `onlyPostsNewerThan` | date | Skip posts older than this date (`2026-01-01` or `7 days`). |
| `onlyPostsOlderThan` | date | Skip posts newer than this date (`2026-04-01` or `30 days`). |
Personal profiles, groups, and events are not supported — those need different actors.
---
### Use cases
- **Brand monitoring**: track engagement on competitor Pages over time.
- **Content research**: discover what's working for top creators in a niche.
- **Lead generation & influencer vetting**: vet candidate Pages individually — check category, verification badge, post style, and recent engagement signals.
- **Trend analysis**: collect post data across multiple Pages for sentiment or topic modelling.
---
### How it works
1. Paste one or more public Page URLs.
2. Choose how many posts to collect per Page (10–100).
3. Optionally narrow by date range.
4. Run — output arrives as a flat dataset, ready to drop into a spreadsheet, BI tool, or downstream pipeline.
No login required, no account at risk, no credentials kept.
---
### Good to know
- **Public Pages only.** Personal profiles, private groups, and events need different actors.
- **Recent posts only.** Public Pages expose a recent window of posts. Very old archives are out of scope for this actor.
- **Larger jobs work best in smaller runs.** If you have many Pages to collect, splitting them across several smaller runs (5–10 Pages each) usually works better than one large run.
- **Some fields may be null.** When a post or Page doesn't publish a field publicly, you'll see `null` for that field rather than a guess.
- **Field names and types stay consistent across runs.** Facebook itself can change what's available publicly, in which case some fields may become null until the actor is updated.
---
### FAQ
**Q. Why do I sometimes get fewer posts than I asked for?**
A. The Page may have fewer posts available publicly than your limit, or your date filter excluded some. Both are normal and not errors.
**Q. Can you scrape private Pages or groups?**
A. No. This actor only handles public Pages.
**Q. The top post on a Page seems to be the same one for several days. Is the actor cached?**
A. No — that's most likely the Page's pinned post. Pinned posts stay at the top of a Page until the owner unpins them.
**Q. My run finished with one or more failed Pages. What does that mean?**
A. One or more of your inputs couldn't be processed. Each failed input appears in the dataset as a row with the `error` field filled in. The `source_url` field carries what you submitted, so you can always trace the row back to the input. Common causes: the Page wasn't loadable (temporary issue or restricted Page), or the URL pointed to a group, event, or personal profile by mistake.
**Q. What if I hit issues on a big run?**
A. If a run hits a temporary limit, the remaining Pages are recorded with a status row so you can re-submit them later in a smaller batch.
**Q. Can I get reaction breakdowns (Like vs Love vs Haha)?**
A. Yes — when the breakdown is available for a post, the per-reaction fields are populated alongside the total reaction count.
---
### Disclaimer
This actor extracts publicly accessible information that Facebook makes available to non-logged-in visitors. It does not log in, does not bypass any access control, and does not collect non-public data.
You are responsible for using the output in compliance with Facebook's Terms of Service, GDPR / CCPA / your local privacy law, and any platform-specific data-use restrictions. Results depend on what Facebook makes publicly available and may vary over time.
**For learning and research.** This actor is provided for educational and research purposes — please use it ethically and consider the privacy of the people whose Pages and posts appear in the results.
**Beta.** The actor is currently in beta. There may be missing fields, edge-case bugs, or behaviour you don't expect.
**Test before going large.** We recommend running a small batch first (one or two Pages) to confirm the output matches what you need before launching a big run.
**Feedback welcome.** If something doesn't behave as you'd expect, please open an issue on the actor's page so we can take a look.
---
### More tools you might like
If this actor fits your workflow, take a look at our [other Apify scrapers](https://apify.com/futurizerush?fpr=rush) for Threads, TikTok, Instagram, and other platforms.
---
Keywords: Facebook scraper, Facebook posts, public page scraper, social media data, brand monitoring, lead generation, content analytics, no login scraper, Apify, OpenClaw, Claude Code, Gemini, Antigravity, Codex, ChatGPT
# Actor input Schema
## `startUrls` (type: `array`):
Paste one or more public Facebook Page URLs — for example https://www.facebook.com/nasa. Personal profiles, groups, and events aren't supported.
## `resultsLimit` (type: `integer`):
How many posts to collect from each Page (10–100). The default of 20 covers most Pages. Public Pages expose only a recent window of posts, so the actual count per Page can vary.
## `onlyPostsNewerThan` (type: `string`):
Skip posts older than this date. Accepts a calendar date (e.g. 2026-01-01), a precise timestamp, or a relative value like '7 days' or '2 weeks'.
## `onlyPostsOlderThan` (type: `string`):
Skip posts newer than this date. Accepts a calendar date (e.g. 2026-12-31), a precise timestamp, or a relative value like '7 days' or '2 weeks'.
## Actor input object example
```json
{
"startUrls": [
"https://www.facebook.com/nasa",
"https://www.facebook.com/Microsoft"
],
"resultsLimit": 20
}
````
# Actor output Schema
## `overview` (type: `string`):
Quick summary of collected posts
## `engagement` (type: `string`):
Reactions, comments, shares, and views per post
## `media` (type: `string`):
Image and video URLs
## `authors` (type: `string`):
Page details for each collected row
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"startUrls": [
"https://www.facebook.com/nasa",
"https://www.facebook.com/Microsoft"
],
"resultsLimit": 20
};
// Run the Actor and wait for it to finish
const run = await client.actor("futurizerush/facebook-post-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"startUrls": [
"https://www.facebook.com/nasa",
"https://www.facebook.com/Microsoft",
],
"resultsLimit": 20,
}
# Run the Actor and wait for it to finish
run = client.actor("futurizerush/facebook-post-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": [
"https://www.facebook.com/nasa",
"https://www.facebook.com/Microsoft"
],
"resultsLimit": 20
}' |
apify call futurizerush/facebook-post-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=futurizerush/facebook-post-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Facebook Post Scraper",
"description": "Collect posts from public Facebook Pages — captions, reactions, comments, shares, image/video URLs, and Page details. Paste a Page URL and run. (Beta)",
"version": "0.0",
"x-build-id": "mTtwdfqOWm5ekkUnU"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/futurizerush~facebook-post-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-futurizerush-facebook-post-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/futurizerush~facebook-post-scraper/runs": {
"post": {
"operationId": "runs-sync-futurizerush-facebook-post-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/futurizerush~facebook-post-scraper/run-sync": {
"post": {
"operationId": "run-sync-futurizerush-facebook-post-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"startUrls"
],
"properties": {
"startUrls": {
"title": "🔗 Facebook Page URLs",
"minItems": 1,
"maxItems": 20,
"uniqueItems": true,
"type": "array",
"description": "Paste one or more public Facebook Page URLs — for example https://www.facebook.com/nasa. Personal profiles, groups, and events aren't supported.",
"items": {
"type": "string"
}
},
"resultsLimit": {
"title": "📦 Posts per Page",
"minimum": 10,
"maximum": 100,
"type": "integer",
"description": "How many posts to collect from each Page (10–100). The default of 20 covers most Pages. Public Pages expose only a recent window of posts, so the actual count per Page can vary.",
"default": 20
},
"onlyPostsNewerThan": {
"title": "Only posts newer than",
"type": "string",
"description": "Skip posts older than this date. Accepts a calendar date (e.g. 2026-01-01), a precise timestamp, or a relative value like '7 days' or '2 weeks'."
},
"onlyPostsOlderThan": {
"title": "Only posts older than",
"type": "string",
"description": "Skip posts newer than this date. Accepts a calendar date (e.g. 2026-12-31), a precise timestamp, or a relative value like '7 days' or '2 weeks'."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```