# ShopifyChurn AI — Shopify App Reviews & Churn Radar (`automation_studio/shopify-app-review-churn-radar`) Actor

Scrape Shopify App Store reviews, analyze competitor merchant churn, identify negative review motives (price hikes, bugs, support failures), and generate competitive sales angles.

- **URL**: https://apify.com/automation\_studio/shopify-app-review-churn-radar.md
- **Developed by:** [Automation Studio](https://apify.com/automation_studio) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 shopify merchant 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

## 🛍️ ShopifyChurn AI — Shopify App Reviews & Competitor Churn Radar

> **Monitor competitor Shopify apps, extract merchant profiles, analyze negative reviews, and uncover why high-LTV merchants are churning.**

***

### 💡 What is ShopifyChurn AI?

Over 10,000 SaaS apps compete inside the Shopify App Store ecosystem (*Klaviyo, Loox, PageFly, Gorgias, Judge.me, Yotpo, Omnisend*).

When a merchant gets hit by a sudden price spike, broken checkout code, or non-existent customer support, they leave a detailed **1-star review** on the Shopify App Store.

**ShopifyChurn AI** transforms these public reviews into an **automated competitive displacement engine**, extracting:

- **The Merchant's Profile**: Store name, location, and tenure (*"Over 3 years using the app"*).
- **The Root Churn Cause**: Categorized automatically into **Hidden Fees**, **Storefront Bugs**, **Support Ghosting**, or **Speed Drag**.
- **The Winning Pitch Angle**: A pre-written sales recommendation to win that merchant over to your alternative app.

***

### 🎯 High-Value Use Cases

| Role | How They Win With This Data |
|---|---|
| 🚀 **Shopify App Founders & Sales Reps** | **The Customer Poaching Funnel**: Target merchants who just gave your direct competitor 1 star. Reach out with a tailored message addressing their exact pain point (e.g. *"Saw you had billing surprises with App X — we offer 100% flat pricing with no overages"*). |
| 📊 **Product Managers & Engineers** | **Feature Gap & Roadmap Validation**: Mine 1,000 negative reviews across an entire app category (e.g. Page Builders or Review Apps) to discover the top 3 critical bugs or missing integrations competitors refuse to fix. |
| 💰 **Micro-PE & SaaS Acquirers** | **Due Diligence & Churn Velocity**: Analyze customer satisfaction trends, merchant tenure distribution, and developer response speed before buying a Shopify app. |

***

### ⚡ What Data You Get

For every review scraped, **ShopifyChurn AI** outputs:

- `appName`: Competitor app name (e.g. *Loox Product Reviews & Photos*)
- `storeName`: Verified merchant store name
- `storeLocation`: Merchant country / region
- `usageTenure`: Exact tenure string (*e.g., "Over 5 years using the app"*)
- `isHighLtvMerchant`: Boolean flag (`True` if merchant was an established user for 6+ months)
- `rating`: 1 to 5 star rating
- `reviewDate`: Review publication date
- `reviewBody`: Full text of the merchant's review
- `churnCategory`: Primary detected complaint (*Hidden Fees, Storefront Bugs, Support Ghosting, Performance Drag*)
- `churnSeverityScore`: Proprietary 1–100 score prioritizing angry high-tenure merchants
- `displacementPitchAngle`: Ready-to-use sales angle for competitor alternatives
- `developerResponse`: Competitor's reply text (if any)
- `reviewUrl`: Direct link to verify on Shopify App Store

***

### 🧠 Churn Motive Classifications

- 💸 **Hidden Fees & Sudden Price Spike**: Price jumps, aggressive tiers, unexpected overage bills.
- 🐛 **Storefront Bug & Broken Checkout**: Corrupted themes, blank screens, lost customer revenue.
- 📵 **Support Ghosting & Unresponsive Help**: Ignored emails, unhelpful automated bots, days without assistance.
- 📉 **Store Speed & Performance Drag**: Heavy Javascript payloads, slow Google Lighthouse scores.
- 🧩 **Missing Features & Integration Gaps**: App limitations, broken third-party sync.

***

### 💰 Pay-Per-Event (PPE) Pricing

| Event | Price |
|---|---|
| 🚀 **Actor Run Start** | **$0.003** |
| 📥 **Per Review Lead Analyzed** | **$0.005** |

*Example: Monitoring 100 recent 1-star reviews on rival apps costs just **$0.50**.*

***

### 🏆 Golden Standard Guarantees

- **100% Authentic Live Reviews**: Direct from `apps.shopify.com` via TLS impersonation (`chrome124`) — **zero synthetic or fake data**.
- **Zero Headless Browser Overhead**: Sub-second HTTP execution with instant responses.
- **Always Up-To-Date**: Captures reviews within minutes of being posted by store owners.

# Actor input Schema

## `app_handles` (type: `array`):

Enter the Shopify App Store handles or full URLs of the competitors you want to monitor (e.g. `loox`, `judgeme`, `pagefly`, `klaviyo`, `gorgias`, `yotpo-social-reviews`, `https://apps.shopify.com/privy`).

## `ratings` (type: `array`):

Select star ratings to extract. For competitor churn intelligence, 1-star and 2-star reviews yield the highest-converting displacement leads.

## `max_reviews_per_app` (type: `integer`):

Maximum number of reviews to extract per app handle in this run. Range: 1 to 1,000.

## `filter_churn_categories` (type: `array`):

Optionally filter exported reviews to specific complaints. Leave empty to capture ALL reviews.

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

Optional: Shopify App Store reviews are public SSR pages. Leave unconfigured for direct TLS connections, or select Apify Proxy for high-volume enterprise crawls.

## Actor input object example

```json
{
  "app_handles": [
    "loox",
    "pagefly"
  ],
  "ratings": [
    "1"
  ],
  "max_reviews_per_app": 20,
  "filter_churn_categories": []
}
```

# Actor output Schema

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

Dataset containing reviews, ratings, merchant store names, usage tenure, churn motives, and displacement sales pitches

# 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 = {
    "app_handles": [
        "loox",
        "pagefly"
    ],
    "ratings": [
        "1"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("automation_studio/shopify-app-review-churn-radar").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 = {
    "app_handles": [
        "loox",
        "pagefly",
    ],
    "ratings": ["1"],
}

# Run the Actor and wait for it to finish
run = client.actor("automation_studio/shopify-app-review-churn-radar").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 '{
  "app_handles": [
    "loox",
    "pagefly"
  ],
  "ratings": [
    "1"
  ]
}' |
apify call automation_studio/shopify-app-review-churn-radar --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automation_studio/shopify-app-review-churn-radar"
        }
    }
}
```

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/Vk7ldx5LJlVeIlxkg/builds/CAfL5WOE3YZ2Chuer/openapi.json
