{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Data Scraper", "description": "Search or look up Apple App Store and Google Play apps. Returns normalized prices, aggregate ratings, installs, versions, update dates, descriptions, screenshots, and official store URLs for ASO, competitor monitoring, and app-market research.", "version": "1.0", "x-build-id": "anDpHd0xhQwjmoFYZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fascinating_lentil~app-store-google-play-data-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fascinating_lentil-app-store-google-play-data-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/fascinating_lentil~app-store-google-play-data-scraper/runs": { "post": { "operationId": "runs-sync-fascinating_lentil-app-store-google-play-data-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/fascinating_lentil~app-store-google-play-data-scraper/run-sync": { "post": { "operationId": "run-sync-fascinating_lentil-app-store-google-play-data-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": { "sources": { "title": "Sources", "minItems": 1, "maxItems": 2, "uniqueItems": true, "type": "array", "description": "App marketplaces to query. Each selected source must have either a search query or its matching direct identifier.", "items": { "type": "string", "enum": [ "app_store", "google_play" ], "enumTitles": [ "Apple App Store", "Google Play Store" ] }, "default": [ "app_store", "google_play" ] }, "searchQueries": { "title": "Search queries", "maxItems": 20, "type": "array", "description": "Up to 20 app-market keywords. If all target fields are omitted, the Actor uses the sample query whatsapp. Explicitly empty target fields are rejected.", "items": { "type": "string", "minLength": 1, "maxLength": 100 }, "default": [ "whatsapp" ] }, "appIds": { "title": "Apple App Store app IDs", "maxItems": 200, "type": "array", "description": "Up to 200 Apple numeric IDs, bundle IDs, or HTTPS apps.apple.com app URLs. Example: 310633997.", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "packageNames": { "title": "Google Play package names", "maxItems": 200, "type": "array", "description": "Up to 200 package names or HTTPS play.google.com app-details URLs. Example: com.whatsapp.", "items": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "country": { "title": "Country", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter store country code, such as us, in, or gb.", "default": "us" }, "language": { "title": "Language", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter language code. Google Play receives this value directly; Apple supports en and ja response languages and otherwise uses English.", "default": "en" }, "includeRatingsSummary": { "title": "Include ratings summary", "type": "boolean", "description": "Include aggregate ratings counts and histogram when available. Individual reviews are never collected.", "default": true }, "maxResults": { "title": "Maximum app records", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum unique app records saved across all selected sources. Unused capacity is reallocated to the remaining source.", "default": 10 }, "userAgent": { "title": "User-Agent", "minLength": 1, "maxLength": 255, "type": "string", "description": "Descriptive User-Agent for public store requests. Line breaks and control characters are rejected.", "default": "AppStoreGooglePlayDataScraper/1.0 app-market-research" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional for Google Play only. When requested, a proxy setup failure stops the run instead of silently using a direct connection.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }