{ "openapi": "3.0.1", "info": { "title": "MAP Price Policy Evidence Monitor", "description": "Compare public product-page prices with a brand's own advertised-price rules, reconcile each seller against the supplied approved list, and save one evidence package per material price incident.", "version": "0.1", "x-build-id": "C2s0JXgvVkhMO4bPn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plusonets~map-price-policy-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plusonets-map-price-policy-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/plusonets~map-price-policy-monitor/runs": { "post": { "operationId": "runs-sync-plusonets-map-price-policy-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/plusonets~map-price-policy-monitor/run-sync": { "post": { "operationId": "run-sync-plusonets-map-price-policy-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": { "monitorId": { "title": "Monitor id", "type": "string", "description": "Separates saved state when you watch more than one brand from the same Apify account. Letters, numbers, hyphens, and underscores.", "default": "sample" }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Public product-page URLs. Optional sku, gtin, mpn, and variantId tie the page to your catalog. Leave this empty to run the built-in sample.", "default": [ { "url": "https://www.graza.co/products/hot-n-sweet-olive-oil-potato-chips", "sku": "CHP-HS55" }, { "url": "https://olaplex.com/products/olaplex-the-healthy-hair-travel-set-us", "sku": "VB000030" }, { "url": "https://www.beardbrand.com/products/fox-hunt-mens-cologne", "sku": "32836920" } ] }, "productUrlsCsv": { "title": "Product URLs CSV", "type": "string", "description": "Optional CSV with columns url, sku, gtin, mpn, variantId. Used when Product URLs is empty.", "default": "" }, "catalog": { "title": "Catalog", "type": "array", "description": "Your products. Each object needs sku and should include gtin, mpn, title, packSize, and brand.", "default": [ { "sku": "CHP-HS55", "gtin": "850062393370", "mpn": "850062393370", "title": "Hot 'n Sweet Olive Oil Potato Chips", "packSize": 1, "brand": "Graza" }, { "sku": "VB000030", "gtin": null, "mpn": "VB000030", "title": "THE HEALTHY HAIR TRAVEL SET", "packSize": 1, "brand": "OLAPLEX" }, { "sku": "32836920", "gtin": null, "mpn": "32836920", "title": "Fox Hunt Men's Cologne", "packSize": 1, "brand": "Beardbrand" } ] }, "catalogCsv": { "title": "Catalog CSV", "type": "string", "description": "Optional CSV with columns sku, gtin, mpn, title, packSize, brand. Used when Catalog is empty.", "default": "" }, "policies": { "title": "Advertised-price policies", "type": "array", "description": "Thresholds you supply. Each rule needs policyId, sku, minAdvertisedPrice, currency, and effectiveFrom (YYYY-MM-DD). Optional effectiveTo, packSize, and appliesToCondition (new, used, or refurbished).", "default": [ { "policyId": "SAMPLE-CHIPS", "sku": "CHP-HS55", "minAdvertisedPrice": 24, "currency": "USD", "effectiveFrom": "2026-01-01", "effectiveTo": null, "packSize": 1, "appliesToCondition": "new" }, { "policyId": "SAMPLE-OLAPLEX", "sku": "VB000030", "minAdvertisedPrice": 0.01, "currency": "USD", "effectiveFrom": "2026-01-01", "effectiveTo": null, "packSize": 1, "appliesToCondition": "new" }, { "policyId": "SAMPLE-COLOGNE", "sku": "32836920", "minAdvertisedPrice": 0.01, "currency": "USD", "effectiveFrom": "2026-01-01", "effectiveTo": null, "packSize": 1, "appliesToCondition": "new" } ] }, "policiesCsv": { "title": "Policies CSV", "type": "string", "description": "Optional CSV with columns policyId, sku, minAdvertisedPrice, currency, effectiveFrom, effectiveTo, packSize, appliesToCondition.", "default": "" }, "approvedSellers": { "title": "Approved sellers", "type": "array", "description": "Sellers and aliases you supplied. A page that matches none of them is reported as seller not matched to the supplied list.", "default": [ { "sellerId": "graza", "name": "Graza", "aliases": [ "Graza", "Graza Olive Oil" ], "domains": [ "graza.co", "www.graza.co" ] }, { "sellerId": "olaplex", "name": "OLAPLEX", "aliases": [ "OLAPLEX", "OLAPLEX Inc.", "Olaplex" ], "domains": [ "olaplex.com", "www.olaplex.com" ] } ] }, "approvedSellersCsv": { "title": "Approved sellers CSV", "type": "string", "description": "Optional CSV with columns sellerId, name, aliases, domains. Separate aliases and domains with a pipe character.", "default": "" }, "exemptions": { "title": "Exemptions", "type": "array", "description": "Offers you want excluded from evidence packages. sku and sellerId are optional filters. floorPrice, when set, is the lowest price the exemption still covers.", "default": [ { "exemptionId": "SAMPLE-UNUSED", "sku": "NOT-IN-THIS-RUN", "sellerId": "graza", "reason": "Example exemption shape. It does not match the sample URLs.", "effectiveFrom": "2026-01-01", "effectiveTo": "2026-12-31", "condition": "new", "floorPrice": null } ] }, "exemptionsCsv": { "title": "Exemptions CSV", "type": "string", "description": "Optional CSV with columns exemptionId, sku, sellerId, reason, effectiveFrom, effectiveTo, condition, floorPrice.", "default": "" }, "useSampleInput": { "title": "Use the built-in sample when no URLs or catalog are provided", "type": "boolean", "description": "Turn this off to refuse a run that has no product URLs and no catalog.", "default": true }, "recheckExceptions": { "title": "Recheck prices that are below a supplied threshold", "type": "boolean", "description": "Fetch the page a second time before writing an evidence package. A disagreement produces no package.", "default": true }, "alertOnlyOnChange": { "title": "Dataset rows only when the observation changed", "type": "boolean", "description": "Keep the full summary in the OUTPUT record, and write dataset rows for new or changed observations and for new evidence packages.", "default": false }, "captureScreenshot": { "title": "Capture a screenshot for each new evidence package", "type": "boolean", "description": "Uses a browser after the static extract. Set the run memory to 2048 MB. The package is still delivered if the screenshot is skipped.", "default": false }, "allowBrowserEscalation": { "title": "Render a page only when static extraction finds no price", "type": "boolean", "description": "Static Shopify JSON and JSON-LD run first. Set the run memory to 2048 MB before enabling this.", "default": false }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Pause between HTTP requests to the stores you listed.", "default": 800 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 60, "type": "integer", "description": "Per-request timeout.", "default": 20 }, "maxUrls": { "title": "Maximum URLs", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard stop for this run. Raise it deliberately; every completed offer check is billable.", "default": 100 }, "maxChargeUsd": { "title": "Stop after this estimated charge (USD)", "type": "number", "description": "Optional cap using the suggested prices of $0.01 per offer check and $0.10 per evidence package. The run also stops when Apify reports that the platform max total charge is reached. Leave empty for no extra cap." }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Named key-value store that keeps baselines and delivered incident ids across runs. An unreadable record is not overwritten.", "default": "map-price-policy-state" } } }, "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 } } } } } } } } } }