{ "openapi": "3.0.1", "info": { "title": "Shopify App Store Scraper — Apps, Pricing Plans & Reviews", "description": "Scrape Shopify App Store apps by keyword, category, developer or URL: pricing plans, rating, rating breakdown, review count, developer, launch date, categories and features, languages, integrations, data access. Optional reviews with no reviewer names. No login, no browser.", "version": "0.1", "x-build-id": "cbcf78oblYIhWTbma" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kilndata~shopify-app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kilndata-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/kilndata~shopify-app-store-scraper/runs": { "post": { "operationId": "runs-sync-kilndata-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/kilndata~shopify-app-store-scraper/run-sync": { "post": { "operationId": "run-sync-kilndata-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords such as \"email marketing\", \"reviews\" or \"upsell\". An app matches when its store URL name contains every word (e.g. \"email marketing\" → klaviyo-email-marketing). Uses the store's official sitemap, so results are not in Shopify's search ranking order. Up to \"Max apps per search term / category\" apps per term.", "default": [], "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Category handles or URLs, e.g. \"marketing-and-conversion-marketing-email-marketing\" or \"https://apps.shopify.com/categories/store-design-images-and-media-image-gallery\". Apps come in the store's own category order, with their position saved in \"sourcePosition\".", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "App, developer or category URLs", "type": "array", "description": "Any mix of app URLs (https://apps.shopify.com/klaviyo-email-marketing), app handles (klaviyo-email-marketing), developer pages (https://apps.shopify.com/partners/klaviyo) and category or collection URLs.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Max apps per search term / category", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many apps to scrape for each search term, category, developer or collection. App URLs given directly are always scraped. An app found in several places is scraped (and charged) once.", "default": 50 }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Also scrape reviews: rating, date, text, reviewer country, time using the app and the developer's reply. The reviewer's store name is never collected. Each review is a separate item with \"type\": \"review\".", "default": false }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Upper limit of reviews per app (10 per page are read).", "default": 20 }, "reviewsSort": { "title": "Review order", "enum": [ "newest", "relevance" ], "type": "string", "description": "\"newest\" = most recent first (best for monitoring); \"relevance\" = the store's default order.", "default": "newest" }, "respectRobotsTxt": { "title": "Respect robots.txt", "type": "boolean", "description": "Skip pages that the store's robots.txt disallows. Skipped pages are not charged.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages are fetched in parallel. Keep it low to be polite to the store.", "default": 3 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 600, "type": "integer", "description": "Upper limit of page requests per minute.", "default": 60 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for a page before retrying.", "default": 30 }, "maxRetries": { "title": "Max retries per page", "minimum": 0, "maximum": 5, "type": "integer", "description": "How many times a failing page is retried. Apps that still fail are listed with status \"failed\" and are not charged.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The store works without a proxy. Use Apify Proxy only if you see many failed pages.", "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 } } } } } } } } } }