# Shopify Product Price and Stock Change Monitor (`redfoxxie/shopify-product-price-stock-monitor`) Actor Monitor public Shopify product catalogs and emit only price, stock, or variant changes across scheduled runs, with catalog-to-sitemap source fallback, persistent baselines, bounded collection, and free previews. - **URL**: https://apify.com/redfoxxie/shopify-product-price-stock-monitor.md - **Developed by:** [João Ferreira](https://apify.com/redfoxxie) (community) - **Categories:** E-commerce, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 66.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $5.00 / 1,000 shopify product change alerts 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 This independent product is not affiliated with, sponsored by, or endorsed by Shopify. ### Shopify changes without repeated full exports Shopify Product Price and Stock Change Monitor watches public product information and emits only price, availability, or variant changes observed after a persistent baseline. It is designed for competitive intelligence, assortment tracking, pricing operations, affiliate catalogs, procurement research, and ecommerce workflows that need change events rather than unchanged catalog dumps. The collector does not rely on one fragile endpoint. It first attempts a bounded public catalog export where the storefront exposes one. For storefronts that reject Apify data-center addresses, the Actor can ask Jina Reader to retrieve the same public catalog using its provider-managed cache; this introduces a disclosed third-party dependency and can delay detection until that cache refreshes, but requires no merchant credentials. Further fallbacks inspect the storefront's product sitemap, official per-product Ajax JSON, homepage links, and schema.org Product data. Requests use a Chrome-fingerprinted HTTP transport, and a bounded rotating proxy pool is used when Apify proxy access is available. Per-store diagnostics identify the selected route. If every source fails, the run fails visibly instead of returning a misleading empty success. Each snapshot normalizes product ID, handle, title, vendor, minimum and maximum variant price, variant count, available variant count, overall availability, product URL, publication metadata, and observation time. Integer prices from the Ajax endpoint are converted from minor currency units, while decimal catalog prices are preserved in major units. ### Baselines, previews, and billing `previewOnly=true` is the default. Preview mode validates source access and reports product counts and source diagnostics without charging custom events or mutating persistent state. The first non-preview run creates the baseline and produces no historical change charges. Later runs compare price and availability fields against that baseline and deliver only changed products. Named `monitorId` values keep independent baselines in limited-permission Apify key-value storage. Keep the same identifier for one continuing monitor. Store count, sitemap count, product count, alerts, requests, and state retention are bounded. Product URLs discovered from sitemaps must use HTTPS and match the requested storefront host after normalizing the common `www` alias. ### Pricing Pricing is **Pay per event + usage** with **no start fee**. Each delivered product change uses event `shopify_product_change_alert` at **$0.005**. Previews, baseline creation, unchanged products, and failed sources do not emit paid custom events. Apify platform usage is charged separately to the runner according to normal compute and storage rules. Public storefront behavior remains controlled by each merchant. Stores may disable feeds, remove products, redirect domains, add bot protection, or change their theme. Jina Reader availability, caching, and rate limits can also affect fallback coverage and freshness. The Actor reports these limitations rather than claiming universal Shopify coverage. Users remain responsible for lawful schedules, Shopify and Jina source terms, and downstream use of public product information. # Actor input Schema ## `storeUrls` (type: `array`): HTTPS Shopify storefront origins; product paths and query strings are not accepted. ## `maxProducts` (type: `integer`): Maximum products inspected across all stores after source fallback. ## `maxAlerts` (type: `integer`): Maximum paid product-change records emitted per run. ## `monitorId` (type: `string`): Stable identifier for independent catalog baselines. ## `previewOnly` (type: `boolean`): Inspect source health and products without charging or mutating state. ## Actor input object example ```json { "storeUrls": [ "https://deathwishcoffee.com", "https://www.allbirds.com" ], "maxProducts": 50, "maxAlerts": 100, "monitorId": "competitor-catalogs", "previewOnly": true } ```` # Actor output Schema ## `changes` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("redfoxxie/shopify-product-price-stock-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("redfoxxie/shopify-product-price-stock-monitor").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 '{}' | apify call redfoxxie/shopify-product-price-stock-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=redfoxxie/shopify-product-price-stock-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Shopify Product Price and Stock Change Monitor", "description": "Monitor public Shopify product catalogs and emit only price, stock, or variant changes across scheduled runs, with catalog-to-sitemap source fallback, persistent baselines, bounded collection, and free previews.", "version": "0.2", "x-build-id": "fFbJH10gfqyjn5zke" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/redfoxxie~shopify-product-price-stock-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-redfoxxie-shopify-product-price-stock-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/redfoxxie~shopify-product-price-stock-monitor/runs": { "post": { "operationId": "runs-sync-redfoxxie-shopify-product-price-stock-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/redfoxxie~shopify-product-price-stock-monitor/run-sync": { "post": { "operationId": "run-sync-redfoxxie-shopify-product-price-stock-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "storeUrls" ], "properties": { "storeUrls": { "title": "Shopify store origins", "minItems": 1, "maxItems": 10, "type": "array", "description": "HTTPS Shopify storefront origins; product paths and query strings are not accepted.", "items": { "type": "string", "maxLength": 500 }, "default": [ "https://deathwishcoffee.com" ] }, "maxProducts": { "title": "Maximum products", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum products inspected across all stores after source fallback.", "default": 5 }, "maxAlerts": { "title": "Maximum change alerts", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum paid product-change records emitted per run.", "default": 100 }, "monitorId": { "title": "Monitor state ID", "maxLength": 60, "type": "string", "description": "Stable identifier for independent catalog baselines.", "default": "default" }, "previewOnly": { "title": "Free preview", "type": "boolean", "description": "Inspect source health and products without charging or mutating state.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```