{ "openapi": "3.0.1", "info": { "title": "App Reviews API – Google Play & App Store Reviews + AI Insights", "description": "Get app reviews from Google Play and the Apple App Store from app links or IDs. Returns rating, title, text, date, app version, votes and developer reply (Play), by country and language; optional English AI report of complaints and praise. $0.10 per 1,000 reviews; failures are free. · by TubeText", "version": "1.0", "x-build-id": "QXm3nEPUqyhjUPkdR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tubetext~google-play-reviews-ai/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tubetext-google-play-reviews-ai", "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/tubetext~google-play-reviews-ai/runs": { "post": { "operationId": "runs-sync-tubetext-google-play-reviews-ai", "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/tubetext~google-play-reviews-ai/run-sync": { "post": { "operationId": "run-sync-tubetext-google-play-reviews-ai", "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": "Google Play app IDs (com.spotify.music) or links (play.google.com/store/apps/details?id=…), and App Store links (apps.apple.com/us/app/…/id123456789) or 'id123456789'. Mix both stores in one run.", "items": { "type": "string" } }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 0, "maximum": 10000, "type": "integer", "description": "0 = no review rows (e.g. only app details and AI insights). App Store: at most 500 per sort order and country (Apple's public feed depth).", "default": 200 }, "sort": { "title": "Sort reviews by", "enum": [ "newest", "most_relevant", "rating" ], "type": "string", "description": "Google Play's review order.", "default": "newest" }, "startDate": { "title": "Only reviews since", "type": "string", "description": "Skip reviews older than this date (YYYY-MM-DD). With 'Newest' sort, paging stops at the first older page, so scheduled runs stay fast and cheap." }, "onlyNew": { "title": "Only new reviews (scheduled runs)", "type": "boolean", "description": "Deliver only reviews posted since your previous run of this Actor (with 'Newest' sort the run stops at the first review it delivered before; review IDs are remembered per app in a named key-value store in your account). Apps with nothing new get a free 'no_new_reviews' row.", "default": false }, "starRatings": { "title": "Only these star ratings", "type": "array", "description": "Empty = all ratings. Pick 1 and 2 for complaint research.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] }, "default": [] }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code (us, gb, de, in, br…). Google Play and the App Store show reviews per country; an App Store link's own country wins.", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code of the reviews (en, de, es, pt, ja…). Google Play only.", "default": "en" }, "includeAppDetails": { "title": "App summary row", "type": "boolean", "description": "One row per app with title, developer, average rating, ratings count, installs and category.", "default": true }, "aiInsights": { "title": "AI insights report", "type": "boolean", "description": "One English report per app from up to 300 recent reviews: sentiment split, top complaints and praise with example quotes and approximate share, feature requests, bugs and version-specific issues. $0.05 per app, charged only when delivered.", "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 } } } } } } } } } }