{ "openapi": "3.0.1", "info": { "title": "Shopify App Store History Scraper - Daily Ranks, Reviews", "description": "Shopify App Store tracker with daily history. Our own archive snapshots about 26,000 apps every day (rating, review count, pricing label, Built for Shopify, rank in each of 90 leaf categories, new and delisted apps). Ask which apps gain reviews fastest, who moves up in a category, which apps launche", "version": "0.1", "x-build-id": "B8TlthJ2mS8K4sYQq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/martin10291~shopify-app-store-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-martin10291-shopify-app-store-tracker", "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~shopify-app-store-tracker/runs": { "post": { "operationId": "runs-sync-martin10291-shopify-app-store-tracker", "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~shopify-app-store-tracker/run-sync": { "post": { "operationId": "run-sync-martin10291-shopify-app-store-tracker", "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": { "mode": { "title": "Mode", "enum": [ "velocity", "category", "apps", "new", "categories" ], "type": "string", "description": "velocity = apps ranked by reviews gained; category = ranked list of one category with rank changes; apps = current numbers plus daily history for chosen apps; new = newly listed and delisted apps; categories = the 90 category slugs with app counts.", "default": "velocity" }, "category": { "title": "Category", "type": "string", "description": "Leaf category slug or full apps.shopify.com/categories URL. Required in category mode, optional filter in velocity mode (empty = all apps). Get all slugs with mode categories.", "default": "marketing-and-conversion-social-trust-product-reviews" }, "apps": { "title": "Apps", "type": "array", "description": "App handles (the last part of apps.shopify.com/) or full app URLs. Used in apps mode.", "default": [ "judgeme", "flow" ], "items": { "type": "string" } }, "lookbackDays": { "title": "Lookback days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Compare today with this many days ago (velocity mode). The archive starts on 2026-11-03, so the maximum useful value is the number of days since then.", "default": 30 }, "minReviews": { "title": "Minimum reviews", "minimum": 0, "type": "integer", "description": "Skip apps with fewer total reviews than this (velocity mode). Use it to hide brand-new apps with a handful of reviews.", "default": 0 }, "since": { "title": "Since date", "type": "string", "description": "Only in new mode: show apps listed or delisted since this date, format YYYY-MM-DD. Empty = since the start of the archive.", "default": "" }, "limit": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of rows to return (1 to 1000). You pay per result.", "default": 50 }, "onlyNew": { "title": "Only new or changed since last run", "type": "boolean", "description": "For alerts: in new mode output only apps not reported before; in the other modes output only rows whose reviews, rating or rank changed since the last run with the same Monitor ID. The first run reports everything. Each result is paid for once.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Separate memory for each watch list (used with only-new mode). Use a different ID per category or list of apps.", "default": "default" } } }, "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 } } } } } } } } } }