{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Reviews Scraper API | One Schema", "description": "Scrape Apple App Store and Google Play reviews in one run — both stores return the exact same fields, so there is nothing to merge. Any country and language, incremental with sinceDays for daily monitoring, and you pay only for the reviews actually returned.", "version": "0.0", "x-build-id": "9Kq0OfwagVSISoEiJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/timber_timber~app-review-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-timber_timber-app-review-monitor", "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/timber_timber~app-review-monitor/runs": { "post": { "operationId": "runs-sync-timber_timber-app-review-monitor", "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/timber_timber~app-review-monitor/run-sync": { "post": { "operationId": "run-sync-timber_timber-app-review-monitor", "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": "Apple App Store apps to fetch. Accepts numeric app IDs (e.g. 443904275) or full store URLs (e.g. https://apps.apple.com/jp/app/line/id443904275).", "items": { "type": "string" } }, "googlePlayApps": { "title": "Google Play apps", "type": "array", "description": "Google Play apps to fetch. Accepts package names (e.g. jp.naver.line.android) or full store URLs (e.g. https://play.google.com/store/apps/details?id=jp.naver.line.android).", "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code of the store front (jp, us, gb, de, ...). Applies to both stores.", "default": "us" }, "language": { "title": "Language (Google Play only)", "type": "string", "description": "Two-letter language code for Google Play reviews (ja, en, de, ...). App Store reviews follow the country automatically.", "default": "en" }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper limit of reviews fetched per app per store. App Store RSS serves at most ~500 recent reviews (10 pages x 50).", "default": 100 }, "sinceDays": { "title": "Only reviews from the last N days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Optional. Keep only reviews newer than N days ago — e.g. 1 for a daily scheduled run, 7 for weekly. Recommended for monitoring: the window moves with each run, so you only pay for recent reviews. Takes priority over sinceDate." }, "sinceDate": { "title": "Only reviews after (ISO date)", "type": "string", "description": "Optional. Keep only reviews newer than a fixed date, e.g. 2026-08-15. For scheduled monitoring prefer sinceDays: a fixed date makes each later run fetch (and charge for) a growing range." } } }, "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 } } }, "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 } } } } } } } } } }