{ "openapi": "3.0.1", "info": { "title": "App Store ASO Keyword Rank Tracker & Search Scraper (iOS)", "description": "ASO keyword rank tracker for the Apple App Store: see where your iOS app ranks for any keyword and country (top 200) and scrape App Store search results with rating, price, genre and version. Official iTunes Search API, no login. $0.002 per rank check, $1.00 per 1,000 apps.", "version": "0.1", "x-build-id": "MYfWy7Oq9Vv7vSDqC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webatola~app-store-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webatola-app-store-search", "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/webatola~app-store-search/runs": { "post": { "operationId": "runs-sync-webatola-app-store-search", "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/webatola~app-store-search/run-sync": { "post": { "operationId": "run-sync-webatola-app-store-search", "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": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Search terms exactly as users type them in the App Store. Examples: \"photo editor\", \"habit tracker\", \"vpn\". Each keyword × country is one search (about 3 s each because of Apple's rate limit).", "default": [ "photo editor" ], "items": { "type": "string" } }, "countries": { "title": "Countries (App Store storefronts)", "type": "array", "description": "Two-letter App Store storefront codes. Examples: us, gb, de, fr, jp, cz.", "default": [ "us" ], "items": { "type": "string" } }, "device": { "title": "Device", "enum": [ "iphone", "ipad" ], "type": "string", "description": "Which App Store to search.", "default": "iphone" }, "maxResultsPerKeyword": { "title": "Max search results per keyword", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many top search results to save per keyword and country (1–200). Example: 10 for a quick competitor check, 200 for the full list. Keyword-rank checks always look at the full top 200.", "default": 50 }, "includeSearchResults": { "title": "Save search results", "type": "boolean", "description": "Save the ranked apps for each keyword. Turn off if you only need keyword-rank rows for your tracked apps (cheapest option for daily rank tracking).", "default": true }, "trackApps": { "title": "Apps to track (keyword rank)", "type": "array", "description": "Optional. Your app and competitors to rank-check for every keyword × country. Accepts App Store IDs (587366035), App Store URLs (https://apps.apple.com/us/app/.../id587366035) or bundle IDs (com.burbn.instagram). Each app × keyword × country is one keyword-rank check.", "default": [], "items": { "type": "string" } }, "includeDescription": { "title": "Include app description text", "type": "boolean", "description": "Include the full App Store description (long text). Turn off for compact output, e.g. for AI agents.", "default": true }, "includeScreenshots": { "title": "Include screenshot URLs", "type": "boolean", "description": "Include the list of screenshot image URLs. Turn off for compact output.", "default": true } } }, "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 } } } } } } } } } }