{ "openapi": "3.0.1", "info": { "title": "App Reviews Scraper — Google Play + App Store, Only New", "description": "App reviews scraper for Google Play and the App Store in one run: paste app ids or store links and get one row per review in one shape — rating, title, text, date, version, helpful count, developer reply. Repeat runs deliver only the reviews you have not received. No login, no start fee.", "version": "1.0", "x-build-id": "8dl4Z8QlQybXjxHaw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadyfetch~app-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadyfetch-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/steadyfetch~app-reviews-scraper/runs": { "post": { "operationId": "runs-sync-steadyfetch-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/steadyfetch~app-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-steadyfetch-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": { "apps": { "title": "Apps (ids or store links)", "type": "array", "description": "One app per entry, from either store: a Google Play package id like org.telegram.messenger or its play.google.com/store/apps/details?id=… link, or an App Store app id like 686449807 or its apps.apple.com/…/id686449807 link. Each store is detected for you. An entry that is not an app is refused before anything is read, and nothing is charged for it.", "items": { "type": "string" } }, "maxReviews": { "title": "Max reviews per app", "minimum": 1, "maximum": 5000, "type": "integer", "description": "The most reviews to deliver per app on one run, newest first. The App Store shows at most 500 reviews per app per country, so an App Store app reads up to 500. On a repeat run with \"Only reviews I have not received\" on, this is the most NEW reviews per app.", "default": 100 }, "onlyNew": { "title": "Only reviews I have not received", "type": "boolean", "description": "On (the default): this actor remembers, in a store in YOUR Apify account, which reviews it already delivered to you for each app and country, so a scheduled run delivers and charges only the new ones. Off: every review the run reads is delivered again.", "default": true }, "since": { "title": "Only reviews from this date on", "type": "string", "description": "Optional. Deliver only reviews written on or after this day, written YYYY-MM-DD. App Store reviews carry the day only, not the time." }, "country": { "title": "Country", "type": "string", "description": "The store country to read reviews from, as a two-letter code (US, GB, DE …) or a name. App Store reviews belong to one country's store. Google Play sells in 211 countries, the App Store in 105; an app whose store does not cover the country gets its own row saying so.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "The review language, as a code (en, de, pt-BR …) or a name. Google Play returns reviews written in this language.", "default": "en" }, "sortBy": { "title": "Order", "type": "string", "description": "newest (the default) reads the most recent reviews first, which is what a schedule needs. helpful reads the store's most helpful (Google Play: most relevant) reviews first.", "default": "newest" }, "appInfo": { "title": "Add an app details row", "type": "boolean", "description": "Also return one row per app with its store details: name, developer, rating, number of ratings, version, last update, price, category and (Google Play) installs. Charged as one App details event per app.", "default": false }, "maxRunSeconds": { "title": "Max run seconds", "minimum": 30, "type": "integer", "description": "Optional. Stop collecting after this many seconds; reviews already read are still delivered." } } }, "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 } } } } } } } } } }