# WordPress & WooCommerce Plugin Scraper: Stats & Churn Leads (`storeintel/wordpress-plugin-directory-scraper`) Actor

Extract WordPress.org and WooCommerce plugin active installs, historical downloads, unresolved support ticket ratios, abandonware risk flags, commercial URLs, and 1-5 star user reviews with churn classification.

- **URL**: https://apify.com/storeintel/wordpress-plugin-directory-scraper.md
- **Developed by:** [StoreIntel Labs](https://apify.com/storeintel) (community)
- **Categories:** E-commerce, Lead generation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 plugin review & churn leads

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

## WordPress & WooCommerce Plugin Scraper: Stats & Churn Leads

Extract structured adoption intelligence, active install counts, historical download totals, unresolved support forum ratios, commercial pro URLs, and 1–5 star user reviews with automated churn and pain-point classification from the official WordPress.org Plugin Directory (`wordpress.org/plugins`).

***

### Core Capabilities

#### 1. Plugin Adoption, Support Health & Commercial Intelligence (`record_type: "plugin_profile"`)

- **Adoption & Growth Metrics:** Exact `active_installs` tier, `total_downloads` counter, `rating` (0.0–5.0 scale), `reviews_count`, and full `rating_breakdown` (`5` through `1` star counts).
- **Support Resolution & Abandonware Signals:** Extracts `support_threads_total`, `support_threads_resolved`, `support_threads_unresolved`, and `support_resolution_rate_pct` alongside `last_updated`, `tested_wp`, `requires_wp`, and `requires_php`.
- **WooCommerce & Commercial Ecosystem Links:** Flags `is_woocommerce_extension`, `requires_plugins`, `business_model` (`commercial` vs `community`), `homepage_url`, `commercial_support_url`, `repository_url`, and `author_profile_url`.

#### 2. User Reviews & Churn Leads (`record_type: "plugin_review"`)

- **Star-Filtered Review Extraction:** Extracts individual plugin reviews filtered by star rating (`1`–`5` stars) with `title`, `review_text`, `published_at`, `author_username`, `author_profile_url`, and `replies_count`.
- **Automated Pain-Point Classification (`pain_point_tags`):** Tags reviews across 6 SaaS complaint categories: `pricing_billing` (aggressive upsells/paywalls), `customer_support`, `bugs_reliability` (fatal errors/conflicts), `performance_speed` (database bloat/slow queries), `missing_features`, and `usability_setup`.

#### 3. Keyword & Tag Niche Discovery (`searchQueries`, `tagSlugs`)

Pass any search keywords (e.g., `"woocommerce checkout"`, `"booking calendar"`) or tag slugs (`"woocommerce"`, `"blocks"`, `"ai"`) to automatically discover matching plugins and extract their profiles and user reviews.

***

### Input Parameters

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `pluginSlugsOrUrls` | `array<string>` | `["woocommerce", "elementor"]` | WordPress.org plugin slugs or full URLs. |
| `searchQueries` | `array<string>` | `[]` | Optional keywords to discover plugins via WordPress.org API. |
| `tagSlugs` | `array<string>` | `[]` | Optional plugin tags (e.g. `"woocommerce"`, `"ai"`). |
| `maxPluginsPerQuery` | `integer` | `25` | Max plugins to discover per search query or tag. |
| `scrapePluginProfiles` | `boolean` | `true` | Extract full plugin profile, installs, and support metrics (`plugin-profile-scraped`). |
| `scrapeReviews` | `boolean` | `true` | Extract user reviews and churn leads (`review-scraped`). |
| `maxReviewsPerPlugin` | `integer` | `20` | Maximum user reviews to extract per plugin. |
| `reviewRatings` | `array<integer>` | `[1, 2]` | Star rating filter (`[1, 2]` for churn leads, or `[]` for all ratings 1–5). |
| `onlyChurnLeads` | `boolean` | `false` | Emit only reviews flagged with `is_churn_lead: true`. |
| `maxSpendUsd` | `number` | `10.0` | Hard budget cap in USD for Pay-Per-Event billing. |

***

### Pre-Configured Task Templates (1-Click Workflows)

Run specialized configurations of this Actor directly on Apify Store:

- **[`WooCommerce & WordPress Plugin Active Installs & Developer Leads Scraper`](https://apify.com/storeintel/woocommerce-plugin-active-installs-leads-scraper)**
- **[`WordPress Plugin 1-Star Reviews & Competitor Churn Scraper`](https://apify.com/storeintel/wordpress-plugin-1-star-reviews-churn-scraper)**
- **[`Abandoned WordPress Plugins & Unresolved Support Threads Finder`](https://apify.com/storeintel/wordpress-abandoned-plugin-unresolved-support-finder)**

***

### How to Automate in Clay.com, n8n & Make.com (1-Click Templates)

- **Open 1-Click Shared Clay.com Workbook Template:** [`https://app.clay.com/shared-workbook/share_0toe8fdqHgFAJtmU6wQ`](https://app.clay.com/shared-workbook/share_0toe8fdqHgFAJtmU6wQ)
- **Download Ready-to-Import Make.com Scenario Blueprint:** [`04_wordpress-plugin-directory-scraper.blueprint.json`](https://raw.githubusercontent.com/mikrozar-cell/b2b-ecommerce-saas-scrapers-n8n-clay/main/make_blueprints/04_wordpress-plugin-directory-scraper.blueprint.json)
- **Download Ready-to-Import n8n.io Workflow JSON:** [`04_wordpress-plugin-directory-scraper_n8n_workflow.json`](https://raw.githubusercontent.com/mikrozar-cell/b2b-ecommerce-saas-scrapers-n8n-clay/main/n8n_workflows/04_wordpress-plugin-directory-scraper_n8n_workflow.json)
- **Full Automation Hub & Clay.com Recipes Repository:** <https://github.com/mikrozar-cell/b2b-ecommerce-saas-scrapers-n8n-clay>

#### 1. Clay.com (B2B Enrichment Column)

Use the **Apify** enrichment column or **HTTP API** column in Clay to enrich thousands of rows automatically:

- **Method:** `POST`
- **Endpoint:** `https://api.apify.com/v2/acts/storeintel~wordpress-plugin-directory-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN`
- **JSON Body (with dynamic Clay column mapping):**

```json
{
  "pluginSlugsOrUrls": [
    "{{WordPress Plugin Slug}}"
  ],
  "scrapePluginProfiles": true,
  "scrapeReviews": true,
  "maxReviewsPerPlugin": 20,
  "reviewRatingFilter": 1
}
```

#### 2. n8n.io & Make.com Integration

Import the ready-made Blueprint/Workflow JSON above (in Make.com: **Create scenario → More `...` → Import Blueprint**; in n8n: **Import from File/URL**), or add an **Apify — Run an Actor** module pointing to `storeintel/wordpress-plugin-directory-scraper` (`0EbRXhj52ssBU1Rf7`). Because this Actor uses pure async HTTP/JSON with zero headless browser startup delay, synchronous calls (`run-sync-get-dataset-items`) return structured JSON records in **2–6 seconds**.

***

### Explore More StoreIntel Labs B2B Scrapers

Build complete B2B outbound & market intelligence pipelines by combining our 8 high-speed JSON/RPC Actors:

- **[`Shopify & WooCommerce Scraper: Products, Stock & Store Leads`](https://apify.com/storeintel/ecommerce-store-intelligence-scraper)** — E-Commerce & D2C Lead Generation
- **[`Shopify App Store Scraper: Apps, Pricing, Developer Leads & 1-Star Reviews`](https://apify.com/storeintel/shopify-app-store-scraper)** — SaaS Churn & Competitor Intelligence
- **[`Chrome Web Store Scraper: Extensions, Trader Emails, Manifest & Reviews`](https://apify.com/storeintel/chrome-web-store-scraper)** — Browser Extension & Security Intelligence
- **[`Greenhouse, Lever & Ashby ATS Jobs Scraper: Salaries & B2B Tech Stack Signals`](https://apify.com/storeintel/greenhouse-lever-ashby-jobs-scraper)** — B2B Hiring Intent & Tech Stack Intelligence
- **[`Skool Community & Creator Leads Scraper: Estimated MRR, Pricing & Socials`](https://apify.com/storeintel/skool-community-creator-leads-scraper)** — Creator Economy & High-Ticket Agency Leads
- **[`Y Combinator (YC) Startups & Founders Scraper: LinkedIn, X & Batch Data`](https://apify.com/storeintel/y-combinator-startups-founders-scraper)** — Venture & Startup Founder Outbound
- **[`Substack Newsletter Leads, Authors & Posts Scraper: Engagement & Sponsorship Data`](https://apify.com/storeintel/substack-newsletter-leads-posts-scraper)** — Newsletter Sponsorship & Media Outreach

# Actor input Schema

## `pluginSlugsOrUrls` (type: `array`):

List of WordPress.org plugin slugs (e.g. 'woocommerce', 'elementor', 'contact-form-7') or full URLs ('https://wordpress.org/plugins/woocommerce/').

## `searchQueries` (type: `array`):

Optional keywords (e.g. 'woocommerce checkout', 'seo', 'booking calendar') to discover plugins via the WordPress.org API.

## `tagSlugs` (type: `array`):

Optional WordPress plugin tags (e.g. 'woocommerce', 'blocks', 'ai', 'payment-gateway') to discover plugins in a specific tag.

## `maxPluginsPerQuery` (type: `integer`):

Maximum number of plugins to discover per search query or tag.

## `scrapePluginProfiles` (type: `boolean`):

Fetch full plugin metadata, active installs, total downloads, support resolution rate, abandonware risk flag, and commercial URLs (triggers 'plugin-profile-scraped' event).

## `scrapeReviews` (type: `boolean`):

Fetch individual user reviews with star ratings, author profile, reply count, and pain-point classification (triggers 'review-scraped' event).

## `maxReviewsPerPlugin` (type: `integer`):

Maximum number of user reviews to extract per plugin.

## `reviewRatings` (type: `array`):

Filter reviews by star ratings (e.g. \[1, 2] for dissatisfied users and churn leads, or \[] for all ratings 1-5).

## `onlyChurnLeads` (type: `boolean`):

When enabled, only emits reviews flagged with is_churn_lead = true.

## `maxSpendUsd` (type: `number`):

Safety cap in USD for Pay-Per-Event billing.

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

Optional Apify Proxy settings.

## Actor input object example

```json
{
  "pluginSlugsOrUrls": [
    "woocommerce",
    "elementor"
  ],
  "searchQueries": [],
  "tagSlugs": [],
  "maxPluginsPerQuery": 25,
  "scrapePluginProfiles": true,
  "scrapeReviews": true,
  "maxReviewsPerPlugin": 20,
  "reviewRatings": [
    1,
    2
  ],
  "onlyChurnLeads": false,
  "maxSpendUsd": 10,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

Default dataset containing 'plugin_profile' and 'plugin_review' items.

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

Execution statistics and Pay-Per-Event billing summary stored in the default Key-Value Store.

# 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 = {
    "pluginSlugsOrUrls": [
        "woocommerce",
        "elementor"
    ],
    "reviewRatings": [
        1,
        2
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("storeintel/wordpress-plugin-directory-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 = {
    "pluginSlugsOrUrls": [
        "woocommerce",
        "elementor",
    ],
    "reviewRatings": [
        1,
        2,
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("storeintel/wordpress-plugin-directory-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 '{
  "pluginSlugsOrUrls": [
    "woocommerce",
    "elementor"
  ],
  "reviewRatings": [
    1,
    2
  ]
}' |
apify call storeintel/wordpress-plugin-directory-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,storeintel/wordpress-plugin-directory-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/0EbRXhj52ssBU1Rf7/builds/IUvfkb4K0k1e8FyNe/openapi.json