{ "openapi": "3.0.1", "info": { "title": "App Rankings Scraper", "description": "Extract Apple App Store top charts by country and category: top free, top paid, top grossing or newest apps with their rank, name, developer, category and price, for any storefront. Export data, run via API, schedule and monitor runs, or integrate with other tools.", "version": "0.0", "x-build-id": "mtxG8Rartw1PedUbN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/publicmoney~app-rankings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-publicmoney-app-rankings-scraper", "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/publicmoney~app-rankings-scraper/runs": { "post": { "operationId": "runs-sync-publicmoney-app-rankings-scraper", "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/publicmoney~app-rankings-scraper/run-sync": { "post": { "operationId": "run-sync-publicmoney-app-rankings-scraper", "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": [ "countries" ], "properties": { "countries": { "title": "🌍 Countries", "maxItems": 100, "type": "array", "description": "Two-letter App Store country codes, one per line. Each country is a separate storefront with its own chart, so the same app can rank differently in each. Every country you add multiplies the records returned by the limit. Examples: 'us', 'gb', 'de', 'jp'. Default is 'us'.", "default": [ "us" ], "items": { "type": "string" } }, "chart": { "title": "📊 Chart", "enum": [ "topfreeapplications", "toppaidapplications", "topgrossingapplications", "newapplications" ], "type": "string", "description": "Which of Apple's four top charts to read. Top grossing ranks by money spent and is the closest thing to a revenue signal; top free ranks by installs and measures reach; top paid ranks paid downloads; newest surfaces recent launches. Examples: 'topgrossingapplications', 'topfreeapplications', 'newapplications'. Default is 'topfreeapplications'.", "default": "topfreeapplications" }, "genreId": { "title": "🏷️ Category ID", "type": "string", "description": "Apple's numeric genre id, used to read one category's chart instead of the overall list. Leave it empty for the overall chart across all categories. Examples: '6015' Finance, '6000' Business, '6002' Utilities." }, "limit": { "title": "🔢 Chart size", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many ranked apps to return per country, counted from rank 1. Apple serves at most 200, and small storefronts or narrow genres return fewer than you ask for. Examples: 10, 50, 200. Default is 50.", "default": 50 }, "maxItems": { "title": "🔢 Max items", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of countries to read, counted from the top of the list. Use it to cap spend on a long list without editing the list itself. Examples: 10, 50, 200. Default is 0, which reads every country given.", "default": 0 } } }, "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 } } } } } } } } } }