{ "openapi": "3.0.1", "info": { "title": "App Store Reviews Scraper | Multi-Country, Rating & Version", "description": "Extract Apple App Store reviews from multiple country storefronts in a single run. Filter by star rating to find complaints or app version to see what a release fixed or broke. Returns review text, title, rating, version, author, vote counts and timestamps and app metadata. No account/API required.", "version": "0.0", "x-build-id": "kU50dH3MUL00rgYe7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dvntvent~app-store-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dvntvent-app-store-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/dvntvent~app-store-reviews-scraper/runs": { "post": { "operationId": "runs-sync-dvntvent-app-store-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/dvntvent~app-store-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-dvntvent-app-store-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": { "appIds": { "title": "App IDs", "type": "array", "description": "Numeric App Store IDs. Take the digits after 'id' in the store URL, so apps.apple.com/gb/app/duolingo/id570060128 gives 570060128. Fill in this field or search terms, or both.", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "App names to look up instead of IDs. Each term resolves to its best match in the first storefront listed below. Use App IDs when you need certainty about which app you get.", "default": [], "items": { "type": "string" } }, "maxAppsPerSearchTerm": { "title": "Apps per search term", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many apps each search term brings back. Leave at 1 to look up one known app. Raise it to pull a whole competitor set from one term, for example the top 10 matches for 'language learning'. Each extra app multiplies the reviews you pay for, so raise it deliberately.", "default": 1 }, "countries": { "title": "Storefronts", "type": "array", "description": "Two-letter storefront codes such as gb, us, au, de. Apple keeps reviews separate per storefront, so a US review never appears in the GB feed. Listing several here is how you get past the 500-review ceiling on any single one.", "default": [ "gb" ], "items": { "type": "string" } }, "sortBy": { "title": "Sort order", "enum": [ "mostRecent", "mostHelpful" ], "type": "string", "description": "Which of Apple's two review orderings to read.", "default": "mostRecent" }, "maxReviewsPerApp": { "title": "Maximum reviews per app", "minimum": 1, "type": "integer", "description": "Upper bound on rows written per app, counted across every storefront you listed. Storefronts fill in the order given.", "default": 200 }, "minRating": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Set both this and the maximum to 2 to read only the complaints.", "default": 1 }, "maxRating": { "title": "Maximum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Upper bound on star rating, inclusive.", "default": 5 }, "versions": { "title": "App versions", "type": "array", "description": "Keep only reviews left against these release strings, for example 7.137.0. Leave empty for every version. This is how you find out what a specific release broke.", "default": [], "items": { "type": "string" } }, "includeAppMetadata": { "title": "Attach app metadata", "type": "boolean", "description": "Adds developer, current version, average rating, rating count, genre, price and release date to every row.", "default": true }, "deduplicateAcrossSorts": { "title": "Read both sort orders", "type": "boolean", "description": "Reads most recent and most helpful, then drops reviews seen twice. The two orderings overlap without matching, so this returns more unique reviews per storefront at the cost of roughly double the requests.", "default": 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 } } } } } } } } } }