{ "openapi": "3.0.1", "info": { "title": "App Store Scraper - $0.09 per 1,000, No Key", "description": "Scrape Apple App Store apps and reviews. Get name, developer, rating, review count, price, genre, version and dates. Apple's public review feed stops at page 10. So you get 500 reviews per app at most. No API key needed. $0.09 per 1,000 apps.", "version": "0.1", "x-build-id": "vi5FJMpcPYGS8p9LB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~app-store-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~app-store-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-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": { "searchTerm": { "title": "Search term", "type": "string", "description": "Keyword to search the App Store for (e.g. \"notion\", \"habit tracker\"). Returns matching apps with full metadata. Leave empty if you are looking up specific apps by ID instead." }, "appIds": { "title": "App IDs (trackId or bundleId)", "type": "array", "description": "Look up specific apps by numeric trackId (e.g. \"1232780281\") or bundleId (e.g. \"net.shinyfrog.bear\"). Each app is returned with full metadata; enable \"Include reviews\" to also fetch its customer reviews. Used instead of Search term. Note: individual metadata fields (e.g. averageUserRating, releaseNotes, sellerUrl, price) can be null when Apple does not provide them for an app.", "default": [], "items": { "type": "string" } }, "reviewsSort": { "title": "Reviews sort order", "enum": [ "mostrecent", "mosthelpful" ], "type": "string", "description": "Order in which to fetch reviews: most recent first, or most helpful first.", "default": "mostrecent" }, "country": { "title": "Country / storefront", "type": "string", "description": "Two-letter App Store storefront code, e.g. us, gb, ca, de, fr, jp, in. Affects which apps, prices, and reviews are returned. Use a valid ISO storefront code: an invalid code (e.g. \"us-uk\") is rejected by Apple's API and the actor returns a diagnostic row with no results instead of charging.", "default": "us" }, "maxReviews": { "title": "Max reviews per app", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of customer reviews to fetch per app when \"Include reviews\" is on. Apple's feed serves roughly 50 reviews per page across up to 10 pages (~500 max).", "default": 100 }, "maxItems": { "title": "Max apps (search mode)", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of apps to return when using Search term. Apple's search caps at 200 results per query.", "default": 50 }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "When looking up apps by ID, also fetch each app's customer reviews (author, rating, title, body, version, date) from Apple's public reviews feed. Ignored in Search mode.", "default": false }, "notionConnector": { "title": "Notion connector (optional)", "type": "string", "description": "Optional. Write each app as a page into your Notion when the run finishes. Authorize a Notion connector once in Settings → API & Integrations → MCP connectors, then pick it here. Leave empty to skip (default) — results are always saved to the dataset regardless." }, "notionParentId": { "title": "Notion target data source ID", "type": "string", "description": "Optional. The Notion data source ID of the database to write into (only used if a Notion connector is set). Leave empty to create the pages privately in your workspace instead." }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "OPTIONAL. The iTunes / App Store APIs are public and unauthenticated, so no proxy is needed and none is used by default. Only enable a proxy if you hit per-IP rate limits at high volume; routing this public API through Apify Proxy otherwise just consumes proxy credits with no benefit.", "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 } } } } } } } } } }