{ "openapi": "3.0.1", "info": { "title": "Shopify App Reviews Scraper — Filter & Sort by Rating", "description": "Scrape Shopify App Store reviews with exact per-star counts, not the rounded \"2.7K\" shown, for apps you name or the top apps of any category. Filter by star (1–5), sort by newest, helpful or rating, and track how the rating moves between runs. No login, no cookies.", "version": "0.1", "x-build-id": "U7bsRYKN63MMHYCv0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~shopify-app-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-shopify-app-reviews-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/northbell~shopify-app-reviews-scraper/runs": { "post": { "operationId": "runs-sync-northbell-shopify-app-reviews-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/northbell~shopify-app-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-northbell-shopify-app-reviews-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": { "appHandles": { "title": "Shopify apps", "type": "array", "description": "App handles, full listing URLs, or the app's name exactly as the App Store shows it (e.g. Klaviyo: Email Marketing & SMS). The handle is the last part of the URL: apps.shopify.com/klaviyo-email-marketing → klaviyo-email-marketing. Add your own app and your competitors'. Or leave this empty and use categories.", "items": { "type": "string" } }, "categories": { "title": "Or the top apps of a category", "type": "array", "description": "App Store categories as a slug or link, e.g. marketing-and-conversion-social-trust-product-reviews or https://apps.shopify.com/categories/… . The top apps of each (Shopify's own order, ads not counted) get their rating breakdown and reviews — no handles needed. Finding them is free.", "items": { "type": "string" } }, "appsPerCategory": { "title": "Apps per category", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many of each category's top apps to read.", "default": 5 }, "maxReviews": { "title": "Reviews per app", "minimum": 0, "maximum": 20000, "type": "integer", "description": "How many reviews to pull per app. 10 per page, so 100 is 10 requests. Set to 0 to fetch only the rating breakdown and skip review text entirely.", "default": 100 }, "sortBy": { "title": "Sort order", "enum": [ "newest", "rating", "helpful" ], "type": "string", "description": "Newest first is what you want for tracking. Rating and helpfulness are for one-off research.", "default": "newest" }, "ratingFilter": { "title": "Only these star ratings", "type": "array", "description": "Leave empty for all reviews. Set to 1 and 2 to pull only the complaints — on Shopify almost every 1-star review has written text, while most 5-star ones are a rating and nothing else.", "default": [], "items": { "type": "string" } }, "onlyNewSinceLastRun": { "title": "Only reviews new since the last run", "type": "boolean", "description": "For daily runs. Stops paging as soon as it reaches a review it already saw, so you pay for new reviews only. Requires 'Newest first'.", "default": false }, "maxRequestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 60, "type": "integer", "description": "Kept polite by default. The limit is shared across your runs of this Actor, so parallel runs will not stack up on Shopify.", "default": 30 } } }, "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 } } } } } } } } } }