{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Scraper: Apps, Ratings, Charts", "description": "Public app data from the Apple App Store and Google Play in one clean schema: title, developer company, price, ratings and histogram, installs, version, release notes, Google Play reviews and Apple top charts. For app-market research and competitor tracking.", "version": "0.1", "x-build-id": "BHXO1naijZArfZiEL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/folt~app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-folt-app-store-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/folt~app-store-scraper/runs": { "post": { "operationId": "runs-sync-folt-app-store-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/folt~app-store-scraper/run-sync": { "post": { "operationId": "run-sync-folt-app-store-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", "type": "array", "description": "App Store ids or URLs (6448311069, https://apps.apple.com/us/app/chatgpt/id6448311069) and Google Play package names or URLs (com.spotify.music, https://play.google.com/store/apps/details?id=com.spotify.music). Up to 1,000 per run.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Storefronts as 2-letter ISO codes (us, gb, de, bg…). Prices, currency, ratings, availability and charts are per country. Up to 50.", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Language (Google Play)", "type": "string", "description": "Language of Google Play texts, e.g. en, de, pt-BR. App Store texts come in the storefront's own language.", "default": "en" }, "appleCharts": { "title": "Apple top charts", "type": "array", "description": "App Store top charts to include for every country (iPhone apps, from Apple's public marketing feeds).", "items": { "type": "string", "enum": [ "top-free", "top-paid" ], "enumTitles": [ "Top free apps", "Top paid apps" ] } }, "chartSize": { "title": "Chart size", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many ranks per chart (1–100).", "default": 25 }, "chartAppDetails": { "title": "Full app records for chart apps", "type": "boolean", "description": "Also returns an app record (price, rating, version, developer…) for every app in the charts. Each one is charged as an app.", "default": false }, "includeReviews": { "title": "Include reviews (Google Play)", "type": "boolean", "description": "Adds the reviews Google shows on each app's public page (up to 20 per app and country, Google's \"most relevant\" selection). Reviewer names and avatars are never included. App Store reviews are not available — see the README.", "default": false }, "maxReviewsPerApp": { "title": "Max reviews per app", "minimum": 1, "maximum": 20, "type": "integer", "description": "Per app and country (1–20).", "default": 20 }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stops after this many charged results (apps + reviews + chart entries). Leave empty for no limit." } } }, "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 } } } } } } } } } }