🏛️ Shopify App Store Reviews & Unhappy Merchant Lead Extractor

Extract 1-star and 2-star reviews from top Shopify apps with merchant store names, pain point classifications, and competitor poaching signals.

---

🥊 Why This Actor Beats the Competition

Feature	Tillzero Actor	Standard Web Scrapers / Legacy Bots
Speed & Throughput	⚡ Direct API & high-throughput streams (sub-5s runs)	🐢 Heavy browser Puppeteer overhead (45s+ per query)
Pricing Transparency	💰 Pay-Per-Result ($3.00 / 1k items)	💸 Expensive $49–$99/month subscriptions or compute lock-in
Data Quality & Schemas	🛡️ Strictly typed, validated ISO 8601 JSON	❌ Raw messy HTML dumps with missing columns
Bot Protection & Proxies	🌐 Built-in smart rotation and residential resilience	🚫 Frequent Cloudflare/Akamai 403 blocking

---

🛠️ Step-by-Step: How to Use

Method 1: Apify Web Console

1. Navigate to the Actor page in the Apify Store.
2. Configure your search parameters in the intuitive Web UI.
3. Click Start to run the scraper and export results to CSV, Excel, or JSON.

Method 2: Python SDK

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("litezero/shopify-app-store-reviews-scraper").call(run_input={"appSlug": "klaviyo", "maxReviews": 5})

dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items
print(f"Extracted {len(dataset_items)} items!")

Method 3: Node.js SDK

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('litezero/shopify-app-store-reviews-scraper').call({"appSlug": "klaviyo", "maxReviews": 5});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Extracted ${items.length} items!`);

Method 4: REST API / cURL

curl -X POST "https://api.apify.com/v2/acts/litezero~shopify-app-store-reviews-scraper/runs?token=YOUR_APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"appSlug": "klaviyo", "maxReviews": 5}'

---

📥 Input Parameters

Field	Type	Description	Default
appSlug	String	Slug of the app from apps.shopify.com (e.g. klaviyo, gorgias, pagefly).	klaviyo
maxRating	Integer	Filter reviews by max star rating (1 or 2 for unhappy churn leads, 5 for all).	2
maxReviews	Integer	Maximum reviews to extract.	100

---

📤 Output Data Dictionary & Sample JSON

{
  "appSlug": "klaviyo",
  "storeName": "Velvet & Stone Apparel",
  "reviewerLocation": "Australia",
  "rating": 1,
  "reviewDate": "2026-10-04",
  "headline": "Support took 4 days while our Black Friday campaign was paused",
  "body": "Unacceptable support delay. Looking for an alternative email provider immediately.",
  "developerReply": "We apologize for the delay during high volume hours...",
  "detectedPainPoint": "customer_support_latency",
  "reviewUrl": "https://apps.shopify.com/klaviyo/reviews"
}

---

💡 Top Commercial Use Cases

1. Automated Market Intelligence: Stream fresh data into Slack, Discord, Google Sheets, or Zapier webhooks.
2. Quantitative Research: Feed machine learning models, predictive alphas, and algorithmic trading desks.
3. B2B Growth & Lead Gen: Poach competitors' unhappy users or discover newly funded high-growth targets.