{ "openapi": "3.0.1", "info": { "title": "App Store Scraper 🔥 $0.40/1K | iPhone/Mac apps and reviews", "description": "From $0.40/1K 💰 Paste an App Store link and get the iPhone app, the Mac app, or the reviews. Price, privacy labels, languages, and chart position stay on the full listing. Duplicates are skipped. Export JSON, CSV, Excel, or API. Start now! 🚀", "version": "0.0", "x-build-id": "y6Jh5Vkks6EBOv5g5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/azzouzana~apple-app-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-azzouzana-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/azzouzana~apple-app-store-scraper/runs": { "post": { "operationId": "runs-sync-azzouzana-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/azzouzana~apple-app-store-scraper/run-sync": { "post": { "operationId": "run-sync-azzouzana-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": [ "startUrl" ], "properties": { "startUrl": { "title": "App Store link", "type": "string", "description": "An iPhone or Mac app, a search, a developer, or a chart. An app id such as 324684580 works. A bundle id such as com.spotify.client works. A few words, such as spotify, run a search.", "default": "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580" }, "device": { "title": "Device", "enum": [ "link", "iphone", "mac", "both" ], "type": "string", "description": "Same as the link follows a Mac link, or a link with mt=12. A name, a number, or an iPhone link stays on iPhone. iPhone and Mac saves both listings when Apple has them.", "default": "link" }, "country": { "title": "Country", "enum": [ "link", "us", "gb", "de", "fr", "es", "it", "nl", "br", "in", "jp", "kr", "ca", "au", "mx", "pl", "se", "at", "be", "ch", "ae" ], "type": "string", "description": "From the link uses the country in the URL, or United States when there is none. Any other choice overrides the link. This changes price, chart position, and which reviews you see.", "default": "link" }, "maxItems": { "title": "How many results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "On an app link, how many reviews to save. The app itself is one extra row. On a search, developer, or chart, how many apps to save. A chart returns at most 200 apps.", "default": 20 }, "reviews": { "title": "Reviews", "enum": [ "app", "always", "never" ], "type": "string", "description": "An app link includes reviews. A search, developer, or chart stays as apps until you choose On every app in a list.", "default": "app" }, "reviewSort": { "title": "Review order", "enum": [ "newest", "helpful" ], "type": "string", "description": "Newest and Most helpful walk the reviews Apple publishes for that storefront.", "default": "newest" }, "reviewsPerApp": { "title": "Reviews per app in a list", "minimum": 1, "maximum": 500, "type": "integer", "description": "Used only when Reviews is On every app in a list. A single app link uses How many results instead.", "default": 20 }, "fetchFullDetails": { "title": "Full app details", "type": "boolean", "description": "On a search, developer, or chart, also open each app page for the star histogram, privacy labels, chart position, and compatibility. An app link always includes that page.", "default": false }, "includeSimilar": { "title": "Similar apps", "type": "boolean", "description": "On an app link, also save You Might Also Like. They follow Full app details. They do not include reviews.", "default": 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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }