{ "openapi": "3.0.1", "info": { "title": "Apple App Store Scraper", "description": "Scrape public Apple App Store app data and reviews. Search apps by keyword, look up app IDs or URLs, collect top charts, and export ratings, prices, developers, genres, versions, and review text.", "version": "0.0", "x-build-id": "PbFiUvQJlqguNRj6I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~apple-app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-apple-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/maximedupre~apple-app-store-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-apple-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/maximedupre~apple-app-store-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-apple-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", "required": [ "mode", "maxAppsPerTarget", "reviewLimit", "includeReviews", "reviewSort", "country", "chartCollection" ], "properties": { "mode": { "title": "Scrape mode", "enum": [ "lookup", "search", "reviews", "topCharts" ], "type": "string", "description": "Choose the Apple App Store source to scrape: app details, app search, public reviews, or top charts.", "default": "lookup" }, "targets": { "title": "App Store targets", "maxItems": 100, "type": "array", "description": "Add one target per line. Use App Store URLs or numeric app IDs for app details and reviews, or keyword phrases for search mode. Top charts mode ignores this field.", "items": { "type": "string", "minLength": 1 } }, "maxAppsPerTarget": { "title": "App limit", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum app rows to save for each lookup target, search keyword, or top chart run.", "default": 25 }, "reviewLimit": { "title": "Review limit", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum public review rows to save for each app. Apple's RSS feed usually returns up to 500 reviews per storefront.", "default": 50 }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Also save public App Store review rows for apps found in app details, search, or top charts mode.", "default": false }, "reviewSort": { "title": "Review order", "enum": [ "mostRecent", "mostHelpful" ], "type": "string", "description": "Choose how Apple should order public RSS reviews.", "default": "mostRecent" }, "country": { "title": "Country", "enum": [ "us", "ca", "gb", "au", "de", "fr", "es", "it", "nl", "br", "mx", "jp", "in", "pt" ], "type": "string", "description": "Two-letter Apple App Store storefront code. App listings, prices, availability, and reviews can vary by country.", "default": "us" }, "chartCollection": { "title": "Chart feed", "enum": [ "top-free", "top-paid", "top-grossing", "new-apps", "new-free", "new-paid" ], "type": "string", "description": "Apple top chart feed to scrape in top charts mode.", "default": "top-free" }, "categoryIds": { "title": "Category IDs", "type": "array", "description": "Optional App Store genre IDs. Search mode sends the first genre ID to Apple Search. Top charts mode filters fetched app details after lookup.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }