# Shopify App Store Scraper — Apps, Pricing, Emails & Reviews (`foxlabs/shopify-app-store-scraper`) Actor

Scrape Shopify App Store search results, app listings, pricing plans, verified developer support emails, launch dates, and merchant reviews on standard Datacenter proxies.

- **URL**: https://apify.com/foxlabs/shopify-app-store-scraper.md
- **Developed by:** [Berkan Kaplan](https://apify.com/foxlabs) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 shopify apps

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

<p align="center">
  <img src="https://img.shields.io/badge/Pay--Per--Event-Apps_%2B_Merchant_Reviews-00C853?style=for-the-badge" alt="Pay-Per-Event" />&nbsp;
  <img src="https://img.shields.io/badge/SaaS_B2B_Leads-Support_Emails_%C2%B7_Plans_%C2%B7_Badges-2962FF?style=for-the-badge" alt="SaaS B2B Leads" />&nbsp;
  <img src="https://img.shields.io/badge/AI_Agent_Ready-MCP_%26_x402-7C4DFF?style=for-the-badge" alt="MCP & x402 Ready" />&nbsp;
  <img src="https://img.shields.io/badge/Dual_Runtime-Batch_%2B_Standby_API-FF6D00?style=for-the-badge" alt="Batch + Standby API" />
</p>

## Shopify App Store Scraper — Apps, Pricing, Emails & Reviews 🚀

**foXLabs SaaS, E-Commerce & Developer Lead Series:** [Chrome Web Store Scraper](https://apify.com/foxlabs/chrome-web-store-scraper) · [Apple App Store Scraper](https://apify.com/foxlabs/apple-app-store-scraper) · [Amazon Best Sellers Scraper](https://apify.com/foxlabs/amazon-bestsellers-scraper) · [Whop Marketplace Scraper](https://apify.com/foxlabs/whop-marketplace-scraper) · [Google Play Scraper](https://apify.com/foxlabs/google-play-scraper)

🎉 Turn any **Shopify App Store keyword search or `apps.shopify.com/<slug>` URL** into high-converting **38-column SaaS & e-commerce intelligence** — extracting **verified developer `supportEmail` addresses, corporate postal addresses, developer websites, `Built for Shopify` status, launch dates, structured monthly/annual pricing tiers (`pricingPlans[]`), star ratings, review counts and optional paginated merchant reviews (`merchantName`, `merchantCountry`, `usageDuration`, `developerReply`)** in **~6.6 seconds per 15 enriched apps** with **zero login**.

Built for B2B SaaS outbound & partnership teams, Shopify agency/tech-partner BD, micro-PE & SaaS M\&A acquirers, Shopify app founders tracking ASO keyword rankings and e-commerce VoC researchers.

### 🔍 What is the Shopify App Store Scraper — and when should you use it?

Over 10,000 commercial SaaS companies sell directly through the Shopify App Store (`apps.shopify.com`) — and Shopify requires app publishers to disclose **verified developer support emails, developer websites, corporate addresses, launch dates and transparent pricing tiers** publicly on their listings! Meanwhile, every merchant review reveals the **exact Shopify store name (`merchantName`), country (`merchantCountry`) and tenure (`usageDuration`)** of active paying e-commerce brands.

This Actor extracts both **SaaS App Vendor Leads (`rowType: "app"`)** and **E-Commerce Merchant Reviews (`rowType: "review"`)** cleanly inside a `256 MB` HTTP runtime:

- **Keyword ASO Search + Direct App Slug/URL Modes** — track keyword search rankings (`searchQueries: ["email marketing", "upsell", "subscriptions"]`, capturing exact `searchRank`), or audit specific apps via `appUrls` (`"klaviyo-email-marketing"` or full URLs).
- **Full SaaS Vendor Contact & Pricing Enrichment (`enrichAppDetails: true` by default)** — populates `developerName`, `developerWebsiteUrl`, **`supportEmail`**, `developerAddress`, `privacyPolicyUrl`, `faqUrl`, `changelogUrl`, `launchedAt`, `isBuiltForShopify`, `hasFreePlan`, `freeTrialDays`, `minPaidPlanUsd` and itemized `pricingPlans[]` at a flat **`$0.0025` per app**.
- **Optional E-Commerce Merchant Review Mining (`includeReviews: true`, `$0.0008`/review)** — extracts `merchantName`, `merchantCountry`, `usageDuration` (e.g., *"Over 2 years using the app"*), `rating`, `publishedAt`, full review `body` and `developerReply`.

**Use it when you need:** B2B SaaS founder/partner outbound lists with verified `supportEmail` & `developerWebsiteUrl`; micro-PE acquisition deal sourcing (spotting 4.7★+ apps launched 2+ years ago with 100–800 reviews); competitor churn mining (`1–3`★ merchant reviews naming the exact Shopify store `merchantName`!); or daily Shopify App Store ASO rank tracking.

**Use something else when:** you need **browser extension publishers** (use [Chrome Web Store Scraper](https://apify.com/foxlabs/chrome-web-store-scraper)) or **iOS mobile apps** (use [Apple App Store Scraper](https://apify.com/foxlabs/apple-app-store-scraper)).

### 🤖 Use with AI agents (MCP, Claude, Cursor & x402)

**Already connected to the Apify MCP server?** Ask your AI assistant to call `foxlabs/shopify-app-store-scraper`.

- **Hosted MCP URL (zero install):** `https://mcp.apify.com?tools=foxlabs/shopify-app-store-scraper`
- **Local stdio config (Claude Desktop, Cursor, Cline, Windsurf):**

```json
{
  "mcpServers": {
    "shopify-app-store-scraper": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--tools", "foxlabs/shopify-app-store-scraper"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}
```

**Your agent can pay for its own runs.** Using granular pay-per-event pricing (`$0.0025` per `app`, `$0.0008` per `review`, `$0.00` for diagnostic `status` rows), this Actor supports autonomous micropayments over **x402 (USDC on Base)** or **Skyfire** alongside standard Apify tokens.

Copy-paste prompt for Claude, ChatGPT, Cursor or any MCP-enabled assistant:

```text
Use the Apify Actor `foxlabs/shopify-app-store-scraper` to extract Shopify App Store listings, pricing plans, verified developer support emails, launch dates and merchant reviews.

Input fields:
- `searchQueries`: array of Shopify App Store search keywords (e.g. ["upsell", "subscriptions", "loyalty"])
- `appUrls`: optional array of https://apps.shopify.com/<slug> URLs or bare app slugs
- `enrichAppDetails`: boolean (default true) — populates supportEmail, developerWebsiteUrl, developerAddress, launchedAt & pricingPlans[]
- `includeReviews`: boolean (default false) — extracts merchant reviews (`merchantName`, `merchantCountry`, `usageDuration`, `rating`, `body`, `developerReply`)
- `maxReviewsPerApp`: integer 1..200 (default 10; used when includeReviews is true)
- `maxAppsPerQuery`: integer 1..200 (default 15)

Start with:
{"searchQueries":["upsell","bundle"],"enrichAppDetails":true,"includeReviews":true,"maxReviewsPerApp":10,"maxAppsPerQuery":15}
```

**Things you can ask your AI agent:**

- *"Find the top 20 `subscriptions` apps on the Shopify App Store with `enrichAppDetails: true`, and build a comparison table of `name`, `isBuiltForShopify`, `rating`, `reviewCount`, `minPaidPlanUsd`, `supportEmail` and `developerWebsiteUrl`."*
- *"Pull the latest 50 merchant reviews (`includeReviews: true`, `maxReviewsPerApp: 50`) for these 3 competitor Shopify apps (`appUrls`) and list every unhappy US/UK merchant (`rating <= 3`) with their `merchantName` and complaint."*
- *"Spot acquisition candidates in `returns` and `wms`: Shopify apps with `100–600` reviews, `rating >= 4.5` and `minPaidPlanUsd >= 29`."*

The machine-readable Actor summary, MCP metadata and schema live at `https://apify.com/foxlabs/shopify-app-store-scraper.md`.

### 📋 Overview

Everything needed for Shopify SaaS vendor intelligence, ASO rank tracking and e-commerce merchant review mining — in one 38-column dataset.

| Property | Details |
|---|---|
| **Public data source** | Public Shopify App Store search, app pages & `/reviews` pages (`apps.shopify.com`) |
| **Authentication required** | None — zero Shopify Partner account, store login or API keys |
| **Container footprint** | Lightweight `256 MB` HTTP runtime (**6.6s** for 15 detail-enriched apps on verified QA) |
| **Output row types (`rowType`)** | `app` (`$0.0025` / `$2.50 per 1K`), `review` (`$0.0008` / `$0.80 per 1K`), `status` (`$0.00`) |
| **Deduplication & restart safety** | Deterministic `rowKey` (`shopify:app:<slug>` & `shopify:review:<reviewId>`) |
| **Execution modes** | Standard Batch Dataset runs + synchronous Standby HTTP API (`GET /`, `POST /scrape`) |

**Why SaaS founders, agencies & PE teams pick this Actor:**

- 📧 **Verified `supportEmail` + `developerWebsiteUrl` + `developerAddress`** — reach Shopify app founders and partner managers directly without guessing domains.
- 💳 **Structured SaaS `pricingPlans[]` & `minPaidPlanUsd`** — compare free plans (`hasFreePlan`), `freeTrialDays`, entry paid tier (`minPaidPlanUsd`) and full plan feature matrices across any category.
- 🛍️ **Merchant store names (`merchantName`) inside `review` rows** — every merchant review identifies the real Shopify merchant brand, country (`merchantCountry`) and app usage tenure (`usageDuration`) — ideal for competitor churn & tech-stack prospecting!
- 🛡️ **Built-in multi-exit rate-limit resilience** — hardened session rotation handles `apps.shopify.com` bursts automatically at no extra proxy cost.

### ✨ Key Features

- 🏆 **ASO Keyword Rank Tracking (`searchRank`)** — Records exact `1..N` organic keyword rank per `searchQuery` alongside `isBuiltForShopify` badge status, `rating` and `reviewCount`.
- 📅 **Lifecycle & Documentation Links** — Captures `launchedAt` date, `categories[]`, `privacyPolicyUrl`, `faqUrl` and `changelogUrl`.
- 💬 **Merchant VoC + Developer Replies** — Extracts `merchantName`, `merchantCountry`, `usageDuration`, `rating`, `publishedAt`, `body` and `developerReply`.
- ⚡ **Real-Time Standby HTTP (`POST /scrape`)** — Enrich Shopify app slugs live inside Clay, n8n, Make or AI market-research agents.

### 🎬 Quick Start (API & Standby HTTP)

**1. Synchronous Batch API call (returns JSON array directly):**

```bash
curl -X POST "https://api.apify.com/v2/acts/foxlabs~shopify-app-store-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["email marketing"],"enrichAppDetails":true,"includeReviews":false,"maxAppsPerQuery":15}'
```

**2. Real-time Standby HTTP API (`POST /scrape`):**

```bash
curl -X POST "https://foxlabs--shopify-app-store-scraper.apify.actor/scrape?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":[],"appUrls":["bundle-deals"],"enrichAppDetails":true,"includeReviews":true,"maxReviewsPerApp":10}'
```

### 🚀 Getting Started (3 steps)

1. **Enter ASO keywords or Shopify app URLs/slugs** — Add categories/keywords in **Search Queries** (`"email marketing"`, `"upsell"`), or pass exact slugs/URLs in **App URLs** (`"klaviyo-email-marketing"`).
2. **Choose vendor details & merchant reviews** — Keep **`enrichAppDetails: true`** for `supportEmail`, pricing plans & launch dates, and toggle **`includeReviews: true`** (+ `maxReviewsPerApp`) if you also want merchant reviews.
3. **Run & export** — Click **Start** and export your 38-column dataset to Clay, CSV, Excel, HubSpot or BigQuery.

### 📥 Input & Filters

```json
{
  "searchQueries": ["email marketing", "sms marketing"],
  "appUrls": [],
  "enrichAppDetails": true,
  "includeReviews": true,
  "maxReviewsPerApp": 15,
  "maxAppsPerQuery": 20
}
```

| Field | Type | Default | Description |
|---|---|---|---|
| `searchQueries` | `array<string>` | `["email marketing"]` | Keywords to search on the Shopify App Store (`"upsell"`, `"subscriptions"`, `"seo"`, `"reviews"`). |
| `appUrls` | `array<string>` | `[]` | Direct `https://apps.shopify.com/<slug>` URLs or bare slugs (`"klaviyo-email-marketing"`, `"bundle-deals"`). |
| `enrichAppDetails` | `boolean` | `true` | Fetch each app's listing page for verified `supportEmail`, `developerWebsiteUrl`, `developerAddress`, `launchedAt` & `pricingPlans[]`. |
| `includeReviews` | `boolean` | `false` | Also extract paginated merchant reviews (`rowType: "review"`, `$0.0008` each) for every discovered/listed app. |
| `maxReviewsPerApp` | `integer` | `10` | Maximum merchant reviews extracted per app when `includeReviews: true` (`1`–`200`). |
| `maxAppsPerQuery` | `integer` | `15` | Maximum apps extracted per search keyword (`1`–`200`). |
| `proxyConfiguration` | `object` | `{"useApifyProxy": true}` | Managed automatically via Apify Proxy. |

**Copy-paste input recipes:**

- **B2B Shopify SaaS Partner & Founder Lead List (`supportEmail` + `developerWebsiteUrl`):**
  `{"searchQueries":["loyalty","referrals","post purchase upsell","subscriptions"],"enrichAppDetails":true,"includeReviews":false,"maxAppsPerQuery":30}`
- **Competitor Merchant Churn & VoC Review Harvest (`appUrls` + `includeReviews: true`):**
  `{"searchQueries":[],"appUrls":["https://apps.shopify.com/bundle-deals"],"enrichAppDetails":true,"includeReviews":true,"maxReviewsPerApp":100}`
- **Fast Daily ASO Keyword Rank Tracker (`enrichAppDetails: false`):**
  `{"searchQueries":["bundle","quantity breaks","volume discount","bogo"],"enrichAppDetails":false,"includeReviews":false,"maxAppsPerQuery":50}`

### 📤 Output Schema & Real Sample Record

Each item carries `rowType` (`"app"`, `"review"` or free diagnostic `"status"`) and deterministic `rowKey` (`shopify:app:<slug>` or `shopify:review:<reviewId>`).

| Field Group | Fields (38 Columns Total) |
|---|---|
| **App Identity & ASO (`app`)** | `rowKey`, `rowType`, `slug`, `url`, `name`, `tagline`, `description`, `iconUrl`, `categories[]`, `isBuiltForShopify`, `launchedAt`, `searchQuery`, `searchRank`, `scrapedAt` |
| **Ratings & Pricing Plans** | `rating`, `reviewCount`, `pricingSummary`, `hasFreePlan`, `freeTrialDays`, `minPaidPlanUsd`, `pricingPlans[]` |
| **Developer Contacts & Legal** | `developerName`, `developerUrl`, `developerWebsiteUrl`, `supportEmail`, `developerAddress`, `privacyPolicyUrl`, `faqUrl`, `changelogUrl` |
| **Merchant Reviews (`review`)** | `reviewId`, `appSlug`, `appUrl`, `merchantName`, `merchantCountry`, `usageDuration`, `rating`, `publishedAt`, `body`, `developerReply` |

#### Real sample records (from verified platform QA run `lv0A9JeMwanGR5zzM` & pre-publish run `oET6mcOOsL54hqZ6C`, 2026-11-14)

```json
[
  {
    "rowKey": "shopify:app:bundle-deals",
    "rowType": "app",
    "slug": "bundle-deals",
    "url": "https://apps.shopify.com/bundle-deals",
    "name": "Kaching Bundles App & Upsells",
    "tagline": "Boost AOV with quantity breaks, product bundles & upsell app",
    "description": "Create high-converting volume discounts, BOGO offers, and product bundles native to your Shopify theme...",
    "developerName": "Kaching Appz",
    "developerUrl": "https://apps.shopify.com/partners/kaching-appz",
    "developerWebsiteUrl": "https://kachingappz.com",
    "supportEmail": "support@kachingappz.com",
    "privacyPolicyUrl": "https://kachingappz.com/privacy-policy",
    "faqUrl": null,
    "changelogUrl": null,
    "developerAddress": "Vilnius, Lithuania",
    "rating": 5,
    "reviewCount": 6732,
    "launchedAt": "May 16, 2022",
    "isBuiltForShopify": true,
    "pricingSummary": "Free plan available. 14-day free trial.",
    "hasFreePlan": true,
    "freeTrialDays": 14,
    "minPaidPlanUsd": 14.99,
    "pricingPlans": [
      {
        "name": "Basic Monthly",
        "price": "$14.99/month"
      },
      {
        "name": "Scale",
        "price": "$29.99/month"
      }
    ],
    "categories": [
      "Product bundles",
      "Upsell and cross-sell"
    ],
    "iconUrl": "https://cdn.shopify.com/app-store/listing_images/74f3a88ca9004748ce9210ea2cda82ca/icon/CMKZ_Z_RoowDEAE=.png",
    "searchQuery": "upsell",
    "searchRank": 1,
    "scrapedAt": "2026-11-14T05:19:01.076Z"
  },
  {
    "rowKey": "shopify:review:2429040",
    "rowType": "review",
    "reviewId": "2429040",
    "appSlug": "bundle-deals",
    "appUrl": "https://apps.shopify.com/bundle-deals",
    "merchantName": "Melt Your Heart",
    "merchantCountry": "United States",
    "usageDuration": "About 2 years using the app",
    "rating": 5,
    "publishedAt": "November 13, 2026",
    "body": "Kaching Bundles and Kaching Cart are both so easy to use and have helped increase our average order value. The support is amazing—I got help almost immediately, and Dominykas fixed my issue within minutes. Highly recommend both!",
    "developerReply": null,
    "scrapedAt": "2026-11-14T05:19:01.782Z"
  }
]
```

Every completed run also writes a `SOURCE_REPORT` telemetry summary to the default Key-Value Store.

### 🧪 Data Quality — Measured

Verified on the Apify platform across QA runs (`lv0A9JeMwanGR5zzM`, `P2_fast_search_30`) and pre-publish live billing verification (`oET6mcOOsL54hqZ6C` on 2026-11-14):

- **100% app & review uniqueness:** Deduplicated by `shopify:app:<slug>` and `shopify:review:<reviewId>` across overlapping ASO keywords (`30/30` unique apps verified, `0` duplicates).
- **High-yield SaaS contact & pricing extraction:** Enriched run `lv0A9JeMwanGR5zzM` (`15` email-marketing apps) completed in `6.6s` populating verified `supportEmail`, `developerWebsiteUrl`, `launchedAt` and `pricingPlans[]`.
- **Verified two-event PPE billing:** Settled `chargedEventCounts` on run `oET6mcOOsL54hqZ6C` matched `app` (`$0.0025`) and `review` (`$0.0008`) rows `1:1`, with diagnostic `status` rows at `$0.00`.

### ⏱️ Performance — Measured

Measured on the Apify platform at the default **`256 MB`** memory tier:

- **6.6 seconds for 15 detail-enriched Shopify apps:** Platform QA run `lv0A9JeMwanGR5zzM` finished in **`6.6s`** inside `256 MB` RAM with zero headless browser overhead.
- **Resilient against `HTTP 429` bursts:** Built-in multi-session exit rotation handles shared IP rate limits seamlessly.

### 💼 Use Cases

1. **Competitor Merchant Churn & Installed-Base Lead Generation (`includeReviews: true`)**
   - *Input:* `{"searchQueries":[],"appUrls":["klaviyo-email-marketing","yotpo-social-reviews"],"includeReviews":true,"maxReviewsPerApp":100}`
   - *Output:* Exact `merchantName` (Shopify store brand), `merchantCountry`, `usageDuration`, `rating` and complaint text.
   - *Business action:* Match `merchantName` to the store's domain in Clay/Google and pitch merchants who just left `1–3`★ reviews complaining about competitor price hikes or support!

2. **B2B SaaS Tech-Partnership & Co-Marketing Outbound**
   - *Input:* `{"searchQueries":["subscriptions","loyalty","helpdesk","returns"],"enrichAppDetails":true,"maxAppsPerQuery":40}`
   - *Output:* `developerName`, `supportEmail`, `developerWebsiteUrl`, `isBuiltForShopify`, `reviewCount` and `launchedAt`.
   - *Business action:* Build integration partner pipelines across complementary Shopify app ecosystems.

3. **Micro-PE & SaaS Roll-Up Acquisition Sourcing**
   - *Input:* Sweep 20 B2B merchant categories with `enrichAppDetails: true`.
   - *Output:* Filter independent developers with `reviewCount` between `80` and `800`, `rating >= 4.6`, `minPaidPlanUsd >= 19` and `launchedAt` > 2 years ago.
   - *Business action:* Reach cash-flowing Shopify app founders directly before brokered listings hit Acquire.com.

4. **Daily Shopify App Store ASO Rank & Badge Monitoring**
   - *Input:* Daily scheduled run across your target 15 keywords (`enrichAppDetails: false`).
   - *Output:* Daily `searchRank`, `rating`, `reviewCount` and `isBuiltForShopify` shifts across your app and top 10 rivals.
   - *Business action:* Measure immediate ASO rank impact after listing title, icon or pricing changes.

### 🔗 Integrations (Node.js, Python, n8n, Make & Clay)

#### JavaScript / Node.js (`apify-client`)

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('foxlabs/shopify-app-store-scraper').call({
    searchQueries: ['upsell'],
    enrichAppDetails: true,
    includeReviews: true,
    maxReviewsPerApp: 10,
    maxAppsPerQuery: 15,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Fetched ${items.length} Shopify apps & merchant reviews`, items[0]);
```

#### Python (`apify-client` v3)

```python
import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("foxlabs/shopify-app-store-scraper").call(
    run_input={
        "searchQueries": ["email marketing"],
        "enrichAppDetails": True,
        "includeReviews": False,
        "maxAppsPerQuery": 15,
    }
)

for item in client.dataset(run.default_dataset_id).iterate_items():
    if item["rowType"] == "app":
        print(item["name"], "|", item["rating"], f"({item['reviewCount']})", "| Email:", item["supportEmail"])
```

*(Written for `apify-client` v3 where `call()` returns a `Run` object exposing `run.default_dataset_id`; on `apify-client` v1/v2 use `run["defaultDatasetId"]`.)*

#### n8n, Make, Zapier & Clay

- **Competitor 1-Star Review Slack Alert (n8n / Make):** Schedule daily on rival `appUrls` (`includeReviews: true`, `maxReviewsPerApp: 20`) → deduplicate by `reviewId` → push new `1–3`★ reviews (`merchantName`, `merchantCountry`, `body`) straight to your sales team's Slack channel!

### 📊 Pricing (Pay-Per-Event)

Granular two-event **Pay-Per-Event (PPE)** pricing — full developer email & pricing enrichment (`enrichAppDetails: true`) is included inside `$0.0025` per app:

| Event Name | Trigger | Price per Item | Price per 1,000 |
|---|---|---|---|
| `app` | Once per unique Shopify App Store listing (`rowType: "app"`, including `enrichAppDetails`) | **$0.0025** | **$2.50 / 1,000** |
| `review` | Once per unique Shopify merchant review when `includeReviews: true` (`rowType: "review"`) | **$0.0008** | **$0.80 / 1,000** |
| `status` *(diagnostic)* | Empty input, removed/invalid app slug, or zero-match query note | **$0.00 (Free)** | **$0.00** |

**Worked cost examples:**

- **100 Shopify apps with `supportEmail`, website & pricing plans (`includeReviews: false`):** `100 × $0.0025` = **$0.25**
- **10 competitor apps + 100 merchant reviews each (`1,000` reviews):** `(10 × $0.0025) + (1,000 × $0.0008)` = **$0.825**
- **1,000 enriched Shopify apps:** `1,000 × $0.0025` = **$2.50**

**Billing guarantees:**

- **Detail enrichment included free:** `enrichAppDetails: true` (default) carries zero extra event charge beyond `$0.0025`.
- **Proxy protection included:** Automatic multi-exit proxy rotation is included inside the per-event price above.
- **Exact spend cap support:** Configure **Maximum cost per run** in Apify options; `ChargingManager` halts cleanly at your budget limit. *(Note: if Apify applies its platform `apify-actor-start` fee on your plan, that start event applies when a run starts, including zero-result runs.)*

### ❓ Frequently Asked Questions (FAQ)

#### Do I need a Shopify Partner account, store login, or external proxies?

No. All public Shopify App Store search pages, app detail listings and `/reviews` feeds are collected keylessly on our managed infrastructure with automatic session rotation — zero Shopify credentials, API keys or user-supplied proxies required from you.

#### Does `enrichAppDetails: true` cost more than `enrichAppDetails: false`?

No! Both modes trigger the exact same `app` event (`$0.0025` / `$2.50 per 1,000`), which is why `enrichAppDetails` is enabled (`true`) by default. You only set `enrichAppDetails: false` when running ultra-fast ASO rank checks where you only need `name`, `slug`, `tagline`, `rating`, `reviewCount`, `pricingSummary`, `isBuiltForShopify` and `searchRank`.

#### Where does `supportEmail` come from, and how reliable is it?

Shopify requires commercial app developers to publish a verified customer/partner support email address and developer contact block on their public `apps.shopify.com/<slug>` listing. When `enrichAppDetails: true` is active, the Actor extracts that exact `supportEmail`, `developerWebsiteUrl`, `developerAddress` and `privacyPolicyUrl` directly from the app's official Support disclosure.

#### How can I use `review` rows (`includeReviews: true`) to find paying Shopify stores?

Unlike anonymous consumer app stores, Shopify App Store reviews display the **actual store brand name (`merchantName`)**, **merchant country (`merchantCountry`)**, and **how long that store has had the app installed (`usageDuration`, e.g., `"Over 3 years using the app"`)**. Combining `merchantName` + `merchantCountry` in Clay or Google Search resolves the exact `.com` / `.myshopify.com` storefront in seconds!

#### How do I scrape only specific competitor `appUrls` without running the default `"email marketing"` search?

Clear the prefilled `"email marketing"` entry in **Search Queries** inside Apify Console, or pass `"searchQueries": []` in your JSON payload alongside `"appUrls": ["klaviyo-email-marketing", "bundle-deals"]`. You can pass either full `https://apps.shopify.com/<slug>` URLs or bare app slugs.

#### How are `pricingPlans[]`, `hasFreePlan` and `minPaidPlanUsd` structured?

When `enrichAppDetails: true` is enabled, `pricingPlans[]` captures each public plan tier card published on the app page (up to 4 Shopify pricing tiers with plan names, monthly/annual prices and feature highlights), `hasFreePlan` flags free-forever / free-to-install tiers, `freeTrialDays` parses trial durations, and `minPaidPlanUsd` extracts the lowest numeric monthly USD subscription price (`null` when free-only or usage-only).

#### What is `isBuiltForShopify` and why does it matter for ASO and B2B sales?

`Built for Shopify` is Shopify's highest technical & UX quality certification badge (requiring embedded App Bridge performance, strong merchant ratings and strict review benchmarks), which grants priority placement in Shopify App Store search. Tracking `isBuiltForShopify` identifies elite engineering-led SaaS vendors.

#### What happens if the same Shopify app ranks for multiple keywords in `searchQueries`?

Deterministic `shopify:app:<slug>` deduplication ensures that if an app like Klaviyo ranks for both `"email marketing"` and `"sms marketing"`, it is written to the Dataset and billed **only once** per run (recording the first `searchQuery` and `searchRank` that discovered it).

#### Why is `minPaidPlanUsd` or `freeTrialDays` `null` on "Free to install" apps?

Many Shopify apps (such as print-on-demand, dropshipping, ad-pixel or revenue-share upsell apps) charge `$0/month` base subscription (`hasFreePlan: true`) and monetize via transaction fees or external ad spend without fixed monthly USD plan cards. Those apps emit `minPaidPlanUsd: null` rather than a misleading `0` paid plan price.

#### How does the Actor handle `apps.shopify.com` rate limiting (`HTTP 429`) on large runs?

`apps.shopify.com` enforces strict per-IP request budgets on rapid detail & review pagination. The Actor automatically rotates across fresh proxy sessions with exponential backoff and multi-tier fallback so multi-keyword and multi-page review runs complete reliably without user intervention.

#### Can AI agents and Clay workflows call this Actor synchronously?

Yes. Connect Claude Desktop, Cursor, Windsurf or custom MCP agents to `https://mcp.apify.com?tools=foxlabs/shopify-app-store-scraper`, or `POST` JSON requests directly to `https://foxlabs--shopify-app-store-scraper.apify.actor/scrape` in Apify Standby mode for real-time JSON responses.

#### Is the Actor protected against duplicate rows and double charges on container restarts?

Yes. On startup, the Actor inspects the active run's Dataset, hydrates all previously delivered `shopify:app:<slug>` and `shopify:review:<reviewId>` keys into memory, and skips any app or review already emitted prior to a container migration or restart.

### 🐛 Troubleshooting

- **`supportEmail`, `developerWebsiteUrl` and `pricingPlans` are `null` / `[]`:** Check that `"enrichAppDetails": true` (default) is enabled!
- **No `rowType: "review"` items in Dataset:** `"includeReviews"` defaults to `false` so vendor-only scrapes stay ultra-fast; set `"includeReviews": true` and `"maxReviewsPerApp": 25` to collect merchant reviews.
- **Default `"email marketing"` ran alongside `appUrls`:** Pass `"searchQueries": []` when running specific `appUrls` alone.
- **Unlisted/delisted app slug returned a `status` row:** Delisted apps emit a free diagnostic `status` row while all valid apps in your batch finish normally.

### 🚧 What It Does Not Do

- Does **not** scrape individual Shopify merchant storefronts' product catalogs (this Actor scrapes the `apps.shopify.com` SaaS marketplace & merchant app reviews).
- Does **not** log into Shopify Partner dashboards or expose private install counts (Shopify publishes `reviewCount` publicly rather than raw active install counts; use review count × 8–15× industry multiples for install estimation).

### ⚠️ Trademark Notice

This Actor is an independent software tool built by **foXLabs** and is not affiliated with, endorsed by, or sponsored by Shopify Inc. "Shopify" and "Built for Shopify" are registered trademarks of Shopify Inc., referenced strictly to describe compatibility with publicly accessible web pages.

### ⚖️ Is It Legal to Scrape Public Shopify App Store Data?

This Actor accesses only publicly published SaaS marketplace listings, mandatory developer contact disclosures and public merchant reviews visible to unauthenticated web visitors — without logging into accounts or bypassing authentication. Ensure B2B outreach to developer `supportEmail` addresses complies with CAN-SPAM, GDPR and applicable commercial communication laws.

### 🤝 Support, Custom Data & Contact

- 🌐 **Website & full portfolio:** [data.foxlabs.com.tr](https://data.foxlabs.com.tr)
- 📧 **Custom data & enterprise inquiries:** info@foxlabs.com.tr
- 🐛 **Bug reports & feature requests:** open an issue in the Actor's **Issues** tab on Apify Store (include your Run ID)
- 🧰 **Browse all foXLabs Actors:** [apify.com/foxlabs](https://apify.com/foxlabs)

### Changelog

#### 0.1.3 (2026-11-14)

- Upgraded Store README to full SIÁN standard with MCP & x402 AI agent configuration, Standby HTTP `POST /scrape` examples, verified QA & PPE billing metrics, worked cost tables, and expanded 12-question FAQ.

#### 0.1.2 (2026-11-14)

- Hardened multi-session proxy rotation and automatic rate-limit recovery against `HTTP 429` bursts on `apps.shopify.com`.

#### 0.1.0 (2026-11-13)

- Initial release of `foxlabs/shopify-app-store-scraper` supporting keyword search, direct `appUrls`/slugs, verified developer `supportEmail` & pricing plan extraction, merchant reviews, and Batch + Standby HTTP modes.

# Changelog

This Actor's version history is a separate document: https://apify.com/foxlabs/shopify-app-store-scraper/changelog.md

# Actor input Schema

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

Keywords to search on the Shopify App Store (e.g. 'email marketing', 'upsell', 'subscriptions', 'seo').

## `appUrls` (type: `array`):

Direct Shopify App Store URLs (e.g. 'https://apps.shopify.com/klaviyo-email-marketing') or slugs ('klaviyo-email-marketing').

## `enrichAppDetails` (type: `boolean`):

Fetch each app's listing page to extract verified developer supportEmail, postal address, launch date, website, privacy policy, and structured pricing plans.

## `includeReviews` (type: `boolean`):

Also extract merchant reviews (merchant name, country, usage duration, rating, review text, developer reply) for each app.

## `maxReviewsPerApp` (type: `integer`):

Maximum merchant reviews to extract per app when includeReviews is true (1–200).

## `maxAppsPerQuery` (type: `integer`):

Maximum apps to extract per search keyword (1–200).

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

Apify Proxy settings. Runs reliably on standard Datacenter proxies.

## Actor input object example

```json
{
  "searchQueries": [
    "email marketing"
  ],
  "appUrls": [],
  "enrichAppDetails": true,
  "includeReviews": false,
  "maxReviewsPerApp": 10,
  "maxAppsPerQuery": 15,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

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

No description

## `sourceReport` (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 = {
    "searchQueries": [
        "email marketing"
    ],
    "enrichAppDetails": true,
    "maxAppsPerQuery": 15
};

// Run the Actor and wait for it to finish
const run = await client.actor("foxlabs/shopify-app-store-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 = {
    "searchQueries": ["email marketing"],
    "enrichAppDetails": True,
    "maxAppsPerQuery": 15,
}

# Run the Actor and wait for it to finish
run = client.actor("foxlabs/shopify-app-store-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 '{
  "searchQueries": [
    "email marketing"
  ],
  "enrichAppDetails": true,
  "maxAppsPerQuery": 15
}' |
apify call foxlabs/shopify-app-store-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,foxlabs/shopify-app-store-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/ssgc8cmA2wUXOuSok/builds/8zZhTgln5Md5kgYUf/openapi.json
