{ "openapi": "3.0.1", "info": { "title": "Play Store Rank Tracker: Google Play Keyword Rankings", "description": "Play Store rank tracker for ASO: track which apps rank for your Google Play keywords in any country, with position, rank change since last run, rating, installs, developer, price and category. Optional full app details.", "version": "1.0", "x-build-id": "tceIvbPQ9KRJwLsEu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kamerozkan~play-store-rank-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kamerozkan-play-store-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/kamerozkan~play-store-rank-tracker/runs": { "post": { "operationId": "runs-sync-kamerozkan-play-store-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/kamerozkan~play-store-rank-tracker/run-sync": { "post": { "operationId": "run-sync-kamerozkan-play-store-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": "Google Play search terms to track, exactly as a user types them in the Play Store, for example \"vpn\" or \"habit tracker\". Each keyword returns the apps ranked 1 to 30.", "default": [ "vpn" ], "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter Play Store country codes, for example \"us\", \"gb\", \"de\", \"in\", \"br\". Rankings differ per country, every keyword is checked in every country.", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Play Store interface language for titles and texts (hl parameter), for example \"en\", \"de\", \"es\", \"pt-BR\".", "default": "en" }, "maxRank": { "title": "Track positions 1 to", "minimum": 1, "maximum": 30, "type": "integer", "description": "How deep to track each keyword. Google Play web search shows up to 30 apps per keyword. You pay per ranked app, so 10 tracks the top 10 at a third of the cost.", "default": 30 }, "trackedAppIds": { "title": "Your apps and competitors (optional)", "type": "array", "description": "Package names to watch, for example \"com.nordvpn.android\". Rows get isTrackedApp, and the OUTPUT record lists each tracked app's rank per keyword (null when it is outside the tracked positions).", "items": { "type": "string" } }, "includeDetails": { "title": "Include full app details", "type": "boolean", "description": "Also open each ranked app's store page for ratings count, reviews count, rating histogram, exact installs, release and update dates, what's new, ads flag, developer website and full description. Slower, same price per app.", "default": false }, "trackChanges": { "title": "Track rank changes between runs", "type": "boolean", "description": "Remember each keyword's ranks and report previousRank, rankChange (positive = moved up), isNewEntrant and apps that dropped out. Run on a schedule for a daily rank history.", "default": true }, "onlyChanges": { "title": "Only output apps whose rank changed", "type": "boolean", "description": "After the first run, output (and charge) only new entrants and apps that moved. Dropped apps are always listed in the OUTPUT record for free.", "default": false }, "maxItems": { "title": "Max ranked apps per run", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many dataset rows. You are charged per row, so this also caps the cost of the run.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is used by default. Leave as is unless you know you need something else.", "default": { "useApifyProxy": 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 } } } } } } } } } }