# Shopify Store Scraper — Products & Contacts (`muhammadafzal/shopify-store-scraper`) Actor

Scrape Shopify stores for products, collections, prices, reviews, policies, emails, and business details for ecommerce intelligence.

- **URL**: https://apify.com/muhammadafzal/shopify-store-scraper.md
- **Developed by:** [Muhammad Afzal](https://apify.com/muhammadafzal) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 product scrapeds

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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 Store Scraper — Products & Contacts

Extract complete product catalogs, collections, customer reviews, merchant contact info, and tech-stack intelligence from **any Shopify store** — no API key, no login, no browser automation required. Just enter a store domain and get clean, CRM-ready structured JSON.

> Export scraped data, run the scraper via API, schedule and monitor runs, or integrate with other tools.

### What It Extracts

#### 🛒 Products (one record per product)

- **Title, handle, brand/vendor, category, tags, description** — full product metadata
- **Pricing**: current price, original (compare-at) price, min/max variant price, **discount percentage**
- **Up to 250 variants** per product: SKU, barcode, price, availability, inventory quantity, weight, shipping flag, and options (Size, Color, etc.)
- **Images**: all image URLs, main image, image count, and alt texts for SEO analysis
- **Reviews summary**: aggregate rating, review count, review source, detected review platform
- **Sales estimates**: conservative monthly sales derived from review volume
- **Availability flags**: `available`, `fully_out_of_stock`, `requires_shipping`
- **Timestamps**: published\_at, created\_at, updated\_at + `scraped_at` and `source_url` for traceability

#### 📂 Collections (one record per collection)

- Collection title, handle, description, product count, hero image, and canonical collection URL
- Useful for understanding store taxonomy and category structure

#### ⭐ Customer Reviews (one record per review)

- Reviewer name, star rating, review title, full review body, submission date
- Verified-buyer flag and helpful votes where available
- **Auto-detects review platforms**: Judge.me, Yotpo, Loox, Stamped, Okendo, Reviews.io, and JSON-LD
- Falls back to JSON-LD structured reviews when no widget is detected

#### 📧 Merchant Contact Info (one record per store)

- **Business email** and **phone number** — high-value for B2B lead generation
- Physical address, store currency, and language
- **Social media links**: Facebook, Instagram, Twitter/X, TikTok, YouTube, Pinterest
- Contact page URL

#### 🏪 Store Intelligence (one record per store)

- **Installed app detection**: Klaviyo, Mailchimp, Privy, ReCharge, Smile.io, Gorgias, Hotjar, Google Analytics, Facebook Pixel, TikTok Pixel, and 40+ more
- Apps grouped by category: Email Marketing, SMS, Reviews, Subscriptions, Loyalty, Analytics, Customer Service, Page Builders, Upsell, Search, etc.
- **Theme metadata**: theme name, version, and ID
- Shop name, currency, language, country, and domain

### Input Modes

#### URL Mode (default) — scrape known stores

Use this when you already know the Shopify stores to scrape:

```json
{
  "mode": "url",
  "storeUrls": [{ "url": "https://www.allbirds.com" }],
  "maxProducts": 100,
  "includeReviews": true,
  "scrapeCollections": true,
  "scrapeContactInfo": true,
  "scrapeTechStack": true
}
```

#### Discovery Mode — find stores by category first

Use this when you want to discover Shopify stores by niche, then scrape them:

```json
{
  "mode": "discovery",
  "category": "fashion",
  "maxStores": 25,
  "maxPages": 3,
  "maxProducts": 50
}
```

### Use Cases

- **Competitor price monitoring**: track pricing changes, discounts, and sold-out products across rival Shopify stores
- **Dropshipping product research**: identify trending products, price points, and inventory levels
- **B2B lead generation**: collect merchant emails, phone numbers, and social links for sales outreach — the highest-ROI use case
- **Market research**: analyze full product catalogs for pricing, category structures, and brand positioning
- **Review sentiment analysis**: extract individual customer reviews for NLP and product-improvement insights
- **Tech-stack prospecting**: detect which apps and themes a store uses — perfect for agency sales and app developers
- **Price comparison**: aggregate product data from multiple Shopify stores for comparison engines
- **Catalog monitoring**: detect new products and stock changes by comparing runs over time

### Pricing

This actor uses **Pay-Per-Event** pricing — you only pay for what you get:

| Event | When Charged | Price |
|---|---|---:|
| Actor Start | Once per run | $0.001 |
| **Product Scraped** | Per product extracted (primary) | **$0.005** |
| Collection Scraped | Per collection extracted | $0.001 |
| Review Scraped | Per individual review extracted | $0.001 |
| Contact Info Scraped | Per store (email, phone, socials) | $0.010 |
| Store Intelligence | Per store (apps, theme, tech stack) | $0.010 |

**Typical run cost**: 100 products from one store ≈ $0.50. Adding contact info + tech stack ≈ $0.52 total.

### Output

Each dataset item is a stable, MCP-friendly JSON object discriminated by `recordType`. Example product record:

```json
{
  "recordType": "product",
  "store_url": "https://www.allbirds.com",
  "product_id": "101",
  "title": "Tree Runner",
  "brand": "Allbirds",
  "current_price": 95,
  "discount_percentage": 21,
  "available": true,
  "variant_count": 12,
  "rating": 4.7,
  "review_count": 321,
  "product_url": "https://www.allbirds.com/products/tree-runner",
  "scraped_at": "2026-07-08T12:00:00.000Z"
}
```

Example contact record:

```json
{
  "recordType": "contact",
  "store_url": "https://www.allbirds.com",
  "merchant_email": "hello@allbirds.com",
  "merchant_phone": "+1-800-555-1234",
  "social_facebook": "https://facebook.com/allbirds",
  "scraped_at": "2026-07-08T12:00:00.000Z"
}
```

### Development

```bash
npm install
npm test
npm run build
npm run validate:schema
apify run
```

### Limitations

- **Password-protected stores** may return zero products — this is a Shopify storefront setting
- **Review extraction** depends on the review widget rendering in the HTML
- **Sales estimates** are conservative heuristics, NOT verified revenue data
- **App detection** is based on script/CDN signatures — lazily-loaded apps may not be detected

### What is Shopify Store Scraper?

**Shopify Store Scraper** turns the target data into structured, reusable results on Apify. Use it when you need repeatable collection for ecommerce teams, pricing analysts, sellers, agencies, and competitive-intelligence workflows without maintaining a custom scraper or one-off integration. Run it manually, schedule recurring jobs, call it through the Apify API, or connect it to an AI agent through the Apify MCP server.

The Actor stores results in an Apify dataset, where they can be previewed and exported as JSON, CSV, Excel, XML, or RSS. Availability and completeness depend on the source, supplied inputs, public visibility, authentication requirements, and upstream rate limits.

### Use cases for Shopify Store Scraper

- Build structured datasets for research, reporting, enrichment, or monitoring.
- Automate repetitive collection with schedules, webhooks, and API calls.
- Feed clean records into spreadsheets, databases, CRMs, BI tools, AI agents, or RAG pipelines.
- Track changes over time by running the same validated input on a schedule.
- Replace fragile manual copy-and-paste work with a reproducible Apify workflow.

### How to use Shopify Store Scraper

1. Open the Actor input page and choose a focused, valid target.
2. Set a conservative result limit for the first run.
3. Start the Actor and inspect the dataset for coverage and field availability.
4. Export the results or connect the dataset to your downstream system.
5. Scale gradually and use scheduling, pagination, or proxies when supported.

#### Important input options

- `mode` — Choose URL mode when the user provides Shopify store URLs (https://www.allbirds.com). Choose discovery mode to find Shopify stores by category first. Default is url. Do NOT use discovery mod
- `storeUrls` — Use this field when the user provides one or more Shopify storefronts. Accepts store homepages such as https://www.allbirds.com; product paths are normalized to the store origin. Default scr
- `category` — Use this ONLY in discovery mode to filter Shopify stores by niche. Examples: fashion, skincare, food/coffee, electronics, pets. Leave empty to discover across all categories. This is NOT a p
- `maxStores` — Maximum stores to collect from the discovery directory before scraping products. Use a small number for tests (10). Default 100, max 5000. Only used in discovery mode.
- `maxPages` — Maximum discovery directory pages to inspect. Each page may contain many stores. Default 10, max 220. Only used in discovery mode, NOT for Shopify product pagination.
- `maxProducts` — Maximum products to extract from each Shopify store. Use 10 for quick tests, higher values for full catalog research. Default 100, max 10000. Applies per store, not across all stores.
- `includeReviews` — When enabled, fetches each product page and reads JSON-LD aggregate ratings. Adds rating, review\_count, review\_source, and estimated\_monthly\_sales fields to product records. Default true. Di
- `maxReviewsPerProduct` — Maximum individual customer reviews to extract per product (separate review records). Set to 0 to skip individual review extraction. Default 0 (off). Set 10-50 for sentiment analysis. Review

### API and automation example

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/shopify-store-scraper').call({
  // Add the same input fields you use in the Apify Console.
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

### Related Apify Actors

Use these dedicated tools when a neighboring data source or workflow is a better match:

- [Etsy Scraper Pro — Products, Prices, Reviews & Shop Data](https://apify.com/muhammadafzal/etsy-scraper-pro)
- [Instagram Followers & Following Scraper — With Cookies](https://apify.com/muhammadafzal/instagram-following-scraper)
- [Leads Finder Pro - B2B Leads with Emails \[Apollo Alternative\]](https://apify.com/muhammadafzal/leads-finder-pro)
- [Yellow Pages US Scraper — Business Leads & Reviews](https://apify.com/muhammadafzal/yellow-pages-us-scraper)
- [Yellow Pages Australia Scraper — Business Leads & Reviews](https://apify.com/muhammadafzal/yellow-pages-au-scraper)
- [OpenTable Restaurants, Ratings & Reviews Scraper](https://apify.com/muhammadafzal/opentable-scraper)
- [🔧 USA Plumbers Scraper — Leads with Phone, Address & Website](https://apify.com/muhammadafzal/usa-plumbers-scraper)
- [Yellow Pages CA Scraper — Canadian Business Leads](https://apify.com/muhammadafzal/yellow-pages-ca-scraper)
- [California CSLB Contractor License Scraper](https://apify.com/muhammadafzal/cslb-california-scraper)
- [USA HVAC Leads Scraper — Verified Emails (AC, Heating)](https://apify.com/muhammadafzal/hvac-lead-scraper)

### Frequently asked questions

#### How many results can I scrape with Shopify Store Scraper?

The practical total depends on the source, input limits, pagination, available records, run timeout, and upstream restrictions. Start with a small run, verify the output, and increase the limit gradually.

#### Can I integrate Shopify Store Scraper with other apps?

Yes. Use Apify integrations, webhooks, schedules, dataset exports, Make, Zapier, Google Sheets, cloud storage, or your own application.

#### Can I use Shopify Store Scraper with the Apify API?

Yes. Start runs with the Apify REST API or an official Apify client, then retrieve records from the run's default dataset. Keep your API token in a secret or environment variable.

#### Can I use Shopify Store Scraper through an MCP Server?

Yes. The Apify MCP server can expose the Actor to compatible AI clients and agents. Review the input and expected cost before allowing an autonomous workflow to run it at scale.

#### Do I need proxies?

It depends on the source and volume. Use the default configuration first. For larger or geographically sensitive jobs, select an appropriate proxy configuration only when the Actor supports it.

#### Is it legal to scrape this data?

Scraping rules vary by source, jurisdiction, data type, and intended use. Collect only data you are authorized to access, respect applicable terms and privacy laws, and avoid restricted or personal data misuse. This documentation is not legal advice.

#### Your feedback

If a field is missing, a source layout has changed, or you need a supported use case documented, open an issue on the Actor page with a reproducible input and run ID.

# Actor input Schema

## `mode` (type: `string`):

Choose URL mode when the user provides Shopify store URLs (https://www.allbirds.com). Choose discovery mode to find Shopify stores by category first. Default is url. Do NOT use discovery mode for scraping a known store.

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

Use this field when the user provides one or more Shopify storefronts. Accepts store homepages such as https://www.allbirds.com; product paths are normalized to the store origin. Default scrapes Allbirds so health checks produce output. NOT used in discovery mode.

## `category` (type: `string`):

Use this ONLY in discovery mode to filter Shopify stores by niche. Examples: fashion, skincare, food/coffee, electronics, pets. Leave empty to discover across all categories. This is NOT a product category filter inside one store.

## `maxStores` (type: `integer`):

Maximum stores to collect from the discovery directory before scraping products. Use a small number for tests (10). Default 100, max 5000. Only used in discovery mode.

## `maxPages` (type: `integer`):

Maximum discovery directory pages to inspect. Each page may contain many stores. Default 10, max 220. Only used in discovery mode, NOT for Shopify product pagination.

## `maxProducts` (type: `integer`):

Maximum products to extract from each Shopify store. Use 10 for quick tests, higher values for full catalog research. Default 100, max 10000. Applies per store, not across all stores.

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

When enabled, fetches each product page and reads JSON-LD aggregate ratings. Adds rating, review\_count, review\_source, and estimated\_monthly\_sales fields to product records. Default true. Disable for faster catalog-only runs.

## `maxReviewsPerProduct` (type: `integer`):

Maximum individual customer reviews to extract per product (separate review records). Set to 0 to skip individual review extraction. Default 0 (off). Set 10-50 for sentiment analysis. Reviews are detected from Judge.me, Yotpo, Loox, Stamped, Okendo, and JSON-LD.

## `scrapeCollections` (type: `boolean`):

When enabled, extracts all store collections (categories) from /collections.json. Each collection is returned as a separate record with title, handle, description, product count, and image. Default false.

## `maxCollections` (type: `integer`):

Maximum collections to extract per store when scrapeCollections is enabled. Default 250, max 5000. Large stores may have thousands of collections.

## `scrapeContactInfo` (type: `boolean`):

When enabled, extracts merchant email, phone, address, and social media links (Facebook, Instagram, Twitter/X, TikTok, YouTube, Pinterest) from the store homepage. Returns one contact record per store. High value for B2B lead generation. Default false.

## `scrapeTechStack` (type: `boolean`):

When enabled, detects installed Shopify apps (Klaviyo, Yotpo, Judge.me, ReCharge, Smile.io, Gorgias, etc.), theme metadata, and store intelligence from the homepage. Returns one storeIntel record per store. Default false.

## `reviewConversionRate` (type: `number`):

Estimated share of buyers who leave reviews, used to convert review counts into conservative monthly sales estimates. Example: 0.02 means 2% of buyers review. Default 0.02. This is an estimate, NOT verified revenue data.

## `requestDelayMs` (type: `integer`):

Delay between successful HTTP requests. Use 0 for fastest runs or 500-2000 for gentler scraping on larger catalogs. Default 500, max 10000. This is NOT a timeout setting.

## `maxRequestRetries` (type: `integer`):

Retry attempts for temporary HTTP, proxy, or network failures. Default 3, max 10. A 404 product catalog still produces no products rather than retrying forever. Does NOT bypass private stores or password walls.

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

Apify proxy settings for large catalogs or protected storefronts. The default uses Apify Proxy for better reliability. Use custom proxy URLs only when you need a dedicated premium proxy. Optional for small public Shopify stores.

## Actor input object example

```json
{
  "mode": "url",
  "storeUrls": [
    {
      "url": "https://www.allbirds.com"
    }
  ],
  "category": "fashion",
  "maxStores": 25,
  "maxPages": 3,
  "maxProducts": 25,
  "includeReviews": true,
  "maxReviewsPerProduct": 0,
  "scrapeCollections": false,
  "maxCollections": 250,
  "scrapeContactInfo": false,
  "scrapeTechStack": false,
  "reviewConversionRate": 0.02,
  "requestDelayMs": 500,
  "maxRequestRetries": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

Link to the dataset containing all scraped Shopify records (products, collections, reviews, contact info, store intelligence).

## `summary` (type: `string`):

Link to the SUMMARY key-value store record with mode, store count, and counts per record type.

# 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 = {
    "mode": "url",
    "storeUrls": [
        {
            "url": "https://www.allbirds.com"
        }
    ],
    "category": "fashion",
    "maxStores": 25,
    "maxPages": 3,
    "maxProducts": 25,
    "includeReviews": true,
    "maxReviewsPerProduct": 0,
    "scrapeCollections": false,
    "maxCollections": 250,
    "scrapeContactInfo": false,
    "scrapeTechStack": false,
    "reviewConversionRate": 0.02
};

// Run the Actor and wait for it to finish
const run = await client.actor("muhammadafzal/shopify-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 = {
    "mode": "url",
    "storeUrls": [{ "url": "https://www.allbirds.com" }],
    "category": "fashion",
    "maxStores": 25,
    "maxPages": 3,
    "maxProducts": 25,
    "includeReviews": True,
    "maxReviewsPerProduct": 0,
    "scrapeCollections": False,
    "maxCollections": 250,
    "scrapeContactInfo": False,
    "scrapeTechStack": False,
    "reviewConversionRate": 0.02,
}

# Run the Actor and wait for it to finish
run = client.actor("muhammadafzal/shopify-store-scraper").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 '{
  "mode": "url",
  "storeUrls": [
    {
      "url": "https://www.allbirds.com"
    }
  ],
  "category": "fashion",
  "maxStores": 25,
  "maxPages": 3,
  "maxProducts": 25,
  "includeReviews": true,
  "maxReviewsPerProduct": 0,
  "scrapeCollections": false,
  "maxCollections": 250,
  "scrapeContactInfo": false,
  "scrapeTechStack": false,
  "reviewConversionRate": 0.02
}' |
apify call muhammadafzal/shopify-store-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/veOR7xm95tVQ6Fmcn/builds/AvUN5O9vcmtqXKwQ7/openapi.json