# Competitor Negative Review & Churn Lead Monitor (`obicodes/competitor-review-churn-monitor`) Actor

Monitor competitor 1-to-3 star reviews across Trustpilot, Shopify, WordPress, Atlassian, Apple, Google Play, and Firefox in bulk. Scores churn intent, tags pain points like pricing or support, and deduplicates across 3x/day runs.

- **URL**: https://apify.com/obicodes/competitor-review-churn-monitor.md
- **Developed by:** [Obicodes](https://apify.com/obicodes) (community)
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$20.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.

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

## Competitor Negative Review & Churn Lead Monitor

Find unhappy customers leaving 1-star, 2-star, and 3-star reviews on your competitors' apps and plugins—before they pick another tool.

This actor monitors public competitor reviews across **Trustpilot**, **Shopify App Store**, **WordPress Plugins & Themes**, **Atlassian Marketplace (Jira & Confluence)**, **Apple App Store**, **Google Play Store**, and **Firefox Add-ons**. It uses headless Chrome where needed to load JS-rendered review data, scores each review for buyer switching intent, tags the exact complaint (pricing, broken features, slow support, looking for an alternative), and removes duplicates across scheduled runs so you can run it **3 times a day** without paying twice for the same review.

***

### Who This Is For

- **SaaS Sales Teams & SDRs:** Reach out to businesses that just left a 1-star or 2-star review complaining about your competitor's pricing, bugs, or support.
- **Shopify & WordPress Agencies / App Developers:** Spot merchants and site owners actively looking for a replacement app or plugin.
- **Product & Marketing Teams:** Track competitor weaknesses in real time and turn customer complaints into comparison pages and ad copy.

***

### Why Run It 3 Times a Day

Customers rarely wait around after a bad experience. Running this monitor morning, midday, and evening lets your team:

1. Catch fresh 1-star complaints within hours of posting.
2. See whether the competitor has replied yet (`developerReplied: false`).
3. Automatically skip reviews you already received in earlier runs (`deduplicateAcrossRuns: true`), so you only pay for brand-new leads.

***

### Supported Platforms

Paste any public app URL, or pass a structured object `{ "platform": "...", "target": "..." }`:

| Platform | Example URL | What You Get |
| :--- | :--- | :--- |
| **Trustpilot** | `https://www.trustpilot.com/review/hubspot.com` | Star rating, review title, full text, reviewer name, country, date, and company reply |
| **Shopify App Store** | `https://apps.shopify.com/klaviyo-email-marketing` | Star rating, review text, **merchant store name**, location, how long they used the app, and vendor reply |
| **WordPress Plugins & Themes** | `https://wordpress.org/plugins/elementor/` | Star rating, review title, reviewer username, date, and whether the developer replied |
| **Atlassian Marketplace** | `https://marketplace.atlassian.com/apps/6820/scriptrunner-for-jira` or `com.onresolve.jira.groovy.groovyrunner` | Star rating, hosting type, review text, reviewer name, date, and vendor reply |
| **Apple App Store** | `https://apps.apple.com/us/app/slack/id618783545` | Star rating, review title, review text, reviewer name, country, and date |
| **Google Play Store** | `https://play.google.com/store/apps/details?id=com.Slack` | Star rating, review text, reviewer name, date, and developer reply |
| **Firefox Add-ons** | `https://addons.mozilla.org/en-US/firefox/addon/ublock-origin/` | Star rating, review text, reviewer name, date, and developer reply |

***

### Input Options (Bulk Batching Supported)

| Field | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `targets` | Array | Required | Bulk list of competitor app URLs or `{ "platform", "target", "label" }` objects. |
| `maxStars` | Integer (1–5) | `3` | Maximum star rating to collect. `3` collects 1-star, 2-star, and 3-star reviews. |
| `maxReviewsPerTarget` | Integer (1–200) | `25` | Maximum matching reviews to save per competitor in one run. |
| `sinceHours` | Integer | `0` | Only keep reviews posted in the last N hours (for example, `12` or `24` for 3x/day runs). `0` turns off the age filter. |
| `minChurnScore` | Integer (0–100) | `0` | Only save leads with a churn intent score at or above this number. |
| `onlyUnreplied` | Boolean | `false` | Only save reviews where the competitor has not replied yet. |
| `customKeywords` | Array of strings | `[]` | Extra words or phrases to watch for (for example: `["migration", "csv export", "overcharged"]`). |
| `deduplicateAcrossRuns` | Boolean | `false` | Remembers seen review IDs so repeated runs only output brand-new reviews. |
| `dedupeStoreName` | String | `"competitor-review-churn-seen"` | Name of the Apify Key-Value Store used for deduplication. |
| `concurrency` | Integer (1–10) | `2` | How many competitor targets to check at the same time. |

***

### Example Input

```json
{
  "targets": [
    "https://apps.shopify.com/klaviyo-email-marketing",
    "https://wordpress.org/plugins/elementor/",
    "https://addons.mozilla.org/en-US/firefox/addon/ublock-origin/",
    {
      "platform": "atlassian",
      "target": "com.onresolve.jira.groovy.groovyrunner",
      "label": "ScriptRunner for Jira"
    }
  ],
  "maxStars": 3,
  "maxReviewsPerTarget": 20,
  "sinceHours": 0,
  "minChurnScore": 40,
  "onlyUnreplied": false,
  "customKeywords": ["switching", "too expensive", "support"],
  "deduplicateAcrossRuns": true,
  "concurrency": 2
}
```

***

### Example Output Lead

```json
{
  "platform": "shopify",
  "targetName": "Klaviyo: Email Marketing & SMS",
  "targetSlug": "klaviyo-email-marketing",
  "targetUrl": "https://apps.shopify.com/klaviyo-email-marketing",
  "reviewId": "2415136",
  "rating": 1,
  "title": "",
  "body": "Support never replied to our ticket and pricing doubled. Switching to another app.",
  "reviewerName": "Acme Coffee Roasters",
  "reviewerLocation": "United States",
  "reviewerCompanyOrStore": "Acme Coffee Roasters",
  "timeUsingProduct": "Over 1 year using the app",
  "publishedAt": "2026-11-10T00:00:00.000Z",
  "developerReplied": false,
  "developerReplyText": "",
  "churnScore": 88,
  "intentTier": "critical_churn",
  "painCategories": [
    "looking_for_alternative",
    "pricing_complaint",
    "support_failure"
  ],
  "matchedKeywords": [
    "switching",
    "pricing",
    "never replied"
  ],
  "reviewUrl": "https://apps.shopify.com/klaviyo-email-marketing/reviews?rating=1#review-2415136",
  "scrapedAt": "2026-11-15T14:30:00.000Z"
}
```

***

### How Churn Intent Scoring Works

Every review is scored locally from `0` to `100` (no external AI APIs required):

- **Star Rating:** 1-star (+42), 2-star (+32), 3-star (+18).
- **Pain-Point Signals:** Switching/looking for alternatives (+20), cancellation/refund (+14), pricing complaints (+10), support failures (+10), bugs/crashes (+8), missing features (+6), confusing UX (+5).
- **Custom Keywords:** +8 for each of your custom keywords found.
- **Freshness & Unreplied Status:** +12 if posted within 24 hours, +6 if the vendor has not replied yet.
- **Intent Tiers:** `critical_churn` (75–100), `high_intent` (50–74), `medium_intent` (25–49), `low_intent` (0–24).

***

### Frequently Asked Questions

**Do I need any API keys or logins?**
No. This actor reads public review pages and public marketplace endpoints directly, with zero external API keys.

**How do I avoid paying twice for the same review when running 3 times a day?**
Turn on `deduplicateAcrossRuns: true`. The actor stores seen review IDs in your Apify Key-Value Store and skips them on future runs.

**Can I export leads to HubSpot, Slack, Google Sheets, or Make/n8n?**
Yes. Connect an Apify Webhook on run completion, or pull the dataset directly via the Apify API, Make, Zapier, or n8n.

# Actor input Schema

## `targets` (type: `array`):

List of competitor URLs to monitor. Supports Trustpilot, Shopify App Store, WordPress Plugins & Themes, Atlassian Marketplace, Apple App Store, Google Play Store, and Firefox Add-ons.

## `maxStars` (type: `integer`):

Only keep reviews with this star rating or lower. Set to 3 to capture 1-star, 2-star, and 3-star negative/neutral reviews. Set to 5 to collect all reviews.

## `maxReviewsPerTarget` (type: `integer`):

Maximum number of matching reviews to return per competitor target in a single run.

## `sinceHours` (type: `integer`):

Filter out reviews older than this many hours (e.g., 12 or 24 for 3x/day scheduled runs). Leave 0 to include all recent reviews regardless of age.

## `minChurnScore` (type: `integer`):

Only return leads with a churn intent score at or above this threshold. Set to 0 to return all matching reviews.

## `onlyUnreplied` (type: `boolean`):

When enabled, only returns reviews where the competitor has not posted a developer reply yet.

## `customKeywords` (type: `array`):

Additional words or phrases to watch for in reviews (for example: 'migration', 'export', 'slow', 'overcharged').

## `deduplicateAcrossRuns` (type: `boolean`):

Saves seen review IDs in a named Key-Value Store so repeated runs (such as 3 times per day) only output brand-new reviews.

## `dedupeStoreName` (type: `string`):

Name of the Key-Value Store used to remember seen review IDs when 'Skip Already-Seen Reviews Across Runs' is enabled.

## `concurrency` (type: `integer`):

Number of competitor targets to check at the same time. Keep at 2-3 to avoid rate limits on public review pages.

## Actor input object example

```json
{
  "targets": [
    "https://www.trustpilot.com/review/hubspot.com",
    "https://apps.shopify.com/klaviyo-email-marketing",
    "https://wordpress.org/plugins/elementor/",
    "https://addons.mozilla.org/en-US/firefox/addon/ublock-origin/",
    "https://apps.apple.com/us/app/slack/id618783545",
    "https://play.google.com/store/apps/details?id=com.Slack",
    "https://marketplace.atlassian.com/apps/6820/scriptrunner-for-jira"
  ],
  "maxStars": 3,
  "maxReviewsPerTarget": 25,
  "sinceHours": 0,
  "minChurnScore": 0,
  "onlyUnreplied": false,
  "customKeywords": [
    "switching",
    "too expensive",
    "support"
  ],
  "deduplicateAcrossRuns": false,
  "dedupeStoreName": "competitor-review-churn-seen",
  "concurrency": 2
}
```

# Actor output Schema

## `results` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "targets": [
        "https://www.trustpilot.com/review/hubspot.com",
        "https://apps.shopify.com/klaviyo-email-marketing",
        "https://wordpress.org/plugins/elementor/",
        "https://addons.mozilla.org/en-US/firefox/addon/ublock-origin/",
        "https://apps.apple.com/us/app/slack/id618783545",
        "https://play.google.com/store/apps/details?id=com.Slack",
        "https://marketplace.atlassian.com/apps/6820/scriptrunner-for-jira"
    ],
    "customKeywords": [
        "switching",
        "too expensive",
        "support"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("obicodes/competitor-review-churn-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "targets": [
        "https://www.trustpilot.com/review/hubspot.com",
        "https://apps.shopify.com/klaviyo-email-marketing",
        "https://wordpress.org/plugins/elementor/",
        "https://addons.mozilla.org/en-US/firefox/addon/ublock-origin/",
        "https://apps.apple.com/us/app/slack/id618783545",
        "https://play.google.com/store/apps/details?id=com.Slack",
        "https://marketplace.atlassian.com/apps/6820/scriptrunner-for-jira",
    ],
    "customKeywords": [
        "switching",
        "too expensive",
        "support",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("obicodes/competitor-review-churn-monitor").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 '{
  "targets": [
    "https://www.trustpilot.com/review/hubspot.com",
    "https://apps.shopify.com/klaviyo-email-marketing",
    "https://wordpress.org/plugins/elementor/",
    "https://addons.mozilla.org/en-US/firefox/addon/ublock-origin/",
    "https://apps.apple.com/us/app/slack/id618783545",
    "https://play.google.com/store/apps/details?id=com.Slack",
    "https://marketplace.atlassian.com/apps/6820/scriptrunner-for-jira"
  ],
  "customKeywords": [
    "switching",
    "too expensive",
    "support"
  ]
}' |
apify call obicodes/competitor-review-churn-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,obicodes/competitor-review-churn-monitor"
        }
    }
}
```

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/eQjoC60QToYD6GRIL/builds/nHu730ZYbh4e9fvBD/openapi.json
