# Shopify Product Reviews Scraper API (`lurkapi/shopify-product-reviews-scraper-api`) Actor

Scrape product reviews from Shopify stores. Auto-detects Judge.me, Loox, Okendo, Yotpo, Stamped, Fera, Junip, Ali Reviews, Rivyo, Ryviu, Air/AG Reviews, and TrustWILL review widgets.

- **URL**: https://apify.com/lurkapi/shopify-product-reviews-scraper-api.md
- **Developed by:** [LurkAPI](https://apify.com/lurkapi) (community)
- **Categories:** Agents, Automation, E-commerce
- **Stats:** 3 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Shopify Product Reviews Scraper API

Pull every public review from any Shopify store into one clean spreadsheet, no matter which review widget the store uses. Auto-detects 12 providers. One Actor for a competitor audit across mixed storefronts, a monthly report spanning several clients, or a full review history of a single product. Ready to filter, sort, and download in minutes.

### 🎬 What it does

Paste a Shopify store URL, product URL, or landing page with an embedded review widget. The Actor detects which review app the store uses and returns reviews in a spreadsheet.

**Supported review providers:** Judge.me, Loox, Okendo, Yotpo, Stamped, Fera, Junip, Ali Reviews / Kudosi, Rivyo, Ryviu, Air / AG Reviews, and TrustWILL (Trustoo).

Two kinds of input:

1. **Store URL** returns one summary row per public product on the store, including the SKUs sitting at zero reviews. Good for catalog-wide dashboards, launch-week rating sweeps, and finding the quiet products in your own store.
2. **Product URL** returns every individual review on the exact product. Good for quote pulls, monthly agency reports, and single-SKU deep dives.

Shape the results before you pay for them:

- **Free filters and sorts**: keep any mix of 1 to 5 stars, search review text, keep verified buyers or reviews with media, and sort by most recent, highest rating, lowest rating, most helpful, or featured.
- **Paid photo, video, and reply filters**: photos only, videos only, or reviews the store has publicly replied to.
- **Paid date and language filters**: narrow to a specific date window, or the set of languages you actually read.
- **Paid text or ratings-only**: keep only reviews with written text, or only star ratings without text.
- **Paid custom sort**: pictures first or videos first.
- **Paid enrichments**: tag each review with a detected language, translate reviews into your chosen language, and archive photo and video files to your run storage.

Equivalent versions of the same URL collapse automatically. Locale-prefixed product URLs and the `www.` prefix are normalized. Status rows are always free.

Good for: Shopify founders watching their own reviews week over week, CMOs auditing a competitor's launch quarter, agencies scoring a client roster monthly, and analysts building review datasets they can actually trust.

### 📋 How to use it

#### Step 1: Paste your inputs

Drop any combination into **Start URLs**, one per line. Equivalent URL variants are cleaned up automatically.

- **Store URL**: `https://hexclad.com/`
- **Product URL**: `https://bravelittleones.com/products/cookies-and-milk-zip-romper`

Minimum input, run as-is:

```json
{
  "startUrls": [
    "https://hexclad.com/",
    "https://bravelittleones.com/products/cookies-and-milk-zip-romper"
  ],
  "maxResultsPerUrl": 50
}
```

`maxResultsPerUrl` is the only limit you need. Default 50, max 50,000. For a store URL it caps product summaries. For a product URL it caps reviews.

#### Step 2: Pick filters and add-ons

Free filters and sorts:

- **Star rating filter**: keep any combination of 1 to 5 stars.
- **Keyword search**: only reviews whose title or body contains your phrase.
- **Verified only**: only reviews marked as verified purchases.
- **Any media**: only reviews with a photo or video.
- **Sort order**: Newest, Oldest, Highest rating, Lowest rating, Most helpful, Featured, or Media first.

Paid add-ons (billed only when they actually deliver a row):

- **Specific media filters**: only reviews with a photo or only reviews with a video.
- **Store-reply only**: only reviews the merchant has publicly replied to.
- **Date range**: only reviews posted between two dates.
- **Written vs rating-only**: keep only reviews with text, or only star-ratings without text.
- **Language filter**: only reviews in the languages you pick.
- **Custom sort**: pictures first or videos first.
- **Language detection**: adds a language tag on every review, billed only when detection succeeds.
- **Translation**: translates reviews into your chosen language, billed only when a translation is returned. Same-language reviews are skipped so you are not billed for no-op translations.
- **Media archiving**: downloads and stores up to 10 photos or videos per review (3 MB per file cap), billed only per file stored.

#### Step 3: Run it and get your results

Click **Start**. Rows stream into the Output tab as they come in.

Every row starts with a `status` field. `Success` means the row is real data. Explanatory rows contain a plain-language status plus a stable `error` code such as `no_matching_reviews` or `provider_not_detected`. These rows are never charged.

Download as JSON, CSV, or Excel from the Storage tab, or pull them straight into your app through the Apify API.

### 💰 Pricing

Pay only for results you actually get back. No subscription, no minimum.

| Event | Price | When |
|---|---|---|
| Result delivered | **$1.50 per 1,000 rows** | per product summary or review delivered |
| Add-on: Advanced filter | **$0.50 per 1,000 rows** | per delivered review kept by a post-fetch photo, video, reply, date, content, or language filter |
| Add-on: Custom sort | **$0.50 per 1,000 rows** | per delivered review from a pictures-first or videos-first sort |
| Add-on: Language detected | **$0.50 per 1,000 rows** | per delivered review where the Actor detected the language |
| Add-on: Review translated | **$2.00 per 1,000 rows** | per delivered review that was actually translated |
| Add-on: Media downloaded | **$1.00 per 1,000 files** | per media file archived successfully |

Rating filters, native provider sorts, source photo and video URLs, and status rows are all free.

A base scan is $1.50 per 1,000 rows. A fully enhanced workflow with date filtering, language detection, translation, and media archiving can approach $5 per 1,000 rows depending on the options you turn on.

### 💡 Good to know

- **Auto-detection covers 12 providers**. The Actor probes the storefront for known markers of each supported review widget and runs the matching provider flow. You do not need to know which widget a store uses.
- **Zero-review products are included** on store scans. Your catalog view stays complete, with `reviewCount: 0` on the quiet SKUs.
- **Dedup is automatic**. The same store or product reached through several URL variants (locale prefix, `www.`, trailing slash, extra query strings, mixed case) is fetched once.
- **Provider not supported?** If the page uses a review widget the Actor does not recognize, you get one uncharged status row that explains it. Open a request on the Apify platform to ask for support.
- **Status rows are never charged**. Unsupported providers, empty filtered results, and rejected URLs come back with a stable `error` value that explains the fix.
- **Field coverage matches the source**. If the storefront did not publish a value (for example, reviewer location on many stores), the field comes back `null`. Fields you toggle off in the 📦 Output fields section are omitted from the row entirely.
- **Media limits are strict**. Up to 10 files per review, 3 MB per file. Only real photo and video files are archived.
- **Runs are independent**. No cross-run history is kept. Schedule runs and compare `reviewId` on your side to track what is new.
- Files and datasets live in your Apify storage. How long they are kept depends on your Apify plan.

### ❓ FAQ

**Do I need a Shopify account?**
No. Only publicly published storefront and review data is read.

**What if the store uses a review widget that is not supported?**
You get one uncharged status row that explains what was detected. Open a feature request through the Apify platform and we will add support for it.

**What if a product has no reviews?**
On a store scan you still get the product summary row with `reviewCount: 0` and empty rating fields. On a product scan pointing at a review-less product you get a status row that says no reviews matched.

**Why are some fields null?**
Not every provider publishes every field. `null` means the field was requested but the provider did not expose it. Fields you toggle off are omitted entirely.

**Can I schedule this?**
Yes. Use Apify Schedules to run on any cadence and compare `reviewId` across snapshots to track new reviews.

**Can I export to Excel or Google Sheets?**
Yes. Open the run's Storage tab and pick CSV, Excel, JSON, or one of the other formats.

**Which stores work?**
Any Shopify store whose review widget is powered by one of the 12 supported providers and whose public product catalog is reachable.

**How long are my results stored?**
Results live in your Apify dataset. How long they are kept depends on your Apify plan.

**Why use this instead of a dedicated scraper?**
Use this Actor when you scrape mixed-store lists and do not want to route each URL to the right provider yourself. Use dedicated actors when you want fixed, single-provider behavior for long-running pipelines.

### 🔗 Other tools you might like

- [Shopify Judge.me Reviews Scraper API](https://apify.com/lurkapi/shopify-judge-me-reviews-scraper-api): same job for stores running Judge.me.
- [Shopify Loox Reviews Scraper API](https://apify.com/lurkapi/shopify-loox-reviews-scraper-api): same job for stores running Loox.
- [Shopify Okendo Reviews Scraper API](https://apify.com/lurkapi/shopify-okendo-reviews-scraper-api): same job for stores running Okendo.
- [Shopify Yotpo Reviews Scraper API](https://apify.com/lurkapi/shopify-yotpo-reviews-scraper-api): same job for stores running Yotpo.
- [Shopify Junip Reviews Scraper API](https://apify.com/lurkapi/shopify-junip-reviews-scraper-api): same job for stores running Junip.
- [Shopify Air / AG Product Reviews Scraper API](https://apify.com/lurkapi/shopify-air-ag-product-reviews-scraper-api): same job for stores running Air or AG Product Reviews.
- [Shopify TrustWILL Reviews Scraper API](https://apify.com/lurkapi/shopify-trustwill-reviews-scraper-api): same job for stores running TrustWILL or Trustoo.

### ⚖️ Disclaimer

This tool is intended for personal, research, and educational use. You are responsible for complying with Shopify's Terms of Service, each review provider's terms, and any laws that apply in your jurisdiction. The developer is not liable for misuse. Data availability depends on the storefront's public configuration at run time.

**Keywords:** shopify reviews, shopify product reviews, shopify review scraper, shopify review export, product reviews export, shopify product ratings, review dataset, review analytics, shopify catalog audit, ecommerce review data, review monitoring

# Actor input Schema

## `startUrls` (type: `array`):

Paste a Shopify store URL to get one summary row per public product (including products with zero reviews). Paste a product URL to get reviews for that exact product. The review widget provider is auto-detected. These inputs can be mixed in the same run.

## `maxResultsPerUrl` (type: `integer`):

Cap on rows returned for each input URL. A store URL returns up to this many product summaries; a product URL returns up to this many individual reviews.

## `filterRatings` (type: `array`):

Only keep reviews with the star ratings you pick. Leave empty to include every rating. Free with the base row price.

## `sortBy` (type: `string`):

Sort order for reviews. Most orders are free. Pictures first and videos first count as a custom-sort add-on on providers that do not support them natively.

## `filterKeyword` (type: `string`):

Only keep reviews whose title or body contains this phrase. Free on providers that support native keyword search; charged as an advanced filter otherwise.

## `verifiedOnly` (type: `boolean`):

Only keep reviews marked as verified purchases.

## `onlyWithMedia` (type: `boolean`):

Only keep reviews that include at least one photo or video.

## `onlyWithPhotos` (type: `boolean`):

Only keep reviews that include at least one customer photo.

## `onlyWithVideos` (type: `boolean`):

Only keep reviews that include at least one customer video.

## `merchantReplyOnly` (type: `boolean`):

Only keep reviews the store has publicly replied to.

## `filterStartDate` (type: `string`):

Only keep reviews posted on or after this date (YYYY-MM-DD, inclusive).

## `filterEndDate` (type: `string`):

Only keep reviews posted on or before this date (YYYY-MM-DD, inclusive).

## `reviewContent` (type: `string`):

Keep every review, only reviews that have written text, or only star-ratings without text.

## `filterLanguages` (type: `array`):

Only keep reviews written in these languages. Use short codes like en, es, de, ja, or the 3-letter ISO 639-3 form such as eng, spa, deu, jpn. Enables language detection automatically.

## `detectLanguage` (type: `boolean`):

Add a detectedLanguage field on every review, worked out from the review text. Charged only when a language is detected successfully.

## `translateReviews` (type: `boolean`):

Translate the review title and body into your chosen target language. Same-language reviews (source equals target) are skipped so you are not billed for no-op translations.

## `translationTarget` (type: `string`):

Target language for translations. Use a short code such as en, es, fr, de, ja, or pt-BR.

## `downloadMedia` (type: `boolean`):

Save up to 10 verified photos or direct video files per review (3 MB per file cap) to the run's key-value store. Original source URLs stay in the row either way. Charged per file successfully stored.

## `outputStoreDomain` (type: `boolean`):

Normalized store host, for example bravelittleones.com.

## `outputStoreUrl` (type: `boolean`):

Full canonical URL of the store's home page.

## `outputProductHandle` (type: `boolean`):

The URL slug Shopify uses in product paths.

## `outputProductTitle` (type: `boolean`):

Public product name.

## `outputProductUrl` (type: `boolean`):

Canonical link to the product page.

## `outputProductImageUrl` (type: `boolean`):

URL of the primary product image.

## `outputAverageRating` (type: `boolean`):

Product-level average rating from the review widget.

## `outputReviewCount` (type: `boolean`):

Total number of reviews on the product.

## `outputRatingHistogram` (type: `boolean`):

Review counts broken down by star rating.

## `outputReviewerName` (type: `boolean`):

Public display name shown for the reviewer.

## `outputPublishedAt` (type: `boolean`):

Timestamp when the review was posted.

## `outputVerifiedBuyer` (type: `boolean`):

Verified-purchase flag on each review.

## `outputReply` (type: `boolean`):

Public reply the store posted to the review, as plain text.

## `outputImageUrls` (type: `boolean`):

Source URLs for customer photos on each review.

## `outputVideoUrls` (type: `boolean`):

Source URLs for customer videos on each review.

## `outputReviewerLocation` (type: `boolean`):

Reviewer's location or country, when the provider publishes it.

## `outputHelpfulVotes` (type: `boolean`):

Helpful and not-helpful vote counts.

## `outputOriginalLanguage` (type: `boolean`):

Language of the review when detected or provided by the widget.

## `outputInputUrl` (type: `boolean`):

The URL from your input that produced this row. Useful for grouping results.

## `outputProviderFields` (type: `boolean`):

Extra fields specific to the detected provider: sentiment, topics, survey answers, custom attributes, variant IDs, recommendation flags, and more.

## Actor input object example

```json
{
  "startUrls": [
    "https://bravelittleones.com/products/cookies-and-milk-zip-romper"
  ],
  "maxResultsPerUrl": 50,
  "filterRatings": [],
  "sortBy": "newest",
  "verifiedOnly": false,
  "onlyWithMedia": false,
  "onlyWithPhotos": false,
  "onlyWithVideos": false,
  "merchantReplyOnly": false,
  "reviewContent": "all",
  "filterLanguages": [],
  "detectLanguage": false,
  "translateReviews": false,
  "translationTarget": "en",
  "downloadMedia": false,
  "outputStoreDomain": true,
  "outputStoreUrl": true,
  "outputProductHandle": true,
  "outputProductTitle": true,
  "outputProductUrl": true,
  "outputProductImageUrl": true,
  "outputAverageRating": true,
  "outputReviewCount": true,
  "outputRatingHistogram": true,
  "outputReviewerName": true,
  "outputPublishedAt": true,
  "outputVerifiedBuyer": true,
  "outputReply": true,
  "outputImageUrls": true,
  "outputVideoUrls": true,
  "outputReviewerLocation": true,
  "outputHelpfulVotes": true,
  "outputOriginalLanguage": true,
  "outputInputUrl": true,
  "outputProviderFields": false
}
```

# Actor output Schema

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

All product, review, and explanatory rows.

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

Compact mixed view of all output rows.

## `products` (type: `string`):

Product rating summaries from store URL inputs.

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

Individual reviews from product URL inputs.

## `enrichments` (type: `string`):

Review language, translation, and media fields.

## `mediaFiles` (type: `string`):

Review media files archived by this run.

# 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 = {
    "startUrls": [
        "https://bravelittleones.com/products/cookies-and-milk-zip-romper"
    ],
    "maxResultsPerUrl": 50,
    "filterRatings": [],
    "sortBy": "newest",
    "filterLanguages": [],
    "translationTarget": "en"
};

// Run the Actor and wait for it to finish
const run = await client.actor("lurkapi/shopify-product-reviews-scraper-api").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 = {
    "startUrls": ["https://bravelittleones.com/products/cookies-and-milk-zip-romper"],
    "maxResultsPerUrl": 50,
    "filterRatings": [],
    "sortBy": "newest",
    "filterLanguages": [],
    "translationTarget": "en",
}

# Run the Actor and wait for it to finish
run = client.actor("lurkapi/shopify-product-reviews-scraper-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    "https://bravelittleones.com/products/cookies-and-milk-zip-romper"
  ],
  "maxResultsPerUrl": 50,
  "filterRatings": [],
  "sortBy": "newest",
  "filterLanguages": [],
  "translationTarget": "en"
}' |
apify call lurkapi/shopify-product-reviews-scraper-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lurkapi/shopify-product-reviews-scraper-api",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/Kf0WbFIHBm31erbE8/builds/mN8ktsM3Ux6ZvWQJh/openapi.json