{ "openapi": "3.0.1", "info": { "title": "Shopify App Store Scraper | App Pricing, Rankings, Reviews", "description": "Scrape the Shopify App Store at $0.75 per 1,000 apps on the free plan: every app pricing plan, category rankings, rating, reviews, developers with address and launch date. Start from apps, categories or developers; only-new mode for a daily watch.", "version": "0.2", "x-build-id": "TfDm7s4kYTlZbzdPC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aurelix~shopify-app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aurelix-shopify-app-store-scraper", "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/aurelix~shopify-app-store-scraper/runs": { "post": { "operationId": "runs-sync-aurelix-shopify-app-store-scraper", "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/aurelix~shopify-app-store-scraper/run-sync": { "post": { "operationId": "run-sync-aurelix-shopify-app-store-scraper", "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": { "appUrls": { "title": "Apps", "type": "array", "description": "Apps to read, as the app handle or any link to the app, e.g. 'klaviyo-email-marketing' or 'https://apps.shopify.com/judgeme'. Category and developer links pasted here are read as categories and developers.", "default": [], "items": { "type": "string" } }, "categoryUrls": { "title": "Categories", "type": "array", "description": "Categories to list, as a name, handle or link, e.g. 'Email marketing', 'product reviews' or 'https://apps.shopify.com/categories/store-design-site-optimization-seo'. A top-level category such as 'Marketing and conversion' lists all its sub-categories. Each app gets its rank in the category.", "default": [], "items": { "type": "string" } }, "developerUrls": { "title": "Developers", "type": "array", "description": "Developers (Shopify partners) whose apps to read, as the partner handle or link, e.g. 'klaviyo' or 'https://apps.shopify.com/partners/judge-me'.", "default": [], "items": { "type": "string" } }, "categorySort": { "title": "Category order", "enum": [ "popular", "newest" ], "type": "string", "description": "Order of apps in each category. 'Newest apps first' with 'Only new' on a daily schedule gives a feed of newly listed apps.", "default": "popular" }, "maxAppsPerCategory": { "title": "Max apps per category", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Upper limit of apps read from each category (and each developer), e.g. 24 for the first page. 0 = every app in it.", "default": 24 }, "appDetails": { "title": "Full app details", "type": "boolean", "description": "Open each app found in a category or developer page for the full row: pricing plans, rating breakdown, launch date, languages, integrations, features and developer details. Turn off for a fast rank list with name, rating, review count and price label only. Apps listed under 'Apps' always get full details.", "default": true }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Also return reviews for every app, one row each: stars, date, text, merchant store name and country, time using the app, and the developer's reply.", "default": false }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Upper limit of reviews per app, e.g. 100. 0 = every review (large apps have tens of thousands).", "default": 50 }, "reviewSort": { "title": "Review order", "enum": [ "newest", "relevance" ], "type": "string", "description": "Which reviews come first. Newest first is used automatically with 'Only new'.", "default": "newest" }, "onlyNewEntries": { "title": "Only new apps and reviews", "type": "boolean", "description": "Return only apps from categories and developers that earlier runs did not return, and only reviews not returned before. Apps you list under 'Apps' come back every run with their current rating and review count. Use with a daily schedule.", "default": false }, "slackWebhookUrl": { "title": "Slack webhook URL (optional)", "type": "string", "description": "Post a short digest of the run's results to Slack, e.g. https://hooks.slack.com/services/... Sent only when the run returned something." }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "POST a JSON digest (count, top results, run link) to this URL after the run, e.g. for n8n, Make or Zapier." }, "stateKey": { "title": "Memory name (optional)", "type": "string", "description": "Name for the 'only new' memory, e.g. 'competitor-reviews'. Runs with different names keep separate memories. Leave empty to share one memory across your runs." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional proxy. The Shopify App Store answers without one; turn on Apify Proxy only if runs get rate-limited (HTTP 429).", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }