{ "openapi": "3.0.1", "info": { "title": "Shopify App Store Tracker — Ratings, Pricing & Developer Data", "description": "Scrape apps.shopify.com for Shopify app listings by keyword or category. Extract ratings, review counts, pricing models, developer names, taglines, and descriptions for competitor research, market analysis, partner prospecting, and App Store tracking.", "version": "1.1", "x-build-id": "m3j98Qh6J1ZerwHsQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/actorpilot~shopify-app-store-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-actorpilot-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/actorpilot~shopify-app-store-tracker/runs": { "post": { "operationId": "runs-sync-actorpilot-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/actorpilot~shopify-app-store-tracker/run-sync": { "post": { "operationId": "run-sync-actorpilot-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": "Discovery mode", "enum": [ "apps", "search", "category", "top_rated" ], "type": "string", "description": "Use App URLs for the most stable monitoring and Store smoke tests. Search and category modes discover apps from Shopify listing pages.", "default": "apps" }, "appUrls": { "title": "App URLs", "type": "array", "description": "Public Shopify App Store detail pages to scrape in App URLs mode. This default is intentionally small and reliable for Store health checks.", "default": [ { "url": "https://apps.shopify.com/klaviyo-email-marketing" }, { "url": "https://apps.shopify.com/mailchimp" }, { "url": "https://apps.shopify.com/omnisend" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "query": { "title": "Search query", "type": "string", "description": "Keyword for Search mode. Examples: SEO, email marketing, upsell, loyalty program, reviews.", "default": "email marketing" }, "category": { "title": "Category", "enum": [ "finding-products", "selling-products", "orders-and-shipping", "store-design", "marketing-and-conversion", "store-management", "sales-channels" ], "type": "string", "description": "Shopify App Store category for Category mode.", "default": "marketing-and-conversion" }, "maxResults": { "title": "Maximum apps", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of app records to save. Keep this low for smoke tests and increase it for market maps.", "default": 3 }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only save apps with this rating or higher. Use 0 to keep all apps.", "default": 0 }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "Number of app detail pages fetched in parallel. Lower values are gentler and more stable.", "default": 2 }, "maxRetries": { "title": "Request retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries for temporary timeouts, 429 responses, and 5xx errors.", "default": 2 }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 5, "maximum": 60, "type": "integer", "description": "Timeout per Shopify request in seconds.", "default": 20 }, "testMode": { "title": "Test mode", "type": "boolean", "description": "For fast smoke tests. Forces App URLs mode and limits the run to at most 3 apps.", "default": false }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Optional named key-value store for change tracking across scheduled runs. Leave empty for one-off exports." } } }, "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 } } }, "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 } } } } } } } } } }