{
"openapi": "3.0.1",
"info": {
"title": "Shopify App Store Scraper – Apps, Pricing Plans & App Reviews",
"description": "Shopify App Store scraper (apps.shopify.com): search Shopify apps by keyword, list categories, get full app details (pricing plans, rating breakdown, developer, categories, languages, integrations, launch date) and Shopify app reviews with developer replies. No login, no browser.",
"version": "1.0",
"x-build-id": "DEg0SlPs6rPuL1Nf2"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/openharvest~shopify-app-store-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-openharvest-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/openharvest~shopify-app-store-scraper/runs": {
"post": {
"operationId": "runs-sync-openharvest-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/openharvest~shopify-app-store-scraper/run-sync": {
"post": {
"operationId": "run-sync-openharvest-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": [
"search",
"category",
"appDetails",
"reviews"
],
"type": "string",
"description": "Search: apps matching keywords. Category: apps listed in a category. App details: full data for the apps you list. Reviews: merchant reviews of the apps you list.",
"default": "search"
},
"searchQueries": {
"title": "Search keywords (mode: Search)",
"type": "array",
"description": "Keywords to search for, exactly as in the App Store search box, e.g. email marketing, product reviews, upsell.",
"default": [
"email marketing"
],
"items": {
"type": "string"
}
},
"categories": {
"title": "Categories (mode: Category)",
"type": "array",
"description": "Category URLs or handles, e.g. https://apps.shopify.com/categories/marketing-and-conversion-social-trust-product-reviews or store-design. Top-level categories are expanded into their sub-categories.",
"items": {
"type": "string"
}
},
"appUrls": {
"title": "Apps (modes: App details, Reviews)",
"type": "array",
"description": "App URLs or handles, e.g. https://apps.shopify.com/judgeme or klaviyo-email-marketing.",
"items": {
"type": "string"
}
},
"maxApps": {
"title": "Max apps per search / category",
"minimum": 0,
"type": "integer",
"description": "How many apps to return for each keyword or category (in App Store order). Set to 0 for all. You pay per app.",
"default": 20
},
"fetchAppDetails": {
"title": "Fetch full app details",
"type": "boolean",
"description": "For Search and Category modes: open every app page to get pricing plans, developer, categories, languages, integrations, launch date, description and rating breakdown. Turn off for a fast list with name, rating, review count and pricing summary only (same price per app).",
"default": true
},
"includeAds": {
"title": "Include sponsored results",
"type": "boolean",
"description": "Search and category pages show paid ads at the top. By default they are skipped so positions reflect organic ranking.",
"default": false
},
"maxReviewsPerApp": {
"title": "Max reviews per app (mode: Reviews)",
"minimum": 0,
"type": "integer",
"description": "How many reviews to return per app. Set to 0 for all (popular apps have tens of thousands). You pay per review.",
"default": 100
},
"reviewsSort": {
"title": "Sort reviews by",
"enum": [
"newest",
"relevance"
],
"type": "string",
"description": "Newest first, or the App Store's \"Most relevant\" order.",
"default": "newest"
},
"reviewsRating": {
"title": "Only reviews with rating",
"enum": [
"all",
"5",
"4",
"3",
"2",
"1"
],
"type": "string",
"description": "Optionally keep only reviews with this star rating (e.g. 1 to analyse complaints).",
"default": "all"
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Usually not needed. Enable Apify Proxy for very large runs if you see many HTTP 429 (rate limit) warnings.",
"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
}
}
}
}
}
}
}
}
}
}