{ "openapi": "3.0.1", "info": { "title": "App Store Intelligence", "description": "Track any iOS App Store app's rating, price, version, release notes and chart rank over time, or search the Store by keyword. Uses only Apple's own public JSON endpoints (iTunes Lookup/Search API + Marketing Tools chart feed) — no login, no scraping.", "version": "0.1", "x-build-id": "dkxrnvyLiIEw2gvn7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hllerdgn80~app-store-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hllerdgn80-app-store-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/hllerdgn80~app-store-intelligence/runs": { "post": { "operationId": "runs-sync-hllerdgn80-app-store-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/hllerdgn80~app-store-intelligence/run-sync": { "post": { "operationId": "run-sync-hllerdgn80-app-store-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": { "apps": { "title": "Apps (ID, bundle ID or App Store link)", "type": "array", "description": "One per line: a numeric App Store ID (e.g. 284882215), a bundle ID (e.g. com.facebook.Facebook), or a full apps.apple.com link. Duplicates are removed.", "default": [ "284882215", "310633997", "com.spotify.client" ], "items": { "type": "string" } }, "appsText": { "title": "Or paste a list", "type": "string", "description": "Paste many apps at once: one per line (commas, semicolons and tabs also separate entries). Combined with the list above." }, "searchTerm": { "title": "Or: search by keyword instead", "type": "string", "description": "If set, the Actor ignores the app list above and instead searches the Store for this keyword (e.g. 'budget planner'), returning the matching apps as one row. Leave empty to look up the apps list instead." }, "searchLimit": { "title": "Keyword search: how many apps to return", "minimum": 1, "maximum": 200, "type": "integer", "description": "Only used with 'search by keyword'.", "default": 20 }, "country": { "title": "App Store country", "type": "string", "description": "Two-letter App Store storefront country code, e.g. us, gb, tr, de. Prices, availability and chart rank are per-country.", "default": "us" }, "trackChartRank": { "title": "Also check chart rank (free)", "type": "boolean", "description": "For each app found, also checks Apple's official public chart feed (Marketing Tools) and reports its rank if it appears there. Adds one extra request per app; does not add to the charged event.", "default": false }, "chart": { "title": "Which chart to check", "enum": [ "top-free", "top-paid", "top-grossing" ], "type": "string", "description": "Only used when 'Also check chart rank' is on.", "default": "top-free" }, "chartLimit": { "title": "Chart size to check", "minimum": 10, "maximum": 100, "type": "integer", "description": "How many top positions of the overall chart to search for the app. Apple's public feed becomes unreliable above 100, so this Actor caps it at 100.", "default": 100 }, "maxConcurrency": { "title": "Apps checked in parallel", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many apps to look up in parallel.", "default": 5 } } }, "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 } } } } } } } } } }