{ "openapi": "3.0.1", "info": { "title": "Product Price Scraper - Any Store, Price History, Restocks", "description": "Watches product prices in any online store and alerts you on price drops, increases and restocks via Discord, Slack, Telegram or any webhook. Keeps price history, lowest and highest price.", "version": "0.1", "x-build-id": "FIJZh7fGOAfWX32K3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/martin10291~price-drop-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-martin10291-price-drop-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/martin10291~price-drop-monitor/runs": { "post": { "operationId": "runs-sync-martin10291-price-drop-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/martin10291~price-drop-monitor/run-sync": { "post": { "operationId": "run-sync-martin10291-price-drop-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", "properties": { "productUrls": { "title": "Product page URLs to watch", "type": "array", "description": "Product pages from any online stores (Shopify, WooCommerce, Magento, BigCommerce and most shops with product data).", "items": { "type": "string" } }, "watchlistName": { "title": "Watchlist name (optional)", "type": "string", "description": "Keeps price history per watchlist. Use different names for different product lists. Empty = derived from the URLs." }, "alertOn": { "title": "Alert on", "type": "array", "description": "Changes that trigger an alert: price_drop, price_increase, back_in_stock, out_of_stock.", "default": [ "price_drop", "back_in_stock" ], "items": { "type": "string" } }, "minDropPercent": { "title": "Minimum drop (%)", "minimum": 0, "maximum": 90, "type": "integer", "description": "Ignore price drops smaller than this percentage.", "default": 0 }, "discordWebhookUrl": { "title": "Discord webhook URL", "type": "string", "description": "Server Settings → Integrations → Webhooks → Copy URL." }, "slackWebhookUrl": { "title": "Slack incoming webhook URL", "type": "string", "description": "Slack app → Incoming Webhooks." }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Token from @BotFather (use with chat ID)." }, "telegramChatId": { "title": "Telegram chat ID", "type": "string", "description": "User, group or channel ID for alerts." }, "webhookUrl": { "title": "Any webhook URL (Zapier, Make, n8n)", "type": "string", "description": "Receives a JSON POST with the changes." }, "onlyChanges": { "title": "Save only changed products", "type": "boolean", "description": "Dataset contains only products whose price or stock changed (cheaper on schedules).", "default": false }, "maxItems": { "title": "Max products saved", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard limit on dataset rows (and cost).", "default": 500 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy helps with stores that block servers.", "default": { "useApifyProxy": true } }, "datasetId": { "title": "Dataset (integration input)", "type": "string", "description": "Optional. Pick a dataset (or paste its ID) to read the input from, for example the result of Google Maps Scraper. When this actor runs as an integration, the dataset of the triggering run is used automatically (payload.resource.defaultDatasetId), so you can leave this empty. If set, the values found in the dataset replace the main input list." }, "datasetField": { "title": "Dataset field", "type": "string", "description": "Optional. The item field that holds the value, for example website, url or videoUrl (dot paths like author.url work). Empty = detected automatically." }, "datasetMaxItems": { "title": "Max values from the dataset", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper limit of unique values taken from the dataset, to keep the cost under control.", "default": 1000 } } }, "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 } } } } } } } } } }