# Shopify Storefront Catalog, Price & Stock Monitor (`pulse_extract/shopify-catalog-monitor`) Actor

Extract normalized Shopify product catalogs, variant SKUs, prices, compare-at discounts, currencies, and stock availability from public Shopify JSON endpoints.

- **URL**: https://apify.com/pulse_extract/shopify-catalog-monitor.md
- **Developed by:** [Pulse Extract](https://apify.com/pulse_extract) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.80 / 1,000 product or variant returneds

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 Storefront Catalog, Price & Stock Monitor

Extract full product catalogs, SKU variants, prices, compare-at discounts, currencies, and real-time in-stock availability from public **Shopify** storefronts and collections — using fast HTTP/2 JSON requests with zero headless-browser overhead.

***

### Key Features

- **Zero-Browser Speed & High Reliability:** Queries Shopify's native public `/products.json`, `/collections/{handle}/products.json`, and `/cart.js` currency endpoints directly.
- **Two Output Modes (`products` or `variants`):**
  - `products`: One clean record per product (`priceMin`, `priceMax`, `compareAtPriceMin`, `discountPercent`, `inStock`, `skuList`, `variants[]`).
  - `variants`: One flat row per SKU/variant — ready to drop straight into Google Sheets, Excel, Airtable, or BI price-monitoring pipelines.
- **Automatic Currency Detection:** Resolves store currency cleanly via `/cart.js` alongside numeric `price` and `compareAtPrice` fields.
- **Optional `.js` Enrichment (`enrichProductJs`):** Pulls `/products/{handle}.js` for extra fields (`barcode`, `inventoryManagement`, `requiresSellingPlan`, `sellingPlanGroupsCount`) only on items that pass your filters.
- **Pre-Push Filtering:** Filter by `inStockOnly`, `onSaleOnly`, `vendorFilter`, `productTypeFilter`, or `tagFilter` before pushing and charging.
- **Smart Proxy Fallback:** Runs direct zero-proxy HTTP/2 first for maximum speed and margin, falling back to Apify Proxy only if a storefront returns HTTP 403/429 and proxy access is enabled.

***

### Example Input

```json
{
  "storeUrls": [
    "https://www.beardbrand.com",
    "https://www.allbirds.com"
  ],
  "outputMode": "products",
  "enrichProductJs": false,
  "inStockOnly": false,
  "onSaleOnly": false,
  "vendorFilter": "",
  "productTypeFilter": "",
  "tagFilter": "",
  "maxProductsPerStore": 250,
  "useProxyOnBlock": true
}
```

***

### Example Output Item (`products` mode)

```json
{
  "storeDomain": "www.beardbrand.com",
  "productId": 7890123456,
  "handle": "utility-balm",
  "title": "Utility Balm",
  "vendor": "Beardbrand",
  "productType": "Balm",
  "tags": ["grooming", "beard"],
  "currency": "USD",
  "inStock": true,
  "availableVariantsCount": 3,
  "totalVariantsCount": 3,
  "priceMin": 25.0,
  "priceMax": 25.0,
  "compareAtPriceMin": 30.0,
  "compareAtPriceMax": 30.0,
  "discountPercent": 16.7,
  "sku": "BB-UB-01",
  "skuList": ["BB-UB-01", "BB-UB-02", "BB-UB-03"],
  "productUrl": "https://www.beardbrand.com/products/utility-balm",
  "imageUrl": "https://cdn.shopify.com/...",
  "imagesCount": 4,
  "descriptionText": "Softens beard and skin...",
  "publishedAt": "2026-08-01T12:00:00-05:00",
  "updatedAt": "2026-11-15T09:30:00-05:00",
  "requiresSellingPlan": false,
  "variants": [],
  "scrapedAt": "2026-11-19T03:00:00+00:00"
}
```

***

### Pricing & Billing Transparency

This Actor uses transparent **Pay-Per-Event (PPE)** billing:

- **Actor Start:** `$0.00005` per run.
- **Per Product or Variant Returned (`product-scraped`):** `$0.0008` per item (`$0.80 per 1,000 items`).
- **Optional `.js` Enrichment (`product-enriched`):** `$0.0008` per enriched product (only charged when `enrichProductJs` is `true`).

***

### Use Cases & Integrations

- **Competitor Price & Promo Tracking:** Schedule daily runs via **n8n**, **Make**, or **Apify Schedules** with `onSaleOnly: true` to catch competitor flash sales and markdowns.
- **Catalog & Stock Alerts:** Export flat `variants` rows to monitor out-of-stock SKUs (`inStock: false`) across wholesale or dropshipping partners.
- **AI Agents & MCP:** Connect via Apify's MCP server so shopping assistants or market-research agents can query normalized Shopify store catalogs directly.

***

### FAQ

**What if a Shopify store blocks direct requests with Cloudflare / HTTP 403?**\
Leave `useProxyOnBlock: true` and enable Apify Proxy (Datacenter or Residential) in `proxyConfiguration` — the Actor tries fast zero-proxy HTTP/2 first and only invokes the proxy if blocked.

**Why are `variants` prices in dollars while Shopify's `.js` endpoint uses cents?**\
This Actor normalizes all prices from `/products.json` into standard decimal floats (`29.99`) and converts discounts into `discountPercent`, while merging `barcode`, `inventoryManagement`, and selling plan metadata cleanly from `.js` when enabled.

# Actor input Schema

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

Accepts Shopify store domains (https://www.beardbrand.com, allbirds.com) or specific collection URLs (https://store.com/collections/bestsellers).

## `outputMode` (type: `string`):

Choose 'products' for one row per product (with nested variants array) or 'variants' for one flat row per SKU/variant (ideal for spreadsheets and price tracking).

## `enrichProductJs` (type: `boolean`):

Fetch each product's .js JSON endpoint to include barcodes, inventoryManagement, and subscription/selling plan flags. Triggers the optional product-enriched PPE event.

## `inStockOnly` (type: `boolean`):

Only return products or variants that are currently available/in stock.

## `onSaleOnly` (type: `boolean`):

Only return items where compareAtPrice is greater than price.

## `vendorFilter` (type: `string`):

Case-insensitive substring match against product vendor.

## `productTypeFilter` (type: `string`):

Case-insensitive substring match against productType.

## `tagFilter` (type: `string`):

Case-insensitive match against product tags.

## `maxProductsPerStore` (type: `integer`):

Maximum products to scan per store URL. Set to 0 for unlimited.

## `useProxyOnBlock` (type: `boolean`):

Try fast zero-proxy direct HTTP/2 first; automatically retry with Apify Proxy only if a store blocks direct requests and proxy is configured.

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

Optional Apify Proxy settings used only for fallback when a storefront blocks direct requests.

## Actor input object example

```json
{
  "storeUrls": [
    "https://www.beardbrand.com",
    "https://www.allbirds.com"
  ],
  "outputMode": "products",
  "enrichProductJs": false,
  "inStockOnly": false,
  "onSaleOnly": false,
  "vendorFilter": "",
  "productTypeFilter": "",
  "tagFilter": "",
  "maxProductsPerStore": 250,
  "useProxyOnBlock": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

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

// Run the Actor and wait for it to finish
const run = await client.actor("pulse_extract/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 = { "storeUrls": [
        "https://www.beardbrand.com",
        "https://www.allbirds.com",
    ] }

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pulse_extract/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/eSa5EQCt6eh1l03PU/builds/tYLhcVMshiwGzwvg0/openapi.json
