{ "openapi": "3.0.1", "info": { "title": "apple App Store Scraper", "description": "Scrapes apps from the Apple App Store using keyword search, filtering by country, ratings, review count, and price type. Extracts details like developer info, ratings, categories, descriptions, screenshots, pricing, and compatibility, supporting multiple regions and localized data.", "version": "0.0", "x-build-id": "7sHkjAxRNEGuJcVal" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/moving_beacon-owner1~apple-app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-moving_beacon-owner1-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/moving_beacon-owner1~apple-app-store-scraper/runs": { "post": { "operationId": "runs-sync-moving_beacon-owner1-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/moving_beacon-owner1~apple-app-store-scraper/run-sync": { "post": { "operationId": "run-sync-moving_beacon-owner1-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": [ "query" ], "properties": { "query": { "title": "Search query", "type": "string", "description": "Keyword to search the Apple App Store (e.g. 'meditation', 'photo editor', 'spotify')." }, "country": { "title": "Country storefront", "enum": [ "us", "gb", "ca", "au", "de", "fr", "es", "it", "nl", "jp", "kr", "cn", "tw", "hk", "sg", "in", "br", "mx", "ar", "cl", "ae", "sa", "tr", "il", "ru", "pl", "se", "no", "dk", "fi", "ch", "at", "be", "ie", "pt", "gr", "cz" ], "type": "string", "description": "Two-letter ISO country code for the App Store storefront. Each storefront has its own catalog, pricing, and rankings.", "default": "us" }, "entity": { "title": "Entity type", "enum": [ "software", "iPadSoftware", "macSoftware" ], "type": "string", "description": "What kind of result to fetch. 'software' = iPhone apps, 'iPadSoftware' = iPad apps, 'macSoftware' = Mac apps.", "default": "software" }, "language": { "title": "Language", "type": "string", "description": "Result language. 'en_us' or 'ja_jp'. Defaults to the storefront's primary language if blank.", "default": "en_us" }, "minRating": { "title": "Minimum average rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Drop apps with average rating below this (0.0–5.0). Apps with zero ratings are kept by default — see 'requireRatings'." }, "minRatingCount": { "title": "Minimum rating count", "minimum": 0, "type": "integer", "description": "Drop apps with fewer than this many ratings. Use to filter out brand-new apps with one inflated rating." }, "requireRatings": { "title": "Require ratings", "type": "boolean", "description": "If true, drop apps that have no ratings at all.", "default": false }, "priceFilter": { "title": "Price filter", "enum": [ "any", "free", "paid" ], "type": "string", "description": "Free / Paid / Any.", "default": "any" }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "rating_desc", "rating_asc", "rating_count_desc", "price_asc", "price_desc", "newest" ], "type": "string", "description": "How to order results (applied after filtering).", "default": "relevance" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 200, "type": "integer", "description": "Cap on stored apps. iTunes Search returns up to 200 per request; this is the post-filter cap.", "default": 50 } } }, "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 } } } } } } } } } }