{ "openapi": "3.0.1", "info": { "title": "App Store & Google Play Metadata & ASO Scraper", "description": "Scrape app metadata from Apple App Store and Google Play in one unified schema. Get title, ratings, screenshots, version history, pricing, and more. Monitor mode alerts you when competitors update their apps. No API key needed.", "version": "0.0", "x-build-id": "isfk8kxP4h6eZ6709" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dsh-org~app-metadata-aso-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dsh-org-app-metadata-aso-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/dsh-org~app-metadata-aso-scraper/runs": { "post": { "operationId": "runs-sync-dsh-org-app-metadata-aso-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/dsh-org~app-metadata-aso-scraper/run-sync": { "post": { "operationId": "run-sync-dsh-org-app-metadata-aso-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", "required": [ "apps" ], "properties": { "apps": { "title": "Apps", "type": "array", "description": "Apps to fetch metadata for. Each item can be: a full App Store or Google Play URL, an Apple numeric ID (\"310633997\"), an Apple bundle ID (\"com.google.Maps\"), a Google package name (\"com.whatsapp\"), a keyword search term, OR a structured object { store, appId, country }. store is \"apple\", \"google\", or \"auto\" (default, detected from the ID format)." }, "mode": { "title": "Mode", "enum": [ "snapshot", "monitor" ], "type": "string", "description": "snapshot = fetch current metadata (no state). monitor = on the first run store a baseline, then on later runs detect and flag metadata changes (new version, price change, rating shift). Ideal for scheduled ASO/competitor tracking.", "default": "snapshot" }, "includeScreenshots": { "title": "Include screenshots", "type": "boolean", "description": "Include screenshot URLs in the output. Turn off to reduce output size for large bulk runs.", "default": true }, "includeDescription": { "title": "Include full description", "type": "boolean", "description": "Include the full app description text. Turn off for compact output.", "default": true }, "includeVersionHistory": { "title": "Include version history (Apple only)", "type": "boolean", "description": "For Apple apps, include the current version's release notes as a versionHistory entry. Google Play does not expose version history. Note: Apple's public API exposes only the current version's notes.", "default": false }, "maxApps": { "title": "Max apps", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Safety cap on the total number of apps scraped in one run (caps PPE charges on large input lists and keyword searches).", "default": 100 }, "language": { "title": "Language", "type": "string", "description": "ISO 2-letter language code for Google Play metadata (e.g. en, es, de). Apple metadata is returned per-country.", "default": "en" } } }, "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 } } } } } } } } } }