{
"openapi": "3.0.1",
"info": {
"title": "Shopify App Store Scraper — Apps, Reviews & Developer Leads",
"description": "Scrape the Shopify App Store: app listings, pricing plans, ratings, ratings histogram, reviews, Built for Shopify badges, categories, languages & developer contact leads. Search by keyword, category, developer or URL. No login. Monitoring mode. Export JSON, CSV, Excel.",
"version": "1.0",
"x-build-id": "PH6BKIgaPK7ikQrWC"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~shopify-app-store-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~shopify-app-store-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-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/scrapesage~shopify-app-store-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-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": {
"searchQueries": {
"title": "Search queries",
"type": "array",
"description": "Keywords to search, e.g. email marketing, upsell, seo. Each keyword is matched to the most relevant Shopify App Store categories (via Shopify's own autocomplete) and every app in them is scraped, paginated until the app limit is reached.",
"items": {
"type": "string"
}
},
"categories": {
"title": "Categories",
"type": "array",
"description": "Category slugs or full category URLs to browse, e.g. marketing-and-conversion-marketing-email-marketing or https://apps.shopify.com/categories/store-design-notifications-pop-ups. Find slugs in any category page URL.",
"items": {
"type": "string"
}
},
"appHandles": {
"title": "App handles or URLs",
"type": "array",
"description": "Specific apps to scrape directly — the handle from the URL (klaviyo-email-marketing) or the full app URL. Fastest, most precise input.",
"items": {
"type": "string"
}
},
"developerHandles": {
"title": "Developer (partner) handles or URLs",
"type": "array",
"description": "Scrape every app published by a developer. Use the partner slug (klaviyo) or a full /partners/<slug> URL. Great for mapping a competitor's whole app portfolio.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Any Shopify App Store URLs: app pages, category pages, search result pages or /partners/<slug> pages. Each is auto-detected and routed.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"includeReviews": {
"title": "Include reviews",
"type": "boolean",
"description": "Fetch merchant reviews per app (rating, review text, store name, country, time using the app, and the developer's reply). Adds review pages per app.",
"default": false
},
"maxReviewsPerApp": {
"title": "Max reviews per app",
"minimum": 0,
"type": "integer",
"description": "Maximum reviews to fetch per app when 'Include reviews' is on (10 reviews per page).",
"default": 50
},
"reviewsSort": {
"title": "Reviews sort order",
"enum": [
"newest",
"oldest",
"highest_rating",
"lowest_rating",
"most_helpful"
],
"type": "string",
"description": "Order to fetch reviews in.",
"default": "newest"
},
"emitReviewRecords": {
"title": "Emit one record per review",
"type": "boolean",
"description": "In addition to the app records, push one flat record per review (type = \"review\") — a ready-to-analyse reviews table for sentiment/feature-request mining. Requires 'Include reviews'.",
"default": false
},
"enrichDeveloperContacts": {
"title": "Enrich developer contact leads",
"type": "boolean",
"description": "Visit each app developer's own website (home + contact/about, max 3 pages) and extract public contact emails, phone numbers and social links — turning every app into a B2B lead. The App Store never exposes these directly.",
"default": false
},
"maxApps": {
"title": "Max apps",
"minimum": 1,
"type": "integer",
"description": "Maximum number of apps to scrape across all inputs.",
"default": 100
},
"monitoringMode": {
"title": "Monitoring mode (only new apps)",
"type": "boolean",
"description": "Output only apps not seen in previous runs of the same input — ideal for scheduled runs that return ONLY newly listed apps in a category/search. Works alongside Apify Schedules: the schedule triggers the run, monitoring mode deduplicates results.",
"default": false
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 15,
"type": "integer",
"description": "How many apps to fetch in parallel. 5 is a safe, fast default for the Shopify App Store.",
"default": 5
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy settings. The default Apify Proxy works well for the Shopify App Store; no residential proxy is required.",
"default": {
"useApifyProxy": true
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}