{ "openapi": "3.0.1", "info": { "title": "Apify Store Opportunity Radar: Gaps, Prices & Alerts", "description": "Prioritize Actor ideas using public Store aggregate metrics: explainable category scores, compatible prices, your own weekly snapshots, and watchlist alerts. Not a listing mirror or a revenue forecast.", "version": "0.2", "x-build-id": "XdDrCgMYJrqV9wobJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/clearfeedlabs~apify-store-market-intel/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-clearfeedlabs-apify-store-market-intel", "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/clearfeedlabs~apify-store-market-intel/runs": { "post": { "operationId": "runs-sync-clearfeedlabs-apify-store-market-intel", "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/clearfeedlabs~apify-store-market-intel/run-sync": { "post": { "operationId": "run-sync-clearfeedlabs-apify-store-market-intel", "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": { "categories": { "title": "Categories", "maxItems": 30, "type": "array", "description": "Limit the opportunity report and movers to these Store categories. Empty means all categories observed in the crawl.", "items": { "type": "string", "enum": [ "AI", "AGENTS", "AUTOMATION", "BUSINESS", "COVID_19", "DEVELOPER_EXAMPLES", "DEVELOPER_TOOLS", "ECOMMERCE", "EDUCATION", "FOR_CREATORS", "GAMES", "INTEGRATIONS", "JOBS", "LEAD_GENERATION", "MARKETING", "MCP_SERVERS", "NEWS", "OPEN_SOURCE", "OTHER", "REAL_ESTATE", "SEO_TOOLS", "SOCIAL_MEDIA", "SPORTS", "TRAVEL", "VIDEOS" ] } }, "includeGapReport": { "title": "Opportunity report", "type": "boolean", "description": "Category scores, movers, and price changes. Charged as gap-report at $0.10 after those rows are stored. The platform also charges the mandatory Actor start event, and every run that stores a market summary charges snapshot at $0.02.", "default": true }, "moversCount": { "title": "Movers to list", "minimum": 0, "maximum": 200, "type": "integer", "description": "Fastest-growing Actors by week-over-week 30-day users once a previous complete snapshot exists. Before that, the list uses 7-day momentum.", "default": 20 }, "detailTopN": { "title": "Leaders checked for modified time", "minimum": 0, "maximum": 10, "type": "integer", "description": "On every run, fetches modifiedAt for this many leaders in each reported category. A build count is not used as a modified time.", "default": 5 }, "enableAlerts": { "title": "Watchlist alerts ($0.02 per stored alert)", "type": "boolean", "description": "Stores an alert row only when a previous complete snapshot exists. Dropped-from-listing alerts also require this run's listing to be complete. Incomplete crawls do not create dropped alerts.", "default": false }, "watchlist": { "title": "Watchlist", "maxItems": 200, "type": "array", "description": "Actors as username/actor-name, for example apify/website-content-crawler. A tilde is accepted in place of the slash.", "items": { "type": "string", "pattern": "^[\\w.-]{1,60}[/~][\\w.-]{1,80}$" } }, "alertUserChangePct": { "title": "User change alert threshold (%)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Alert when a watchlisted Actor's 30-day public users change by at least this percent and by at least 3 users. Missing user stats do not become zero.", "default": 20 }, "deepDiveCategories": { "title": "Category deep-dives ($0.25 each stored dive)", "maxItems": 5, "type": "array", "description": "Up to 5 categories. A deep-dive is charged only after its leaderboard row is stored. A category with no observed Actors stores nothing and is not charged.", "items": { "type": "string", "enum": [ "AI", "AGENTS", "AUTOMATION", "BUSINESS", "COVID_19", "DEVELOPER_EXAMPLES", "DEVELOPER_TOOLS", "ECOMMERCE", "EDUCATION", "FOR_CREATORS", "GAMES", "INTEGRATIONS", "JOBS", "LEAD_GENERATION", "MARKETING", "MCP_SERVERS", "NEWS", "OPEN_SOURCE", "OTHER", "REAL_ESTATE", "SEO_TOOLS", "SOCIAL_MEDIA", "SPORTS", "TRAVEL", "VIDEOS" ] } }, "deepDiveSize": { "title": "Deep-dive leaderboard size", "minimum": 5, "maximum": 100, "type": "integer", "description": "How many top Actors to include in each deep-dive leaderboard. Modified times are fetched for at most 25 of them.", "default": 25 }, "historyKey": { "title": "History key", "pattern": "^[\\w-]{1,30}$", "minLength": 1, "maxLength": 30, "type": "string", "description": "Weekly baselines are stored in your account's named key-value store apify-store-intel-history. Runs of the same Actor task share a key. Two tasks do not share a baseline unless they are the same task. Ad-hoc runs with no task id use the notask scope.", "default": "default" }, "maxPages": { "title": "Max listing pages (1,000 Actors each)", "minimum": 1, "maximum": 120, "type": "integer", "description": "Safety cap on Store listing pages. The run reports pages fetched, Actors observed, the API total, and whether the listing was complete. Hitting this cap does not count as a full listing and does not replace the weekly baseline. The public Store API currently returns Actors only up to about offset 15,000; the scan then ends as an observed cohort.", "default": 30 } } }, "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 } } } } } } } } } }