# Facebook Reviews Scraper (`parseforge/facebook-reviews-scraper`) Actor Scrape reviews from any Facebook page. Get review text, recommendation status, reviewer profiles, engagement metrics, tags, and page-level stats. Supports multi-page runs with automatic pagination. No login required. Export to JSON, CSV, or connect via integrations. - **URL**: https://apify.com/parseforge/facebook-reviews-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Social media, Lead generation, Other - **Stats:** 4 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐Ÿ“˜ Facebook Reviews Scraper > ๐Ÿš€ **Pull reviews from any Facebook page in minutes.** Review text, recommendation status, reviewer profile, engagement metrics, page-level stats. No login. > ๐Ÿ•’ **Last updated:** 2026-05-09 ยท **๐Ÿ“Š 15+ fields** per review ยท **๐Ÿ”„ Multi-page batch** ยท **๐Ÿšซ No auth** required
Pull structured records from Facebook Reviews โ€” clean fields ready as CSV, JSON, JSONL, Excel, or XML for downstream pipelines.
Related Scrapers
 Reviews
โžธ You are here 		 Ads Library
Political+commercial ad archive 		 Pages
Page profiles + about 		 Posts
Wall posts + reactions
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ```` parseforge/facebook-reviews-scraper on Apify. Call: ApifyClient("TOKEN").actor("parseforge/facebook-reviews-scraper").call(run\_input={...}), then client.dataset(run\["defaultDatasetId"]).list\_items().items for results. Key inputs: startUrls (array, default \[{"url": "https://www.facebook.com/McDonalds/"}]), maxItems (integer, default 10), maxReviewsPerPage (integer), proxyConfiguration (object, default {"useApifyProxy": true, "apifyProxyGroups": \["RESIDENTIAL"]}). Full actor spec: fetch build via GET https://api.apify.com/v2/acts/parseforge~facebook-reviews-scraper (Bearer TOKEN). Get token: https://console.apify.com/account/integrations ```` Pull live reviews from any Facebook public page. The actor accepts a list of Facebook page URLs, walks each page's reviews, and returns one structured record per review ready for reputation management, sentiment analysis, brand monitoring, or competitive review intelligence. Every run fetches data live so you get the current state of Facebook at run time. Records include the review text, recommendation status (recommended / not recommended), reviewer name, reviewer profile URL, posted date, like count, comment count, page name, page total review count, and a back-reference URL. | ๐Ÿ‘ฅ Built for | ๐ŸŽฏ Primary use cases | |---|---| | Reputation management | Bulk-export Facebook reviews for response workflows | | Brand and social listening | Monitor brand sentiment across pages | | Restaurant chains | Aggregate reviews across all locations | | Hospitality groups | Track guest sentiment by property | | Marketing agencies | Build review-aggregation reports for clients | | Researchers | Study customer sentiment across industries | --- ### ๐Ÿ“‹ What the Facebook Reviews Scraper does - ๐Ÿ“˜ **Multi-page batch.** Pass multiple page URLs in a single run. - โญ **Recommendation status.** Captures whether the reviewer recommended the page. - ๐Ÿ‘ค **Reviewer info.** Name, profile URL. - ๐Ÿ“… **Timestamps.** Posted date for each review. - ๐Ÿ’ฌ **Engagement metrics.** Like and comment counts on the review itself. - ๐Ÿ“Š **Page-level stats.** Total review count and recommendation rate. The scraper walks each page's reviews, paginates through all reviews up to maxReviewsPerPage, and pushes structured records to the dataset. > ๐Ÿ’ก **Why it matters:** Facebook reviews drive purchase decisions for restaurants, hospitality, retail, and local services but Facebook lacks bulk export. A live, structured pull beats manual scraping for reputation management and competitive intelligence. --- ### ๐ŸŽฌ Full Demo ๐Ÿšง Coming soon: a 3-minute walkthrough showing setup, a live run, and how to pipe results into Slack via Apify integrations. --- ### โš™๏ธ Input | Field | Type | Name | Description | |---|---|---|---| | startUrls | array | Facebook Page URLs | Required. Page URLs (e.g. `https://www.facebook.com/McDonalds/`). | | maxItems | integer | Max Items | Free users: limited to 10 items (preview). Paid users: optional, max 1,000,000. | | maxReviewsPerPage | integer | Max Reviews Per Page | Cap reviews per page. Leave empty to use maxItems globally. | | proxyConfiguration | object | Proxy Configuration | Proxy settings. Defaults to Apify residential pool. | Example 1. Single page reviews. ```json { "startUrls": [{"url": "https://www.facebook.com/McDonalds/"}], "maxItems": 50 } ```` Example 2. Multi-page batch. ```json { "startUrls": [ {"url": "https://www.facebook.com/Walmart/"}, {"url": "https://www.facebook.com/Target/"}, {"url": "https://www.facebook.com/Costco/"} ], "maxReviewsPerPage": 100, "maxItems": 300 } ``` > โš ๏ธ **Good to Know:** Facebook aggressively rate-limits scraping. Residential proxies are required for reliable pulls. *** ### ๐Ÿ“Š Output The dataset returns one structured record per review. Each record carries identifiers, review text, recommendation status, reviewer info, timestamp, engagement metrics, page name, and a back-reference URL. Consume the dataset as JSON, CSV, Excel, XML, or RSS via the Apify console or API. #### ๐Ÿงพ Schema | Field | Type | Example | |---|---|---| | ๐Ÿ†” reviewId | string | `123456789012345_67890` | | ๐Ÿ“˜ pageName | string | `McDonald's` | | ๐Ÿ”— pageUrl | string (url) | `https://www.facebook.com/McDonalds/` | | ๐Ÿ“ text | string | `Always great service and quick orders.` | | โญ recommends | boolean | true | | ๐Ÿ‘ค reviewerName | string | `Jane Smith` | | ๐Ÿ”— reviewerUrl | string (url) | `https://www.facebook.com/jane.smith` | | ๐Ÿ“… postedAt | ISO datetime | `2026-04-12T14:30:00.000Z` | | ๐Ÿ‘ likeCount | number | `12` | | ๐Ÿ’ฌ commentCount | number | `3` | | ๐Ÿ“Š pageRecommendationRate | number | `0.87` | | ๐Ÿ“Š pageTotalReviews | number | `15240` | | ๐Ÿ“… scrapedAt | ISO datetime | `2026-05-09T12:00:00.000Z` | #### ๐Ÿ“ฆ Sample records ##### 1. Positive review (recommended) ```json { "reviewId": "123456789012345_67890", "pageName": "McDonald's", "pageUrl": "https://www.facebook.com/McDonalds/", "text": "Always great service and quick orders. Staff is friendly.", "recommends": true, "reviewerName": "Jane Smith", "reviewerUrl": "https://www.facebook.com/jane.smith", "postedAt": "2026-04-12T14:30:00.000Z", "likeCount": 12, "commentCount": 3, "pageRecommendationRate": 0.87, "pageTotalReviews": 15240, "scrapedAt": "2026-05-09T12:00:00.000Z" } ``` ##### 2. Negative review (not recommended) ```json { "reviewId": "234567890123456_78901", "pageName": "Walmart", "pageUrl": "https://www.facebook.com/Walmart/", "text": "Long lines and items I needed were out of stock.", "recommends": false, "reviewerName": "John Doe", "reviewerUrl": "https://www.facebook.com/john.doe", "postedAt": "2026-05-01T09:00:00.000Z", "likeCount": 0, "commentCount": 1, "pageRecommendationRate": 0.79, "pageTotalReviews": 28500, "scrapedAt": "2026-05-09T12:00:00.000Z" } ``` ##### 3. Sparse record (no engagement) ```json { "reviewId": "345678901234567_89012", "pageName": "Local Cafe", "pageUrl": "https://www.facebook.com/local-cafe/", "text": "Decent coffee.", "recommends": true, "reviewerName": "Anon User", "postedAt": "2026-05-08T10:00:00.000Z", "likeCount": 0, "commentCount": 0, "scrapedAt": "2026-05-09T12:00:00.000Z" } ``` *** ### โœจ Why choose this Actor | | Capability | |---|---| | ๐ŸŽฏ | **Built for the job.** Scoped specifically to Facebook reviews so you skip the parser engineering entirely. | | ๐Ÿ”– | **Structured output.** Clean, typed fields ready for analysis, dashboards, or downstream pipelines. | | โšก | **Fast.** Optimized request patterns return results in seconds, not minutes. | | ๐Ÿ” | **Always fresh.** Every run pulls live data, so the dataset reflects Facebook as of run time. | | ๐ŸŒ | **No infra to manage.** Apify handles proxies, retries, scaling, scheduling, and storage. | | ๐Ÿ›ก๏ธ | **Reliable.** Battle-tested across many runs and edge cases, with graceful error handling. | | ๐Ÿšซ | **No code required.** Configure in the UI, run from CLI, schedule via cron, or call from any language with the Apify SDK. | > ๐Ÿ“Š Production-grade structured review data without the engineering overhead of building and maintaining your own scraper. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **โญ Facebook Reviews Scraper** *(this Actor)* | $5 free credit, then pay-per-use | Public Facebook pages | **Live per run** | Page URL, max-per-page | โšก 2 min | | Build your own scraper | Engineering hours | Full once built | Whenever you maintain it | Custom code | ๐Ÿข Days to weeks | | Paid reputation-management tools | $$$ monthly per location | Vendor-defined | Periodic | Vendor-defined | โณ Hours | | Manual sourcing | Hours per check | Limited | Stale | Manual | ๐Ÿ•’ Variable | Pick this Actor when you want broad coverage, source-native filtering, and no pipeline maintenance. *** ### ๐Ÿš€ How to use 1. ๐Ÿ“ **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. ๐ŸŒ **Open the Actor.** Go to the Facebook Reviews Scraper page on the Apify Store. 3. ๐ŸŽฏ **Add page URLs.** Paste Facebook page URLs into startUrls and configure cap. 4. ๐Ÿš€ **Run it.** Click **Start** and let the Actor collect your data. 5. ๐Ÿ“ฅ **Download.** Grab your results in the **Dataset** tab as CSV, Excel, JSON, or XML. > โฑ๏ธ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### ๐Ÿ’ผ Business use cases
#### ๐Ÿ“Š Reputation management - Bulk-export Facebook reviews for response workflows - Build review-aggregation dashboards - Track recommendation rate over time - Power crisis-response monitoring #### ๐Ÿข Brand and social listening - Monitor brand sentiment across pages - Track competitor review activity - Build crisis-detection dashboards - Map share-of-voice in your industry
#### ๐ŸŽฏ Multi-location operations - Aggregate reviews across all locations - Build location-level CSAT scorecards - Surface underperforming locations - Power chain-wide quality programs #### ๐Ÿ› ๏ธ Engineering and product - Power review-aggregation products - Replace fragile in-house Facebook scrapers - Wire datasets into your apps via the Apify API or webhooks - Skip the proxy, retry, and parsing maintenance entirely
*** ### ๐ŸŒŸ Beyond business use cases Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.
#### ๐ŸŽ“ Research and academia - Empirical datasets for papers, thesis work, and coursework - Longitudinal studies tracking changes across snapshots - Reproducible research with cited, versioned data pulls - Classroom exercises on data analysis and ethical scraping #### ๐ŸŽจ Personal and creative - Side projects, portfolio demos, and indie app launches - Data visualizations, dashboards, and infographics - Content research for bloggers, YouTubers, and podcasters - Hobbyist collections and personal trackers
#### ๐Ÿค Non-profit and civic - Transparency reporting and accountability projects - Advocacy campaigns backed by public-interest data - Community-run databases for local issues - Investigative journalism on public records #### ๐Ÿงช Experimentation - Prototype AI and machine-learning pipelines with real data - Validate product-market hypotheses before engineering spend - Train small domain-specific models on niche corpora - Test dashboard concepts with live input
*** ### ๐Ÿ”Œ Automating Facebook Reviews Scraper This Actor exposes a REST endpoint, so you can drive it from any language or workflow tool. - **Node.js** - call it via the [Apify JS SDK](https://docs.apify.com/sdk/js). - **Python** - call it via the [Apify Python SDK](https://docs.apify.com/sdk/python). - **REST** - hit it directly through the [Apify v2 API](https://docs.apify.com/api/v2). **Schedules.** Use Apify Scheduler to capture daily review snapshots. Combine with the Apify dataset diff tools to alert on new reviews and sentiment shifts. *** ### โ“ Frequently Asked Questions
๐Ÿ’ณ Do I need a paid Apify plan to run this actor? No. You can start right now on the free Apify plan, which includes **$5 in monthly credit**. That is enough to run the scraper several times and explore the output. Paid plans unlock higher item caps, more concurrent runs, and larger datasets. [Create a free Apify account here](https://console.apify.com/sign-up?fpr=vmoqkp).
๐Ÿšจ What happens if my run fails or returns no results? Failed runs are not charged. If Facebook changes its DOM, proxies get rate-limited, or your URLs match nothing, re-run the actor or open our [contact form](https://tally.so/r/BzdKgA) and we will look into it.
๐Ÿ“ How many items can I scrape per run? Free users are limited to **10 items per run** so you can preview the output. Paid users can raise maxItems up to **1,000,000** per run.
๐Ÿ”’ Can it scrape private pages or groups? No. The actor only processes publicly accessible Facebook pages.
๐Ÿ•’ How fresh is the data? Every run fetches live data at the moment of execution. There is no cache or delay: records reflect what Facebook returned at run time.
๐Ÿง‘โ€๐Ÿ’ป Can I call this actor from my own code? Yes. Apify exposes every actor as a REST endpoint and ships first-class SDKs for [Node.js](https://docs.apify.com/sdk/js) and [Python](https://docs.apify.com/sdk/python). You can start a run, read the dataset, and handle webhooks from your own app in a few lines.
๐Ÿ“ค How do I export the data? Every Apify dataset can be downloaded in one click as CSV, JSON, JSONL, Excel, HTML, XML, or RSS. You can also pull results programmatically via the [Apify API](https://docs.apify.com/api/v2) or stream into BigQuery, S3, and other destinations through built-in integrations.
๐Ÿ“… Can I schedule the actor to run automatically? Yes. Use the Apify scheduler to run the actor on any cadence, from hourly to monthly. Results are saved to your dataset and can be delivered to webhooks, email, Slack, cloud storage, or automation tools such as Zapier and Make.
๐Ÿช Can I use the data commercially? Yes. The scraped data is yours to use in your own internal pipelines, products, and reports, subject to Facebook's Terms of Service and applicable privacy laws.
๐Ÿ’ผ Which plan should I pick for production use? Apify's Starter and Scale plans are designed for production workloads. Pick the plan that matches your dataset size and refresh cadence.
๐Ÿ› ๏ธ The data I need is not in the output. Can you add it? Most likely yes. Open the [contact form](https://tally.so/r/BzdKgA) and tell us which field you need.
โš–๏ธ Is scraping Facebook legal? This Actor only collects data from publicly accessible Facebook pages, the same content any visitor can read. Public web scraping is generally legal in most jurisdictions for non-personal data, but laws vary by country and use case. You are responsible for compliance with Facebook's Terms of Service, applicable privacy laws (such as GDPR or CCPA), and any data-protection rules that apply. ***
### ๐Ÿ”Œ Integrate with any app Facebook Reviews Scraper connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications in your channels - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe results into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets straight to Sheets You can also use webhooks to trigger downstream actions when a run finishes. *** ### ๐Ÿ”— Recommended Actors - [**๐Ÿ“˜ Facebook Posts Scraper**](https://apify.com/parseforge/facebook-posts-scraper) - Page posts with engagement - [**๐Ÿ“˜ Facebook Search Scraper**](https://apify.com/parseforge/facebook-search-scraper) - Facebook search results - [**๐Ÿ“ธ Instagram Posts Scraper**](https://apify.com/parseforge/instagram-posts-scraper) - Instagram posts with metadata - [**๐Ÿ“ฑ Reddit Posts Scraper**](https://apify.com/parseforge/reddit-posts-scraper) - Subreddit posts - [**๐Ÿฆ X (Twitter) Scraper**](https://apify.com/parseforge/x-com-scraper) - Tweets with engagement > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers. *** **๐Ÿ†˜ Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom project, or report an issue. *** > โš ๏ธ **Disclaimer.** This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Meta or Facebook. All trademarks mentioned are the property of their respective owners. The scraper accesses only publicly available pages and is intended for legitimate research, analytics, and reputation-management use. Users are responsible for compliance with Facebook's Terms of Service, applicable privacy laws, and any data-protection rules that apply. # Actor input Schema ## `startUrls` (type: `array`): List of Facebook page URLs to scrape reviews from. Example: https://www.facebook.com/McDonalds/ ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `maxReviewsPerPage` (type: `integer`): Maximum number of reviews to scrape per Facebook page. Leave empty to use maxItems as the global limit. ## `proxyConfiguration` (type: `object`): Residential proxies recommended for reliable extraction. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.facebook.com/McDonalds/" } ], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): Dataset with scraped Facebook reviews # 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": [ { "url": "https://www.facebook.com/McDonalds/" } ], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/facebook-reviews-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": [{ "url": "https://www.facebook.com/McDonalds/" }], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("parseforge/facebook-reviews-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": [ { "url": "https://www.facebook.com/McDonalds/" } ], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call parseforge/facebook-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/facebook-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Reviews Scraper", "description": "Scrape reviews from any Facebook page. Get review text, recommendation status, reviewer profiles, engagement metrics, tags, and page-level stats. Supports multi-page runs with automatic pagination. No login required. Export to JSON, CSV, or connect via integrations.", "version": "1.0", "x-build-id": "2Mn2lNVH78He40Z4z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~facebook-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-facebook-reviews-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/parseforge~facebook-reviews-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-facebook-reviews-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/parseforge~facebook-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-facebook-reviews-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", "properties": { "startUrls": { "title": "Facebook Page URLs", "type": "array", "description": "List of Facebook page URLs to scrape reviews from. Example: https://www.facebook.com/McDonalds/", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "maxReviewsPerPage": { "title": "Max Reviews Per Page", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of reviews to scrape per Facebook page. Leave empty to use maxItems as the global limit." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Residential proxies recommended for reliable extraction." } } }, "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 } } } } } } } } } } ```