{
"openapi": "3.0.1",
"info": {
"title": "App Store Reviews Scraper & Google Play Reviews Monitor",
"description": "App Store and Google Play review scraper and monitor in one Actor: export to CSV, JSON or Excel, or schedule to get only new and low-star reviews. Rating and installs tracking. From $0.25 per 1,000 reviews.",
"version": "0.1",
"x-build-id": "iJQUtnQEGQIoQ3v5e"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/insanedev~app-store-google-play-reviews/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-insanedev-app-store-google-play-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/insanedev~app-store-google-play-reviews/runs": {
"post": {
"operationId": "runs-sync-insanedev-app-store-google-play-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/insanedev~app-store-google-play-reviews/run-sync": {
"post": {
"operationId": "run-sync-insanedev-app-store-google-play-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 Store or Google Play links, App Store ids (389801252, id389801252) or Google Play package names (com.instagram.android), one per line. The store is detected automatically. Up to 100 apps per run.",
"items": {
"type": "string"
}
},
"mode": {
"title": "Mode",
"enum": [
"export",
"monitor"
],
"type": "string",
"description": "Export: the newest reviews of every app (up to the limit below).
Monitor: for scheduled runs. The first run saves a baseline and returns the newest reviews; every later run returns only reviews that are new since the last run, app rows with rating, rating-count and install changes, and one digest row you can forward to Slack or e-mail.",
"default": "export"
},
"countries": {
"title": "Countries",
"type": "array",
"description": "Two-letter country codes (us, gb, de). App Store: reviews and app data per country. Google Play: app data per country (rating, star histogram, price); Google Play reviews depend on the language, not the country.",
"default": [
"us"
],
"items": {
"type": "string"
}
},
"allAppleCountries": {
"title": "App Store reviews from every country",
"type": "boolean",
"description": "Read App Store reviews from all 175 storefronts (countries without reviews are skipped quietly). App rows are still made only for the countries above. About 90 seconds per app.",
"default": false
},
"languages": {
"title": "Google Play review languages",
"type": "array",
"description": "Language codes for Google Play reviews (en, de, pt-BR). Each language is a separate set of reviews.",
"default": [
"en"
],
"items": {
"type": "string"
}
},
"maxReviewsPerApp": {
"title": "Max reviews per app",
"minimum": 0,
"maximum": 100000,
"type": "integer",
"description": "Per app and country on the App Store (at most 500: the App Store only shows the newest 500) and per app and language on Google Play (up to 100,000). In monitor mode: the most new reviews per run. 0 = app data only.",
"default": 100
},
"reviewsSince": {
"title": "Only reviews since",
"type": "string",
"description": "Only reviews from this date on: a date (2026-10-01) or a period (7 days, 2 weeks). Google Play dates are the time of the last edit."
},
"ratings": {
"title": "Star ratings",
"type": "array",
"description": "Only reviews with these star ratings, e.g. 1 and 2 for complaints. Empty = all.",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5"
],
"enumTitles": [
"1 star",
"2 stars",
"3 stars",
"4 stars",
"5 stars"
]
}
},
"includeAppDetails": {
"title": "App rows (rating, star histogram, installs)",
"type": "boolean",
"description": "One row per app and country: rating, rating count, star histogram, exact Google Play installs, version, last update and release notes. In monitor mode also the changes since the last run (rating, ratings per day, installs per day).",
"default": true
},
"monitorName": {
"title": "Monitor name",
"type": "string",
"description": "Monitor mode only. Runs with the same name share their memory of reviews already delivered. Leave empty to use the saved task (each task monitors on its own) or, without a task, the list of apps."
},
"strictStatus": {
"title": "Fail the run on errors",
"type": "boolean",
"description": "Mark the run as failed when an app could not be read (not found, not available, rate limited or a store error), so Apify can alert you. Apps without reviews do not count.",
"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
}
}
}
}
}
}
}
}
}
}