{
"openapi": "3.0.1",
"info": {
"title": "Shopify Price Tracker & Scraper",
"description": "Scrape any Shopify or WooCommerce store: products, variants, prices, stock, barcodes, apps & theme. Track competitors: only new products, price drops, sales and stock changes since the last run.",
"version": "0.1",
"x-build-id": "SaF6kaxjlcrr9Be13"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/insanedev~shopify-price-tracker/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-insanedev-shopify-price-tracker",
"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/insanedev~shopify-price-tracker/runs": {
"post": {
"operationId": "runs-sync-insanedev-shopify-price-tracker",
"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/insanedev~shopify-price-tracker/run-sync": {
"post": {
"operationId": "run-sync-insanedev-shopify-price-tracker",
"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": [
"stores"
],
"properties": {
"stores": {
"title": "Stores",
"type": "array",
"description": "Shopify or WooCommerce store domains or URLs, one per line (e.g. allbirds.com, https://www.deathwishcoffee.com). The platform is detected automatically; any path in a URL is ignored. Up to 500 stores per run.",
"items": {
"type": "string"
}
},
"mode": {
"title": "What to get",
"enum": [
"products",
"changes"
],
"type": "string",
"description": "Products: every product with variants, prices, stock status and images.
Changes since the last run: price tracking. The first run of a tracker delivers the whole catalogue (your baseline); every later run delivers only what changed — new and removed products, price drops and increases, sales starting and ending, out of stock and back in stock, inventory decreases (estimated units sold). Schedule it daily to monitor competitors.",
"default": "products"
},
"maxProductsPerStore": {
"title": "Max products per store",
"minimum": 0,
"type": "integer",
"description": "Stop after this many products per store. 0 = the whole public catalogue. In change tracking, removed products are only reported when the whole catalogue is read.",
"default": 0
},
"includeDetails": {
"title": "Barcodes (GTIN/UPC) & inventory counts",
"type": "boolean",
"description": "Fetch each product's detail JSON for barcodes and per-variant inventory counts where the store exposes them (about half of Shopify stores do). Needed for inventory decrease / estimated units sold in change tracking. One extra request per product; billed only when it succeeds.",
"default": false
},
"includeStoreInfo": {
"title": "Store row: theme, apps & catalogue KPIs",
"type": "boolean",
"description": "Add one row per store with its theme, detected apps (Klaviyo, Recharge, Okendo, Gorgias, …), web pixels, country, currency and catalogue KPIs: share on sale, sold-out share, price range, new products in the last 7/30 days, top brands carried.",
"default": true
},
"minPriceChangePct": {
"title": "Ignore price changes smaller than (%)",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Change tracking only. Price increases and drops smaller than this percentage are not reported (e.g. 2 ignores a $0.50 move on a $30 product). Small moves still add up: the old price is kept until the total change crosses the threshold. 0 = report every change.",
"default": 0
},
"trackerKey": {
"title": "Tracker name",
"type": "string",
"description": "Change tracking only. Runs with the same tracker name share their memory of what was already seen. Leave empty to use the saved task (each task tracks on its own) or, without a task, the list of stores."
},
"storeConcurrency": {
"title": "Stores in parallel",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How many stores are read at the same time.",
"default": 5
},
"detailsConcurrency": {
"title": "Detail requests per store in parallel",
"minimum": 1,
"maximum": 8,
"type": "integer",
"description": "Parallel detail requests per store (barcodes & inventory). Kept low to be polite; the robots.txt Crawl-delay is always honoured.",
"default": 3
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}