{ "openapi": "3.0.1", "info": { "title": "Multi-Store Stock Alert", "description": "Watch the same product across Amazon, eBay and any Shopify storefront in one run. Normalises every source into one feed, names the cheapest place to buy right now, and alerts you when a target price is met or something comes back in stock.", "version": "0.1", "x-build-id": "BMbVacOEJ8cWAcROB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arched_friend~multi-store-stock-alert/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arched_friend-multi-store-stock-alert", "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/arched_friend~multi-store-stock-alert/runs": { "post": { "operationId": "runs-sync-arched_friend-multi-store-stock-alert", "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/arched_friend~multi-store-stock-alert/run-sync": { "post": { "operationId": "run-sync-arched_friend-multi-store-stock-alert", "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": { "productLabel": { "title": "Product label", "type": "string", "description": "An optional name for what you are tracking, copied onto every row so several scheduled runs stay readable in one dataset." }, "amazonAsins": { "title": "Amazon ASINs", "type": "array", "description": "ASINs or Amazon product URLs to check. Leave empty to skip Amazon entirely.", "items": { "type": "string" } }, "amazonMarketplace": { "title": "Amazon marketplace", "enum": [ "US", "UK", "DE", "FR", "IT", "ES", "CA", "JP", "IN", "AU" ], "type": "string", "description": "Which Amazon site to price against.", "default": "US" }, "ebayKeywords": { "title": "eBay search terms", "type": "array", "description": "What to search for on eBay. Leave empty to skip eBay entirely.", "items": { "type": "string" } }, "ebaySite": { "title": "eBay site", "enum": [ "US", "UK", "DE", "FR", "IT", "ES", "CA", "AU" ], "type": "string", "description": "Which eBay site to search. Keep this in the same country as the Amazon marketplace so prices are comparable.", "default": "US" }, "shopifyStores": { "title": "Shopify stores", "type": "array", "description": "Shopify storefront domains to check, for example gymshark.com. Leave empty to skip Shopify entirely.", "items": { "type": "string" } }, "titleMustContain": { "title": "Product name words", "type": "array", "description": "Keep only offers whose title contains one of these words. Strongly recommended whenever a Shopify store is included, because a storefront returns its whole catalogue and an unscoped comparison will name an unrelated product as the cheapest.", "items": { "type": "string" } }, "maxShopifyProductsPerStore": { "title": "Shopify products per store", "minimum": 1, "type": "integer", "description": "Upper limit on how many products to read from each Shopify store.", "default": 1000 }, "targetPrice": { "title": "Target price", "minimum": 0, "type": "integer", "description": "Alert when any in-stock offer reaches this price or lower. 0 turns the target off.", "default": 0 }, "onlyAlerts": { "title": "Only rows worth alerting on", "type": "boolean", "description": "Return only price drops, stock flips, new listings and buy box changes. Turn this on for scheduled monitoring.", "default": false }, "onlyInStock": { "title": "Only offers in stock", "type": "boolean", "description": "Drop anything that cannot actually be bought right now.", "default": false }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Keep only offers at or below this price. 0 means no maximum.", "default": 0 }, "sourceTimeoutSecs": { "title": "Timeout per source", "minimum": 60, "maximum": 3600, "type": "integer", "description": "How long each source Actor may run before it is given up on. One slow source will not stop the others being reported.", "default": 600 } } }, "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 } } } } } } } } } }