{ "openapi": "3.0.1", "info": { "title": "Shopify App Store & Theme Store Scraper - Apps and Themes", "description": "Scrape Shopify App Store and Theme Store listings by category: name, developer, rating, review count, pricing and the Built for Shopify badge. Category and sitemap discovery.", "version": "1.0", "x-build-id": "HaTl072hWOeJc3NLf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maydit~shopify-app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maydit-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/maydit~shopify-app-store-scraper/runs": { "post": { "operationId": "runs-sync-maydit-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/maydit~shopify-app-store-scraper/run-sync": { "post": { "operationId": "run-sync-maydit-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": { "mode": { "title": "What to scrape", "enum": [ "apps", "themes" ], "type": "string", "description": "Choose the Shopify App Store (apps.shopify.com) or the Shopify Theme Store (themes.shopify.com). Both produce the same record shape, with a 'type' field of app or theme. Leave it alone to scrape apps." }, "categories": { "title": "Categories / collections", "type": "array", "description": "App Store category slugs. Prefer a leaf (third-level) slug such as store-design-site-optimization-seo, marketing-and-conversion-marketing-email-marketing or orders-and-shipping-shipping-solutions-shipping: those have a paginated browse grid and can return hundreds of apps. A shorter parent slug like store-design-site-optimization also works, but Shopify publishes no browse grid for it, so it returns only the ~25-30 apps curated on that one page. The full list is at https://apps.shopify.com/sitemap_categories_en.xml. In themes mode these are Theme Store collection slugs - free-themes, trending-themes, new-themes, horizon-themes, large-inventory, small-inventory - or the word all for the whole /themes page. Pasting a full category URL works too. Leave empty to use a fast sample category.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many app or theme records in total, across every category selected. Each app costs one listing page request (20 apps per page) plus one detail page request, so a larger number needs a larger maxRunSeconds.", "default": 60 }, "includeDetails": { "title": "Also open each app's page to get the developer", "type": "boolean", "description": "App category cards carry everything except the developer name, so this adds one request per app to read it (plus developerUrl). apps.shopify.com throttles above about two requests a second, so 60 apps takes roughly 90-100 seconds instead of 2, and a few rows can still come back with a null developer if Shopify throttles hard - raise maxRunSeconds when you turn it on. Ignored in themes mode, where the detail page is always loaded because the developer, tagline and review count only exist there.", "default": false }, "onlyNewSinceLastRun": { "title": "Only listings not seen in a previous run", "type": "boolean", "description": "Change detection. The actor remembers the handles it has already returned for this mode and category set, and skips them next time, so a scheduled run gives you only the new arrivals. The first run always returns everything. When nothing new has appeared the run finishes successfully with an empty dataset - that is the 'no changes' answer, not an error.", "default": false }, "maxRunSeconds": { "title": "Time budget (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Hard wall-clock limit. The crawl stops cleanly when the budget runs out and keeps every record collected so far, so the run still succeeds. Raise it for large jobs. Listing-only runs are fast (60 app records in about 2 seconds); with developer lookups on, budget about one record per second.", "default": 240 } } }, "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 } } } } } } } } } }