# Shopify Reviews Aggregator Pro (Judge.me, Loox & Yotpo) (`viralanalyzer/shopify-reviews-aggregator-pro`) Actor

Unified Shopify reviews scraper. Auto-detects Judge.me, Loox, Yotpo, Okendo & Stamped to extract ratings, photos & buyer feedback. Only $2.00/1K.

- **URL**: https://apify.com/viralanalyzer/shopify-reviews-aggregator-pro.md
- **Developed by:** [viralanalyzer](https://apify.com/viralanalyzer) (community)
- **Categories:** E-commerce, Lead generation, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.70 / 1,000 review scrapeds

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 Reviews Aggregator Pro 🛍️

> 🔗 [View on Apify Store](https://apify.com/viralanalyzer/shopify-reviews-aggregator-pro) | 🇺🇸 English | [🇧🇷 Português](#português)

***

### 🇺🇸 English

#### Overview

Unified Shopify customer reviews scraper. Automatically detects and extracts customer ratings, review text, customer photos, and verified buyer flags across all major Shopify review apps (Judge.me, Loox, Yotpo, Okendo, Stamped, Fera, Junip, AliReviews).

#### Features

- **Universal App Auto-Detection**: Identifies which review app is installed on any Shopify store
- **Photo & Video Reviews**: Extracts customer-uploaded photos and review media attachments
- **Verified Buyer Intelligence**: Captures verified purchase badges and reviewer country
- **Granular Ratings**: Star ratings (1-5), review title, detailed body text, and submission timestamp
- **Multi-Store Support**: Extract reviews across hundreds of Shopify stores in one execution

#### Input Example

```json
{
  "storeDomains": [
    "gymshark.com",
    "colourpop.com"
  ],
  "maxReviewsPerStore": 50,
  "includePhotos": true
}
```

#### Output Example

```json
{
  "reviewId": "judgeme_rev_984124",
  "storeDomain": "gymshark.com",
  "reviewApp": "Judge.me",
  "productTitle": "Gymshark Vital Sweetheart Neck Crop Top",
  "productHandle": "gymshark-vital-sweetheart-crop",
  "reviewerName": "Emily R.",
  "reviewerCountry": "US",
  "rating": 5,
  "reviewTitle": "Incredible fit and breathable fabric!",
  "reviewBody": "Fits true to size and holds up great during intense workouts.",
  "isVerifiedBuyer": true,
  "reviewPhotos": [
    "https://cdn.shopify.com/reviews/photo_1.jpg"
  ],
  "reviewDate": "2026-08-15",
  "scrapedAt": "2026-08-20T21:00:00.000Z"
}
```

#### Input Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `storeDomains` | string\[] | List of Shopify store domains or URLs (e.g. \["gymshark.com", "allbirds.com"]) |
| `maxReviewsPerStore` | number | Max reviews to extract per store (default: 50) |
| `includePhotos` | boolean | Include review photo attachments (default: true) |

#### Tips

- Enter clean domain names like `gymshark.com` or full product URLs
- Use this scraper to perform sentiment analysis on competitor product weaknesses

#### Use Cases

- **E-Commerce Competitor Benchmarking** — Analyze customer complaints and praise on competitor stores
- **Product R\&D** — Discover what features customers love or dislike before launching products
- **Sentiment Analysis & NLP** — Build training datasets for sentiment analysis on e-commerce reviews

#### FAQ

**Q: Which Shopify review apps are supported?**
A: Judge.me, Loox, Yotpo, Okendo, Stamped, Fera, Junip, AliReviews, and native Shopify Product Reviews.

**Q: Do I need store API keys?**
A: No. The Actor interacts with public customer-facing review widgets.

***

### 🇧🇷 Português

#### Visão Geral

Scraper unificado de avaliações de clientes para lojas Shopify. Detecta automaticamente o aplicativo instalado (Judge.me, Loox, Yotpo, Okendo, Stamped, Fera, Junip, AliReviews) e extrai notas, fotos de clientes, textos e status de comprador verificado.

#### Funcionalidades

- **Detecção Automática Universal**: Identifica qual app de review está instalado em qualquer loja Shopify
- **Avaliações com Fotos e Vídeos**: Extrai fotos e anexos enviados pelos compradores
- **Status de Comprador Verificado**: Identifica selos de compra verificada e país do avaliador
- **Avaliações Granulares**: Notas de 1 a 5 estrelas, título da avaliação, texto completo e data
- **Suporte Multi-Lojas**: Extraia avaliações de centenas de lojas Shopify em uma única execução

#### Exemplo de Entrada

```json
{
  "storeDomains": [
    "gymshark.com",
    "colourpop.com"
  ],
  "maxReviewsPerStore": 50,
  "includePhotos": true
}
```

#### Exemplo de Saída

```json
{
  "reviewId": "judgeme_rev_984124",
  "storeDomain": "gymshark.com",
  "reviewApp": "Judge.me",
  "productTitle": "Gymshark Vital Sweetheart Neck Crop Top",
  "productHandle": "gymshark-vital-sweetheart-crop",
  "reviewerName": "Emily R.",
  "reviewerCountry": "US",
  "rating": 5,
  "reviewTitle": "Incredible fit and breathable fabric!",
  "reviewBody": "Fits true to size and holds up great during intense workouts.",
  "isVerifiedBuyer": true,
  "reviewPhotos": [
    "https://cdn.shopify.com/reviews/photo_1.jpg"
  ],
  "reviewDate": "2026-08-15",
  "scrapedAt": "2026-08-20T21:00:00.000Z"
}
```

#### Parâmetros de Entrada

| Parâmetro | Tipo | Descrição |
|-----------|------|-----------|
| `storeDomains` | string\[] | Lista de domínios ou URLs de lojas Shopify (ex: \["gymshark.com", "allbirds.com"]) |
| `maxReviewsPerStore` | number | Máximo de avaliações por loja (padrão: 50) |
| `includePhotos` | boolean | Incluir fotos enviadas pelos clientes (padrão: true) |

#### Dicas

- Insira domínios limpos como `gymshark.com` ou URLs diretas de produtos
- Utilize este scraper para analisar pontos fracos em produtos de concorrentes

#### Casos de Uso

- **Benchmarking de E-Commerce** — Analise elogios e reclamações de clientes em lojas concorrentes
- **Desenvolvimento de Produtos** — Descubra o que os clientes mais valorizam antes de lançar novos itens
- **Análise de Sentimento** — Crie bases de dados para análise de sentimento e feedback de clientes

#### Perguntas Frequentes

**P: Quais aplicativos de review são suportados?**
R: Judge.me, Loox, Yotpo, Okendo, Stamped, Fera, Junip, AliReviews e Shopify Product Reviews nativo.

**P: Preciso de chaves de API da loja?**
R: Não. O Actor extrai dados através dos widgets públicos das lojas.

***

### 💰 Pricing

This actor uses **Pay Per Event (PPE)** pricing — you pay only per **item scraped** (`review-scraped`). Platform usage is included. See the current price on the **Pricing** panel of this actor's Apify Store page.

***

### 🔗 Related Actors

- [Reclame Aqui Scraper](https://apify.com/viralanalyzer/reclameaqui-scraper)
- [iFood Restaurant Intelligence](https://apify.com/viralanalyzer/ifood-restaurant-intelligence)
- [Instagram Reels Scraper](https://apify.com/viralanalyzer/instagram-reels-scraper)
- [TikTok Viral Scanner](https://apify.com/viralanalyzer/tiktok-viral-scanner)
- [Google Maps BR Scraper](https://apify.com/viralanalyzer/google-maps-br-scraper)
- [Mercado Livre Scraper](https://apify.com/viralanalyzer/mercadolivre-scraper)

***

### 📝 Changelog

- **v1.0.0** (2026-08-20) — Initial release: full extraction, Pay-Per-Event pricing, and automated proxy support

***

### License

ISC © 2026 Viral Analyzer Platform

***

💡 **Need AI analysis on top of this data — sentiment, trend detection and a dashboard, with no API keys to manage?**\
[ViralAnalyzer](https://viralanalyzer.com.br) runs this actor + 42 more data sources with built-in AI. JSON + insights in one call.

# Actor input Schema

## `storeUrls` (type: `array`):

List of Shopify store domains (e.g. 'gymshark.com', 'allbirds.com') or specific product URLs.

## `maxReviews` (type: `integer`):

Maximum number of reviews to extract per store.

## `onlyVerified` (type: `boolean`):

If true, only extracts reviews with verified buyer badges.

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

Proxy settings. Apify residential proxies are recommended for heavy bulk scraping.

## Actor input object example

```json
{
  "storeUrls": [
    "gymshark.com",
    "allbirds.com"
  ],
  "maxReviews": 20,
  "onlyVerified": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

Dataset output for Shopify Reviews Aggregator Pro Output

# 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 = {
    "storeUrls": [
        "gymshark.com",
        "allbirds.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("viralanalyzer/shopify-reviews-aggregator-pro").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 = { "storeUrls": [
        "gymshark.com",
        "allbirds.com",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("viralanalyzer/shopify-reviews-aggregator-pro").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 '{
  "storeUrls": [
    "gymshark.com",
    "allbirds.com"
  ]
}' |
apify call viralanalyzer/shopify-reviews-aggregator-pro --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,viralanalyzer/shopify-reviews-aggregator-pro"
        }
    }
}

```

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/w6QGpgOTf5X1EzVDb/builds/BrCv9jwDRVVFyN42P/openapi.json