# Facebook Page Posts Monitor - Public Posts & Engagement API (`groupoject/facebook-page-posts-monitor`) Actor Monitor public Facebook pages for visible posts, page details, links, images, and engagement signals. Built for brand tracking, competitor monitoring, and social listening exports. - **URL**: https://apify.com/groupoject/facebook-page-posts-monitor.md - **Developed by:** [Group Oject](https://apify.com/groupoject) (community) - **Categories:** Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Page Posts Monitor - Public Posts & Engagement API Monitor public Facebook pages for visible post and page signals. Export page names, post URLs, text snippets, images, external links, timestamps when available, and engagement counters when Facebook exposes them. ### Use cases - Track competitor Facebook page activity - Monitor brand pages and local business pages - Build social listening alerts for public posts - Export Facebook page metadata for lead lists - Schedule recurring page monitoring via Apify API ### What you get - Page name, page ID when available, and canonical page URL - Visible public post URLs and post IDs - Post text/snippet from public embedded data - Image/video URLs when exposed - External links mentioned near the post - Reaction, comment, and share counters when exposed - Diagnostics for restricted/login/checkpoint pages ### Important notes Facebook frequently changes logged-out access. This Actor is designed to be transparent: if Facebook serves a restricted page, the run summary explains it. For better coverage, provide your own Facebook `Cookie` header and use Apify Proxy. Only scrape public content and accounts you are allowed to access. ### Input example ```json { "pageUrls": [ "https://www.facebook.com/humansofnewyork", "nike" ], "maxPostsPerPage": 25, "dedupe": true, "proxyConfiguration": { "useApifyProxy": true } } ```` ### Output fields ```json { "pageName": "Humans of New York", "postId": "1234567890", "postUrl": "https://www.facebook.com/example/posts/1234567890", "text": "Visible public post text...", "publishedAt": "2026-06-19T12:00:00.000Z", "reactionsCount": 120, "commentsCount": 12, "sharesCount": 5, "imageUrl": "https://...", "externalLinks": ["https://example.com"], "extractionMethod": "embedded_json" } ``` ### Recommended saved tasks - Competitor Facebook page monitor - Brand Facebook page alerts - Local business page tracker - Publisher/social newsroom monitor - Creator page activity monitor # Actor input Schema ## `pageUrls` (type: `array`): Public Facebook page URLs or handles to monitor. ## `pageUrlsText` (type: `string`): Paste one Facebook page URL or handle per line. ## `maxPostsPerPage` (type: `integer`): Maximum visible post rows to keep per page. ## `includePageMetadata` (type: `boolean`): When logged-out Facebook HTML does not expose posts, save the public page metadata row instead of returning an empty dataset. ## `cookie` (type: `string`): Optional. Paste your own Facebook Cookie header for pages that require logged-in public access. Use only accounts and data you are allowed to access. ## `dedupe` (type: `boolean`): Remove duplicate post URLs across all pages. ## `requestDelayMs` (type: `integer`): Delay between page requests. ## `maxConcurrency` (type: `integer`): Parallel page requests. Keep modest for Facebook. ## `proxyConfiguration` (type: `object`): Optional. Use Apify Proxy or a trusted proxy for repeated runs. ## `debugMode` (type: `boolean`): Verbose logging. ## Actor input object example ```json { "pageUrls": [ "https://www.facebook.com/humansofnewyork", "nike" ], "maxPostsPerPage": 25, "includePageMetadata": true, "dedupe": true, "requestDelayMs": 1000, "maxConcurrency": 2, "proxyConfiguration": { "useApifyProxy": true }, "debugMode": false } ``` # Actor output Schema ## `posts` (type: `string`): One row per visible post or page metadata fallback. ## `postsByPage` (type: `string`): Dataset rows grouped by Facebook page. ## `summary` (type: `string`): Totals, diagnostics, restricted pages, and warnings. ## `errors` (type: `string`): Pages that failed to fetch. # 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 = { "pageUrls": [ "https://www.facebook.com/humansofnewyork", "nike" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("groupoject/facebook-page-posts-monitor").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 = { "pageUrls": [ "https://www.facebook.com/humansofnewyork", "nike", ], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("groupoject/facebook-page-posts-monitor").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 '{ "pageUrls": [ "https://www.facebook.com/humansofnewyork", "nike" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call groupoject/facebook-page-posts-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=groupoject/facebook-page-posts-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Page Posts Monitor - Public Posts & Engagement API", "description": "Monitor public Facebook pages for visible posts, page details, links, images, and engagement signals. Built for brand tracking, competitor monitoring, and social listening exports.", "version": "1.0", "x-build-id": "BJYFVCteSHaK4usZq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/groupoject~facebook-page-posts-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-groupoject-facebook-page-posts-monitor", "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/groupoject~facebook-page-posts-monitor/runs": { "post": { "operationId": "runs-sync-groupoject-facebook-page-posts-monitor", "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/groupoject~facebook-page-posts-monitor/run-sync": { "post": { "operationId": "run-sync-groupoject-facebook-page-posts-monitor", "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", "properties": { "pageUrls": { "title": "Facebook page URLs or handles", "uniqueItems": true, "type": "array", "description": "Public Facebook page URLs or handles to monitor.", "items": { "type": "string" } }, "pageUrlsText": { "title": "Bulk page URLs", "type": "string", "description": "Paste one Facebook page URL or handle per line." }, "maxPostsPerPage": { "title": "Max posts per page", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum visible post rows to keep per page.", "default": 25 }, "includePageMetadata": { "title": "Include page metadata fallback", "type": "boolean", "description": "When logged-out Facebook HTML does not expose posts, save the public page metadata row instead of returning an empty dataset.", "default": true }, "cookie": { "title": "Facebook Cookie header", "type": "string", "description": "Optional. Paste your own Facebook Cookie header for pages that require logged-in public access. Use only accounts and data you are allowed to access." }, "dedupe": { "title": "Deduplicate posts", "type": "boolean", "description": "Remove duplicate post URLs across all pages.", "default": true }, "requestDelayMs": { "title": "Request delay (ms)", "minimum": 0, "maximum": 15000, "type": "integer", "description": "Delay between page requests.", "default": 1000 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Parallel page requests. Keep modest for Facebook.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Use Apify Proxy or a trusted proxy for repeated runs." }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Verbose logging.", "default": false } } }, "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 } } } } } } } } } } ```