# Shopify Product Scraper & Price / Inventory Monitor (`pepeschuster/shopify-catalog-monitor`) Actor

Scrape any Shopify store's full product catalog and monitor price & inventory changes — via the public products.json endpoint. No login, no proxies.

- **URL**: https://apify.com/pepeschuster/shopify-catalog-monitor.md
- **Developed by:** [Pepe Schuster](https://apify.com/pepeschuster) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 change detecteds

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?

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 Scraper & Price / Inventory Monitor

**Scrape any Shopify store's full product catalog and monitor price & inventory changes — via the public products.json endpoint. No login, no proxies.**

This Actor reads each store's **public product feed** — no login, no API key, and no proxies — and returns clean, structured data you can download as **JSON, CSV, or Excel**, or pull straight from the Apify API. It works on the vast majority of stores on the platform.

### Features

- 🏬 **Any store, many at once** — pass one or a list of store URLs and scrape them all in a single run.
- 🎯 **Clean structured output** — every result is a flat record (`shop`, `title`, `url`, `vendor`, `minPrice`, `maxPrice`, `available`, `variantsCount`, `_change`).
- 🔔 **Schedule it** — runs on a schedule and returns **only what changed** since last time, so you get an alertable feed, not a re-dump.
- ⚡ **Fast & reliable** — uses the storefront's own public feed, so it's cheap to run and doesn't break on layout changes.
- 🔌 **Integrates everywhere** — JSON/CSV/Excel, plus the API, webhooks, Zapier, Make, Google Sheets, and 5,000+ integrations.

### Who it's for

DTC & dropshipping researchers, competitor-price and MAP-monitoring tools, brand and assortment analysts, and deal/affiliate publishers.

**Common use cases**

- Track a set of competitor stores' catalogs, prices, and stock
- Feed a repricing engine or a deal/affiliate site
- Spot new launches, sell-outs, and markdowns early

### Input

| Field | Type | Description |
|---|---|---|
| `shopUrls` | array | One or more Shopify store domains or URLs (e.g. 'gymshark.com' or 'https://kith.com'). The scraper reads each store's public /products.json — no login needed. Works on any store running on Shopify. **Required.** |
| `maxProductsPerShop` | integer | Cap the number of products fetched per store. Set 0 for the full catalog. |
| `includeVariants` | boolean | Include the full per-variant breakdown (SKU, price, compare-at price, availability). Turn off for a lighter, one-row-per-product output. |
| `monitorMode` | boolean | Compare against the previous run and output only what changed: new products, price drops/increases, restocks, and delisted items. Perfect for a scheduled run — turns this into a price/inventory change feed. |
| `monitorStoreName` | string | Named key-value store that holds the previous snapshot used for change detection. Use one stable name per watch (e.g. 'watch-competitors'). Leave default if you only run one watch. |

**Example input**

```json
{
  "shopUrls": [
    "https://www.allbirds.com"
  ],
  "maxProductsPerShop": 0,
  "includeVariants": true,
  "monitorMode": true,
  "monitorStoreName": "example"
}
```

### Output

One record per change. **Example output:**

```json
{
  "shop": "store.example.com",
  "title": "Example Product",
  "url": "https://store.example.com/products/item",
  "vendor": "Example Product",
  "minPrice": 29.99,
  "maxPrice": 29.99,
  "available": true,
  "variantsCount": 3,
  "_change": "price-drop"
}
```

Fields: `shop`, `title`, `url`, `vendor`, `minPrice`, `maxPrice`, `available`, `variantsCount`, `_change`. Download as JSON, CSV, XML, or Excel — or fetch from the dataset API.

### Pricing

**Pay-per-result** — you're billed only for the records you actually get, with no monthly fee and no charge for empty runs. Far cheaper than a monitoring SaaS subscription.

### FAQ

**Do I need a login or API key?** No — it reads the store's public product feed.
**Which stores work?** Any store that exposes the standard public product endpoint (the vast majority).
**Can I get change alerts?** Yes — schedule this Actor and it emits only the deltas each run; pipe them to a webhook, Slack, or Google Sheets.
**How fresh is the data?** It's fetched live on every run.
**What formats can I export?** JSON, CSV, Excel, XML, or via the API.

### Notes

Please scrape responsibly and within each store's terms of service.

# Actor input Schema

## `shopUrls` (type: `array`):

One or more Shopify store domains or URLs (e.g. 'gymshark.com' or 'https://kith.com'). The scraper reads each store's public /products.json — no login needed. Works on any store running on Shopify.

## `maxProductsPerShop` (type: `integer`):

Cap the number of products fetched per store. Set 0 for the full catalog.

## `includeVariants` (type: `boolean`):

Include the full per-variant breakdown (SKU, price, compare-at price, availability). Turn off for a lighter, one-row-per-product output.

## `monitorMode` (type: `boolean`):

Compare against the previous run and output only what changed: new products, price drops/increases, restocks, and delisted items. Perfect for a scheduled run — turns this into a price/inventory change feed.

## `monitorStoreName` (type: `string`):

Named key-value store that holds the previous snapshot for change detection. Use one stable name per watch. Letters, digits and inner hyphens are allowed — capitals are fine. Anything else (spaces, '&', underscores, dots) is normalised automatically, e.g. "My Store Watch" becomes "My-Store-Watch". A name that is already valid is used exactly as you typed it, so an existing snapshot is never switched out from under a running watch.

## Actor input object example

```json
{
  "shopUrls": [
    "gymshark.com",
    "https://kith.com"
  ],
  "maxProductsPerShop": 0,
  "includeVariants": true,
  "monitorMode": false,
  "monitorStoreName": "shopify-monitor-state"
}
```

# Actor output Schema

## `results` (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 = {
    "shopUrls": [
        "https://www.allbirds.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pepeschuster/shopify-catalog-monitor").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 = { "shopUrls": ["https://www.allbirds.com"] }

# Run the Actor and wait for it to finish
run = client.actor("pepeschuster/shopify-catalog-monitor").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 '{
  "shopUrls": [
    "https://www.allbirds.com"
  ]
}' |
apify call pepeschuster/shopify-catalog-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pepeschuster/shopify-catalog-monitor"
        }
    }
}

```

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/L4egQ1JloOFDeIAuA/builds/8d5Khg6q2L3Xnc9ba/openapi.json