# Shopify App Store Reviews Scraper: Ratings, Text & Replies (`webobsidians/shopify-app-store-reviews-scraper`) Actor

Scrape the reviews of any Shopify App Store app without a login: star rating, date, review text, store name, country, time using the app and the developer's reply. Filter by stars or date, and use the built-in monitor to get only new reviews.

- **URL**: https://apify.com/webobsidians/shopify-app-store-reviews-scraper.md
- **Developed by:** [Web Obsidians](https://apify.com/webobsidians) (community)
- **Categories:** E-commerce, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 reviews

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

## Shopify App Store Reviews Scraper

Get the **reviews of any Shopify App Store app** in one clean format: star rating, date, review text, store name, country, how long the store has used the app, and the developer's reply. Paste app handles or links, keep only the star ratings you care about, set a date range, and download the result.

Turn on **Return only new reviews** and schedule the Actor: each run returns only the reviews that earlier runs did not return.

### Why this Actor

- **No login, no API key.** It reads the public review pages of apps.shopify.com, newest first.
- **The full review, not just the stars.** Text, store name, country, time using the app, and the developer's reply with its date.
- **Star filters.** Keep only 1 and 2 star reviews to study complaints, or only 5 star reviews to collect praise.
- **App summary included.** The app name, average rating and total number of reviews are saved for every app.
- **Monitoring built in.** The monitor remembers which reviews it returned and gives you only new ones on the next run.
- **Cheap and predictable.** $1.00 per 1,000 reviews, plus $0.00005 per run start. Platform usage is included.

### Use cases

- **Competitor research:** read what merchants love and hate about the apps you compete with.
- **Product feedback:** track new reviews of your own app and send each one to Slack or a ticket system.
- **Lead generation:** see which stores use an app and how long they have used it.
- **Market research and AI analysis:** feed review text into your own sentiment or topic analysis.

### How to use

1. Add **Apps**, one per line: a handle such as `judgeme` or a link such as `https://apps.shopify.com/klaviyo-email-marketing`.
2. Optionally set how many reviews you want per app, star ratings, or a date range.
3. Click **Start**. Download the results as JSON, CSV or Excel, or send them on with Apify integrations and webhooks.

#### Input example

This is the input of a real run of this Actor:

```json
{
  "apps": ["judgeme", "klaviyo-email-marketing"],
  "maxReviewsPerApp": 20
}
```

#### Get only new reviews every day

Set **Return only new reviews** to on and give the monitor a name (for example `competitors`). Then create a schedule in Apify Console. The first run returns the reviews it finds; each later run returns only reviews that earlier runs with the same monitor name did not return. You pay only for the reviews that are returned.

### Output

Each review is one item in the dataset. This is a real item from a run of this Actor (a review written in Dutch):

```json
{
  "app": "klaviyo-email-marketing",
  "appName": "Klaviyo: Email Marketing & SMS",
  "reviewId": "2435048",
  "rating": 1,
  "date": "2026-11-19",
  "text": "logo wat jullie maken voor me email klopt niet met mijn chelsys.nl",
  "storeName": "chelsy's",
  "country": "Netherlands",
  "usageDuration": "1 day using the app",
  "developerReply": "Hallo, bedankt dat u uw feedback met ons deelt. Het spijt ons te horen dat het logo in uw e-mails niet overeenkomt met wat u verwacht. Een Senior Product Expert heeft rechtstreeks contact met u opgenomen. We kijken ernaar uit om met u samen te werken.",
  "developerReplyDate": "2026-11-20",
  "url": "https://apps.shopify.com/klaviyo-email-marketing/reviews/2435048",
  "scrapedAt": "2026-11-20T08:40:02Z"
}
```

Field notes:

- `rating` is 1 to 5 stars. `date` and `developerReplyDate` are the days shown on the review page.
- `text` is `null` for star-only reviews: many merchants leave a rating without writing anything.
- `usageDuration` is the store's own "time using the app" line, or `null` when the store does not show it.
- `developerReply` is `null` when the developer has not replied.
- A per-app summary (name, average rating, total reviews, reviews returned and any error) is saved to the key-value store as `SUMMARY`.

### Pricing

This Actor uses pay-per-event pricing:

- **$1.00 per 1,000 reviews** saved to the dataset ($0.001 per review).
- **$0.00005 per run start.**

Platform usage is included. For example, 500 reviews cost about $0.50. If you set a maximum cost per run, the Actor stops cleanly when it is reached.

### FAQ

**Which apps work?**
Any app with a public page on apps.shopify.com. An app handle that does not exist is reported in `SUMMARY` with an error and costs nothing.

**Do I need a Shopify account?**
No. The Actor reads the same review pages that anyone can open without logging in.

**In which order are reviews returned?**
Newest first. With a date range, the Actor stops reading as soon as it reaches reviews older than `dateFrom`.

**How many reviews can I get?**
Up to 5,000 reviews per app in one run. The store shows 10 reviews per page and the Actor pauses briefly between pages, so a large run takes a few minutes.

# Actor input Schema

## `apps` (type: `array`):

One app per line: its handle (judgeme) or its link (https://apps.shopify.com/judgeme).

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

Stop after this many reviews per app, newest first. 0 means no limit, but at most 5,000 reviews per app in one run.

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

Keep only reviews with these star ratings, for example 1 and 2 for the negative ones. Empty keeps all.

## `dateFrom` (type: `string`):

Skip reviews older than this day. Format YYYY-MM-DD.

## `dateTo` (type: `string`):

Skip reviews newer than this day (this day is included). Format YYYY-MM-DD.

## `onlyNewReviews` (type: `boolean`):

Return only reviews that earlier runs with the same monitor name did not return. The first run returns everything it finds.

## `monitorName` (type: `string`):

Use different names to keep separate histories, for example one per competitor.

## Actor input object example

```json
{
  "apps": [
    "judgeme",
    "klaviyo-email-marketing"
  ],
  "maxReviewsPerApp": 20,
  "onlyNewReviews": false,
  "monitorName": "default"
}
```

# Actor output Schema

## `reviews` (type: `string`):

No description

## `summary` (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 = {
    "apps": [
        "judgeme",
        "klaviyo-email-marketing"
    ],
    "maxReviewsPerApp": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("webobsidians/shopify-app-store-reviews-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 = {
    "apps": [
        "judgeme",
        "klaviyo-email-marketing",
    ],
    "maxReviewsPerApp": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("webobsidians/shopify-app-store-reviews-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 '{
  "apps": [
    "judgeme",
    "klaviyo-email-marketing"
  ],
  "maxReviewsPerApp": 20
}' |
apify call webobsidians/shopify-app-store-reviews-scraper --silent --output-dataset

```

## MCP server setup

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