{ "openapi": "3.0.1", "info": { "title": "Gripeline — App Store & Google Play Reviews Scraper", "description": "App Store and Google Play reviews scraper: both stores in one clean schema, plus a per-app summary agents can read (star mix, % negative, top complaints, worst app versions). Monitor mode returns only new reviews for daily alerts. $0.0001 per review, $0.003 per app summary.", "version": "0.1", "x-build-id": "r14nqFwM4jGTlK66S" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cybermax~app-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cybermax-app-reviews", "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/cybermax~app-reviews/runs": { "post": { "operationId": "runs-sync-cybermax-app-reviews", "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/cybermax~app-reviews/run-sync": { "post": { "operationId": "run-sync-cybermax-app-reviews", "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", "required": [ "apps" ], "properties": { "apps": { "title": "Apps", "type": "array", "description": "App names (\"Duolingo\" is looked up in both stores), App Store links (apps.apple.com/.../id570060128), Google Play links (play.google.com/store/apps/details?id=com.duolingo), Apple numeric ids or Play package names.", "items": { "type": "string" } }, "stores": { "title": "Stores", "enum": [ "both", "apple", "google" ], "type": "string", "description": "Which stores to read. Links and ids always point to their own store; app names are searched in the stores selected here.", "default": "both" }, "maxReviewsPerApp": { "title": "Max reviews per app (per store and country)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Newest reviews first. The App Store feed gives at most 500 per country; Google Play goes deeper. 0 = summary of store metadata only.", "default": 200 }, "includeReviews": { "title": "Return individual reviews", "type": "boolean", "description": "Off = only the per-app summary record (the summary is still computed from the reviews read).", "default": true }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter store countries (us, gb, de, in…). Each country is read separately; up to 10.", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Google Play language", "type": "string", "description": "Language of Google Play reviews (en, de, es, pt-BR…).", "default": "en" }, "minRating": { "title": "Minimum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only keep reviews with at least this many stars.", "default": 1 }, "maxRating": { "title": "Maximum stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only keep reviews with at most this many stars (e.g. 2 = complaints only).", "default": 5 }, "since": { "title": "Only reviews since", "type": "string", "description": "Only keep reviews on or after this date (YYYY-MM-DD)." }, "keyword": { "title": "Keyword filter", "type": "string", "description": "Only keep reviews whose title or text contains this word (case-insensitive), e.g. \"crash\" or \"subscription\"." }, "maxConcurrency": { "title": "Parallel apps", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many apps to read at the same time.", "default": 4 }, "monitor": { "title": "Monitor mode: only new reviews since the last run", "type": "boolean", "description": "For scheduled runs (e.g. daily new reviews to Slack or Google Sheets). Remembers which reviews were already returned for each app, store and country, and outputs (and charges) only reviews not seen before, marked change: \"new\". An app's summary record is returned only when it has new reviews, and then summarizes just those. The first monitor run returns everything, like a normal run. Set Max reviews per app to more than you expect per day between runs (e.g. 100).", "default": false }, "monitorKey": { "title": "Monitor name (optional)", "type": "string", "description": "Name for this watchlist's saved state, so several watchlists can be monitored separately (letters, digits, - _ . only). Empty = derived from the apps, stores, countries and language. State is kept in your named key-value store \"app-reviews-monitor\"." } } }, "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 } } } } } } } } } }