{ "openapi": "3.0.1", "info": { "title": "App Store Rank Tracker — Track Rankings, Prices & Competitors", "description": "Track App Store rankings, prices and rank movements across countries. Get structured data for ASO research, competitor monitoring, app market analysis and product intelligence.", "version": "0.0", "x-build-id": "Qcg6OuMqghGfdUl19" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/quaffable_mettle~app-store-rank-tracker-track-rankings-prices-competitors/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-quaffable_mettle-app-store-rank-tracker-track-rankings-prices-competitors", "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/quaffable_mettle~app-store-rank-tracker-track-rankings-prices-competitors/runs": { "post": { "operationId": "runs-sync-quaffable_mettle-app-store-rank-tracker-track-rankings-prices-competitors", "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/quaffable_mettle~app-store-rank-tracker-track-rankings-prices-competitors/run-sync": { "post": { "operationId": "run-sync-quaffable_mettle-app-store-rank-tracker-track-rankings-prices-competitors", "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": [ "storefronts" ], "properties": { "storefronts": { "title": "Storefronts (country codes)", "uniqueItems": true, "type": "array", "description": "Two-letter country codes. Each chart is fetched independently, so a failing storefront never breaks the run. Verified on both charts: AR AT AU BE BR CA CH CL CO DE DK ES FI FR GB IE IN IT JP KR MX NL NO NZ PL PT RU SE SG TR US ZA.", "default": [ "US" ], "items": { "type": "string" } }, "charts": { "title": "Charts", "uniqueItems": true, "type": "array", "description": "Which rankings to fetch. Apple publishes exactly two under this feed — there is no top-grossing chart. Each storefront-and-chart pair is billed once.", "items": { "type": "string", "enum": [ "top-free", "top-paid" ], "enumTitles": [ "Top Free Apps", "Top Paid Apps" ] }, "default": [ "top-free" ] }, "chartSize": { "title": "Chart size", "minimum": 10, "maximum": 100, "type": "integer", "description": "How many apps to take from each chart, from the top down. Apple's hard ceiling is 100 — asking for more returns a server error, so higher values are clamped.", "default": 100 }, "includeDetails": { "title": "Include app details", "type": "boolean", "description": "Add genre, local price and currency, star rating and rating count, current version, days since the last update, developer, age rating, size and minimum iOS version. Looked up per storefront, so prices and ratings are the local ones — not the American ones.", "default": true }, "genre": { "title": "Genre filter", "type": "string", "description": "Keep only apps whose genre contains this text, for example \"Games\", \"Finance\", \"Social Networking\". Requires app details: Apple's chart feed ships an empty genre field, so the genre can only come from the lookup." }, "timeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for each request before retrying. Raise it only if you see timeout warnings in the log.", "default": 30 } } }, "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 } } } } } } } } } }