{ "openapi": "3.0.1", "info": { "title": "App Store Price Scraper - Compare by Country", "description": "Scrape App Store app data across up to 60 countries in one run: local price converted to USD, rating, localized name, days since the last update, and the countries where an app is not distributed at all. Compare iOS app pricing market by market. No API key.", "version": "0.1", "x-build-id": "Rt16U9WhRoSfaubkK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataio~app-store-price-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataio-app-store-price-intelligence", "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/dataio~app-store-price-intelligence/runs": { "post": { "operationId": "runs-sync-dataio-app-store-price-intelligence", "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/dataio~app-store-price-intelligence/run-sync": { "post": { "operationId": "run-sync-dataio-app-store-price-intelligence", "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, as a user would type it in the App Store — habit tracker, budget, meditation. Returns up to about 195 apps, which is Apple's own ceiling." }, "appIds": { "title": "App IDs", "type": "array", "description": "Numeric App Store IDs, the digits after /id in an App Store URL. Use this to track a fixed set of competitors across markets.", "items": { "type": "string" } }, "developerIds": { "title": "Developer IDs", "type": "array", "description": "Numeric developer IDs. Returns that developer's entire catalogue — the fastest way to see everything a competitor ships.", "items": { "type": "string" } }, "countries": { "title": "Countries", "maxItems": 60, "type": "array", "description": "Two-letter country codes: us, gb, de, fr, jp, cn, in, br, kr, au… Every country adds one row per app. This is where the value is — the same app has a different price, a different rating and sometimes a different name in each market.", "items": { "type": "string" } }, "platform": { "title": "Platform", "enum": [ "iphone", "ipad", "mac" ], "type": "string", "description": "iPhone, iPad or Mac apps.", "default": "iphone" }, "pricing": { "title": "Pricing", "enum": [ "all", "free", "paid" ], "type": "string", "description": "Paid apps are where price comparison matters — measured spread on one paid app across 18 markets was 75%.", "default": "all" }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "0 to 5. Applied per market, so an app can pass in one country and fail in another — which is itself the finding." }, "minReviews": { "title": "Minimum number of ratings", "minimum": 0, "type": "integer", "description": "A rating with no volume behind it means nothing. 100 removes most of the noise from a keyword search." }, "updatedWithinDays": { "title": "Updated within (days)", "minimum": 0, "maximum": 7300, "type": "integer", "description": "Removes abandoned apps. Measured on a keyword search: 12% had not been updated in over a year, the worst in 2,343 days." }, "includeUnavailable": { "title": "Include markets where the app is not distributed", "type": "boolean", "description": "On by default, and deliberately: a missing row looks like a collection error. A row marked not available tells you a competitor chose not to enter that market.", "default": true }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 50000, "type": "integer", "description": "One row per app per country. 200 apps across 20 countries is 4,000 rows.", "default": 1000 } } }, "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 } } } } } } } } } }