# WordPress Plugin Reviews Scraper (`automation-lab/wordpress-plugin-reviews-scraper`) Actor Scrape public WordPress.org plugin reviews with ratings, reviewers, replies, URLs, timestamps, and plugin rating summaries. - **URL**: https://apify.com/automation-lab/wordpress-plugin-reviews-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** SEO tools, Developer tools - **Stats:** 2 total users, 1 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 ## WordPress Plugin Reviews Scraper Scrape public WordPress.org plugin reviews, star ratings, reviewer metadata, reply counts, and plugin rating summaries from WordPress.org review pages. ### What does WordPress Plugin Reviews Scraper do? WordPress Plugin Reviews Scraper collects public review data from WordPress.org plugin support forums. Give it plugin slugs such as `woocommerce`, `contact-form-7`, or `elementor`, and it returns structured review rows that are ready for spreadsheets, BI tools, dashboards, and monitoring workflows. The actor is designed for public review intelligence. It does not submit reviews, log into WordPress.org, or access private account data. ### Who is it for? - ๐Ÿ”Œ Plugin vendors tracking their own product reputation - ๐Ÿงฐ WordPress agencies monitoring plugins used by clients - ๐Ÿ›’ WooCommerce and ecommerce teams watching support quality signals - ๐Ÿ“ˆ Product marketers comparing sentiment across competing plugins - ๐Ÿงช Due-diligence teams checking plugin reliability before adoption - ๐Ÿค Support managers finding fresh negative reviews that need follow-up ### Why use this actor? WordPress.org review pages are useful but hard to analyze at scale. This actor converts paginated review listings into consistent rows with review titles, star ratings, reviewers, replies, timestamps, and URLs. You can run it on a schedule to build a review timeline, export recent low-star reviews, or compare review volume across multiple plugins. ### What data can you extract? | Field | Description | | --- | --- | | `pluginSlug` | WordPress.org plugin slug | | `pluginName` | Plugin display name from the review page | | `pluginUrl` | Public plugin URL | | `reviewsUrl` | Public reviews page URL | | `reviewTitle` | Review topic title | | `reviewUrl` | Review topic URL | | `rating` | Star rating, when available | | `reviewerName` | Public reviewer display name | | `reviewerUsername` | WordPress.org profile slug | | `reviewerUrl` | Public reviewer profile URL | | `participants` | Number of thread participants | | `replies` | Number of replies | | `lastActivityText` | Relative last activity text shown by WordPress.org | | `lastActivityUrl` | URL for the latest activity | | `lastReplyAuthorName` | Public name of the latest reply author | | `reviewBody` | Optional review body text from the topic page | | `averageRating` | Plugin average rating | | `totalReviews` | Plugin total review count | | `fiveStarReviews` | 5-star review bucket count | | `oneStarReviews` | 1-star review bucket count | | `scrapedAt` | ISO timestamp when the row was saved | ### How much does it cost to scrape WordPress plugin reviews? This actor uses pay-per-event pricing. You pay a small start fee and a per-review-row fee. Current pricing: - Run started: $0.005 per run - Review row (BRONZE): $0.000037894 per review - Review row (FREE): $0.000043578 per review - Review row (SILVER): $0.000029557 per review - Review row (GOLD): $0.000022736 per review - Review row (PLATINUM): $0.000015157 per review - Review row (DIAMOND): $0.000010610 per review Typical usage examples: - Scrape 25 recent WooCommerce reviews for a quick check - Scrape 100 low-star reviews for support triage - Scrape multiple plugin slugs weekly for reputation monitoring ### How to use it 1. Open the actor on Apify. 2. Add one or more WordPress.org plugin slugs. 3. Choose the maximum number of reviews per plugin. 4. Optionally filter by star rating. 5. Optionally enable review body extraction. 6. Start the run. 7. Export the dataset as JSON, CSV, Excel, XML, or via API. ### Input options #### Plugin slugs Use WordPress.org plugin slugs such as: ```json ["woocommerce", "contact-form-7", "elementor"] ```` #### Start URLs You can also provide public WordPress.org URLs: ```json [ { "url": "https://wordpress.org/plugins/woocommerce/" }, { "url": "https://wordpress.org/support/plugin/contact-form-7/reviews/" } ] ``` #### Maximum reviews per plugin Use `maxReviewsPerPlugin` to control run size. Start small for tests, then increase the limit for historical exports. #### Star rating filter Use `starFilter` to collect only reviews with a specific rating. This is useful for support workflows focused on negative reviews. #### Include review body Enable `includeReviewBody` when you need the text of each review. This opens each review topic page, so it is slower than listing-only mode. ### Example input ```json { "pluginSlugs": ["woocommerce"], "maxReviewsPerPlugin": 25, "starFilter": "all", "includeRatingSummary": true, "includeReviewBody": false } ``` ### Example output ```json { "pluginSlug": "woocommerce", "pluginName": "WooCommerce", "pluginUrl": "https://wordpress.org/plugins/woocommerce/", "reviewsUrl": "https://wordpress.org/support/plugin/woocommerce/reviews/", "reviewTitle": "Outstanding eCommerce Solution for WordPress Stores", "reviewUrl": "https://wordpress.org/support/topic/outstanding-ecommerce-solution-for-wordpress-stores/", "rating": 5, "reviewerName": "manishranawp", "reviewerUsername": "manishranawp", "participants": 1, "replies": 0, "lastActivityText": "1 day, 2 hours ago", "averageRating": 4.5, "totalReviews": 4802, "scrapedAt": "2026-06-11T08:00:00.000Z" } ``` ### Review monitoring workflows - Run daily for your own plugin and alert on new 1-star reviews. - Track review volume after releases. - Compare average rating and review velocity across competitor plugins. - Export review topics to a support CRM. - Build a dashboard of reply counts and unresolved reputation issues. ### Tips for best results - Use plugin slugs when possible; they are the most stable input format. - Start with `maxReviewsPerPlugin` set to 25 for a quick validation run. - Enable `includeReviewBody` only when you need full review text. - Use `starFilter: "1"` or `"2"` for support triage. - Schedule recurring runs to monitor changes over time. ### Integrations Use this actor with: - Google Sheets or Excel exports for product teams - Slack or email alerts through Apify integrations - BI dashboards that ingest Apify datasets - Support queues for low-star review follow-up - Data warehouses via the Apify API ### API usage: Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/wordpress-plugin-reviews-scraper').call({ pluginSlugs: ['woocommerce'], maxReviewsPerPlugin: 25, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` ### API usage: Python ```python from apify_client import ApifyClient client = ApifyClient('MY-APIFY-TOKEN') run = client.actor('automation-lab/wordpress-plugin-reviews-scraper').call(run_input={ 'pluginSlugs': ['woocommerce'], 'maxReviewsPerPlugin': 25, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items) ``` ### API usage: cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~wordpress-plugin-reviews-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"pluginSlugs":["woocommerce"],"maxReviewsPerPlugin":25}' ``` ### MCP usage Use this actor from MCP-compatible tools through Apify MCP Server: ```text https://mcp.apify.com/?tools=automation-lab/wordpress-plugin-reviews-scraper ``` Claude Code setup: ```bash claude mcp add apify-wordpress-reviews https://mcp.apify.com/?tools=automation-lab/wordpress-plugin-reviews-scraper ``` Claude Desktop JSON configuration: ```json { "mcpServers": { "apify-wordpress-reviews": { "url": "https://mcp.apify.com/?tools=automation-lab/wordpress-plugin-reviews-scraper" } } } ``` Example prompts: - "Scrape the latest 25 WooCommerce plugin reviews and summarize negative themes." - "Find 1-star reviews for contact-form-7 and group them by issue type." - "Compare recent review activity for three WordPress plugins." ### Legality and ethics This actor collects publicly available WordPress.org review pages. It does not bypass login, scrape private user data, or submit content. Always use the data responsibly, respect WordPress.org terms, and avoid excessive run sizes. ### Troubleshooting #### The actor saved fewer reviews than requested The plugin may have fewer public reviews than your requested limit, or your star filter may narrow the available pages. #### I do not see review body text Enable `includeReviewBody`. Listing mode is faster and saves metadata only. #### My URL was rejected Use a WordPress.org plugin URL or support review URL, for example `https://wordpress.org/plugins/woocommerce/`. ### Related scrapers Explore other automation-lab actors on Apify for ecommerce, software review, lead generation, and public directory monitoring workflows. ### Changelog - 0.1.0 โ€” Initial version for public WordPress.org plugin review listings. ### Limitations WordPress.org shows relative timestamps such as "1 day ago" in review listings. The actor preserves those public values. Exact absolute timestamps may be available in page attributes for some rows and can be added in a future version if needed. ### Support If you need a field added, a different WordPress.org review workflow, or a monitoring integration, open an issue on the actor page. ### Development notes The actor is HTTP-only and uses WordPress.org public HTML and Markdown output. It is intentionally lightweight and runs with 256 MB memory. ### FAQ #### Can I scrape multiple plugins in one run? Yes. Add multiple plugin slugs to `pluginSlugs`. #### Can I collect only bad reviews? Yes. Set `starFilter` to `"1"` or `"2"`. #### Does this require a WordPress.org account? No. Reading reviews is public. Login is only required to submit or reply to reviews. #### Does it use a browser? No. The actor uses HTTP requests only, which keeps runs fast and inexpensive. #### Can I schedule it? Yes. Use Apify schedules to run it daily, weekly, or after plugin releases. # Actor input Schema ## `pluginSlugs` (type: `array`): WordPress.org plugin slugs such as woocommerce, contact-form-7, or elementor. You can also use start URLs below. ## `startUrls` (type: `array`): Optional WordPress.org plugin URLs or review URLs. Examples: https://wordpress.org/plugins/woocommerce/ or https://wordpress.org/support/plugin/woocommerce/reviews/ ## `maxReviewsPerPlugin` (type: `integer`): Maximum review rows to save for each plugin. Keep low for test runs; increase for monitoring or historical exports. ## `starFilter` (type: `string`): Optionally collect only 1-star, 2-star, 3-star, 4-star, or 5-star review pages. ## `includeRatingSummary` (type: `boolean`): Add average rating, total review count, and star histogram columns to every review row. ## `includeReviewBody` (type: `boolean`): Open each review topic page to extract the public review text. This is slower but gives richer review content. ## Actor input object example ```json { "pluginSlugs": [ "woocommerce" ], "startUrls": [ { "url": "https://wordpress.org/support/plugin/woocommerce/reviews/" } ], "maxReviewsPerPlugin": 20, "starFilter": "all", "includeRatingSummary": true, "includeReviewBody": false } ``` # Actor output Schema ## `overview` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "pluginSlugs": [ "woocommerce" ], "startUrls": [ { "url": "https://wordpress.org/support/plugin/woocommerce/reviews/" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/wordpress-plugin-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 = { "pluginSlugs": ["woocommerce"], "startUrls": [{ "url": "https://wordpress.org/support/plugin/woocommerce/reviews/" }], } # Run the Actor and wait for it to finish run = client.actor("automation-lab/wordpress-plugin-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 '{ "pluginSlugs": [ "woocommerce" ], "startUrls": [ { "url": "https://wordpress.org/support/plugin/woocommerce/reviews/" } ] }' | apify call automation-lab/wordpress-plugin-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/wordpress-plugin-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "WordPress Plugin Reviews Scraper", "description": "Scrape public WordPress.org plugin reviews with ratings, reviewers, replies, URLs, timestamps, and plugin rating summaries.", "version": "0.1", "x-build-id": "h3OPhyYLwVc9xCx0I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~wordpress-plugin-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-wordpress-plugin-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/automation-lab~wordpress-plugin-reviews-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-wordpress-plugin-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/automation-lab~wordpress-plugin-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-wordpress-plugin-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": { "pluginSlugs": { "title": "Plugin slugs", "type": "array", "description": "WordPress.org plugin slugs such as woocommerce, contact-form-7, or elementor. You can also use start URLs below.", "items": { "type": "string" } }, "startUrls": { "title": "Plugin or review URLs", "type": "array", "description": "Optional WordPress.org plugin URLs or review URLs. Examples: https://wordpress.org/plugins/woocommerce/ or https://wordpress.org/support/plugin/woocommerce/reviews/", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxReviewsPerPlugin": { "title": "Maximum reviews per plugin", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum review rows to save for each plugin. Keep low for test runs; increase for monitoring or historical exports.", "default": 20 }, "starFilter": { "title": "Star rating filter", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string", "description": "Optionally collect only 1-star, 2-star, 3-star, 4-star, or 5-star review pages.", "default": "all" }, "includeRatingSummary": { "title": "Include rating summary on each row", "type": "boolean", "description": "Add average rating, total review count, and star histogram columns to every review row.", "default": true }, "includeReviewBody": { "title": "Fetch review body text", "type": "boolean", "description": "Open each review topic page to extract the public review text. This is slower but gives richer review content.", "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 } } } } } } } } } } ```