{ "openapi": "3.0.1", "info": { "title": "ASO Keyword Rank Tracker (App Store & Google Play)", "description": "Track where your app ranks for any keyword in the Apple App Store and on Google Play - position, the competitors above you, their ratings and prices, in any storefront.", "version": "0.1", "x-build-id": "gHnHSEefwgr0ane1V" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~aso-keyword-rank-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-aso-keyword-rank-tracker", "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/superslowsloth~aso-keyword-rank-tracker/runs": { "post": { "operationId": "runs-sync-superslowsloth-aso-keyword-rank-tracker", "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/superslowsloth~aso-keyword-rank-tracker/run-sync": { "post": { "operationId": "run-sync-superslowsloth-aso-keyword-rank-tracker", "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": "The search terms to check your app's position for, one per line, e.g. \"habit tracker\", \"daily planner\". Each keyword is checked once per store you supply an app id for, and each check is one charge. Duplicate spellings that differ only in spacing or case are collapsed before anything is fetched, so you are never charged twice for the same search.", "items": { "type": "string" } }, "iosAppId": { "title": "App Store app", "type": "string", "description": "The app to track in Apple's App Store. Accepts the numeric id (1438388363), the bundle id (com.davetech.habit), or the full store URL you copied from your listing. Leave empty to skip the App Store entirely - nothing is fetched or charged for a store with no app id." }, "androidAppId": { "title": "Google Play app", "type": "string", "description": "The app to track on Google Play. Accepts the package name (com.davetech.habit) or the full store URL. Leave empty to skip Google Play entirely - nothing is fetched or charged for a store with no app id." }, "country": { "title": "Storefront", "type": "string", "description": "Two-letter country code for the storefront to search, e.g. \"us\", \"gb\", \"jp\". Rankings differ by storefront, so this is part of the measurement and not a display preference.", "default": "us" }, "language": { "title": "Language (Google Play only)", "type": "string", "description": "Language code Google Play should search in, e.g. \"en\", \"ja\", \"pt-BR\". Ignored for the App Store, where the storefront decides the language and there is no separate setting - App Store rows carry a null language for exactly that reason.", "default": "en" }, "depth": { "title": "How deep to look (App Store)", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many App Store results to scan before concluding your app does not rank. Apple's own limit is 200 and anything higher is clamped to it. A rank outside this number is reported as null, never as a large placeholder, so it cannot be averaged into a trend line as though it were a position. Google Play returns a fixed page of about 30 results and ignores this setting.", "default": 200 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Apple's Search API is an official unauthenticated endpoint and answered a plain datacenter address with no proxy at all on 2026-09-12. Google Play does rate-limit an address that searches quickly, and answers with its unusual-traffic page; a proxy is what gives the run a fresh address to retry on when that happens." } } }, "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 } } } } } } } } } }