{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Reviews Scraper with Review Themes", "description": "Scrape App Store and Google Play reviews (rating, title, text, date, app version, country, developer reply) and get an automatic report of top complaints and praise with counts and example quotes.", "version": "0.1", "x-build-id": "hW44rgcW79OBGwmXe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidydata-labs~app-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidydata-labs-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/tidydata-labs~app-reviews-scraper/runs": { "post": { "operationId": "runs-sync-tidydata-labs-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/tidydata-labs~app-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-tidydata-labs-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": { "appStoreApps": { "title": "App Store apps", "type": "array", "description": "App Store app URLs (https://apps.apple.com/us/app/name/id123456789) or numeric app IDs.", "items": { "type": "string" } }, "googlePlayApps": { "title": "Google Play apps", "type": "array", "description": "Google Play app URLs (https://play.google.com/store/apps/details?id=com.example) or package names.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes. App Store reviews are separate per country, so each country adds more reviews (up to 500 per country). Google Play uses only the first country.", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Google Play review language", "type": "string", "description": "Two-letter language code for Google Play reviews, e.g. en, es, de.", "default": "en" }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum reviews to save per app (across all countries). You are charged per saved review. Apple's public feed serves up to 500 reviews per country.", "default": 500 }, "sortBy": { "title": "Sort by", "enum": [ "newest", "mostHelpful" ], "type": "string", "description": "Which reviews to collect first.", "default": "newest" }, "minRating": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only keep reviews with at least this many stars.", "default": 1 }, "maxRating": { "title": "Maximum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only keep reviews with at most this many stars. Set to 2 to collect only complaints.", "default": 5 }, "reviewedAfter": { "title": "Reviews posted after", "type": "string", "description": "Only keep reviews posted on or after this date (YYYY-MM-DD). With 'Newest first' the run stops early once older reviews are reached." }, "generateThemesReport": { "title": "Generate review themes report", "type": "boolean", "description": "Build a report per app with the top complaint and praise themes, counts, share of reviews, example quotes, frequent phrases and rating by app version. Saved to the key-value store as THEMES. Charged once per app.", "default": true }, "useClaudeSummary": { "title": "Add AI summary with Claude (optional)", "type": "boolean", "description": "Also ask Claude to summarize themes, feature requests and suggested fixes. Requires your own Anthropic API key; typically costs a few cents per app on your Anthropic bill.", "default": false }, "anthropicApiKey": { "title": "Anthropic API key", "type": "string", "description": "Your Anthropic API key, used only for the AI summary. Stored encrypted." }, "claudeModel": { "title": "Claude model", "enum": [ "claude-haiku-4-5", "claude-sonnet-5-5" ], "type": "string", "description": "Haiku is cheapest; Sonnet gives richer summaries.", "default": "claude-haiku-4-5" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Usually not needed. Enable Apify Proxy if Google Play starts refusing requests.", "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 } } } } } } } } } }