{ "openapi": "3.0.1", "info": { "title": "Competitor SaaS Pricing Change Monitor", "description": "Track competitor SaaS pricing pages and product changelogs. Extract plans, prices, trials and discounts, then receive typed alerts when a price, plan or release changes.", "version": "2.1", "x-build-id": "aRcZtNFGbSNQyDJDZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/frank_conifer_af4~pricing-page-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-frank_conifer_af4-pricing-page-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/frank_conifer_af4~pricing-page-monitor/runs": { "post": { "operationId": "runs-sync-frank_conifer_af4-pricing-page-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/frank_conifer_af4~pricing-page-monitor/run-sync": { "post": { "operationId": "run-sync-frank_conifer_af4-pricing-page-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": { "pages": { "title": "Pages to monitor", "type": "array", "description": "Competitor pricing pages and product changelogs to monitor. Start with 3-10 competitors, then save the input as a daily or weekly task. Each entry can be a URL or {\"url\": \"...\", \"type\": \"pricing\" | \"changelog\" | \"auto\", \"label\": \"...\"}. RSS/Atom feeds work as changelogs. Charged once per page analyzed successfully." }, "monitorChanges": { "title": "Detect changes since the last run", "type": "boolean", "description": "Store a normalized snapshot of every page in a named key-value store and compare it with the previous run. The first run records a baseline; later runs report typed changes (price_changed, plan_added, plan_removed, trial_changed, free_plan_changed, discount_changed, new_changelog_entry). Turn off for one-off extraction. Does not affect cost.", "default": true }, "snapshotStoreName": { "title": "Snapshot store name", "type": "string", "description": "Named key-value store that keeps the previous snapshots between runs. Use a different name per project or schedule if you want separate baselines. Lowercase letters, digits and hyphens.", "default": "saas-pricing-snapshots" }, "onlyOutputChanges": { "title": "Only output changed pages", "type": "boolean", "description": "If enabled, the dataset only contains pages with changeStatus \"changed\", plus pages that failed or returned no data (so you notice broken monitors). Unchanged and baseline pages are still analyzed and charged, but not written to the dataset.", "default": false }, "webhookUrl": { "title": "Webhook URL for changes", "type": "string", "description": "Optional. After the run, a JSON summary of all detected changes is POSTed here (only when at least one page changed). The payload has a Slack-compatible \"text\" field, so a Slack incoming webhook URL works directly. Not charged." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Many SaaS sites show local currencies by visitor country, so for stable monitoring keep the same proxy country between runs (for example US). Without a proxy, pages are requested directly." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many pages are fetched in parallel. Higher is faster for long lists; cost is the same.", "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 } } } } } } } } } }