{ "openapi": "3.0.1", "info": { "title": "App Store Top Charts Scraper - Rankings by Country", "description": "Ranked Apple App Store charts for any country and any category: top free, top paid, top grossing and new releases, each position enriched with star ratings and rating counts. Track your own rank daily or find which apps in a category actually make money. Official Apple endpoints.", "version": "1.0", "x-build-id": "6mobapidba97ct7O6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/appdata-labs~app-store-top-charts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-appdata-labs-app-store-top-charts", "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/appdata-labs~app-store-top-charts/runs": { "post": { "operationId": "runs-sync-appdata-labs-app-store-top-charts", "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/appdata-labs~app-store-top-charts/run-sync": { "post": { "operationId": "run-sync-appdata-labs-app-store-top-charts", "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", "properties": { "countries": { "title": "App Store countries", "type": "array", "description": "Two-letter country codes of the App Store storefronts to read. Charts are ranked per country, so add more countries to compare markets. Examples: us, gb, de, jp, th, br.", "default": [ "us" ], "items": { "type": "string" } }, "chart": { "title": "Which chart", "enum": [ "topFreeApps", "topPaidApps", "topGrossingApps", "newApps", "newFreeApps", "newPaidApps" ], "type": "string", "description": "topFreeApps and topPaidApps are the download charts. topGrossingApps ranks by revenue and is the best proxy for which apps actually make money. The new* charts show recent releases.", "default": "topFreeApps" }, "categoryId": { "title": "Category (optional)", "type": "string", "description": "Apple genre ID to restrict the chart to one category. Leave empty for the overall chart. Common IDs: 6014 Games, 6007 Productivity, 6015 Finance, 6016 Entertainment, 6005 Social Networking, 6013 Health & Fitness, 6023 Food & Drink, 6024 Shopping, 6017 Education, 6008 Photo & Video, 6012 Lifestyle, 6002 Utilities, 6000 Business, 6003 Travel, 6004 Sports, 6009 News, 6011 Music, 6018 Books, 6020 Medical.", "default": "" }, "limit": { "title": "Chart positions per country", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many ranked positions to return per country, starting at rank 1. Apple publishes at most 200. Keep this small for fast, cheap runs.", "default": 50 }, "includeRatings": { "title": "Include ratings and app details", "type": "boolean", "description": "Adds star rating, rating count, current version, release date and description to every chart entry. Apple's chart feed does not include these, so this makes one extra batched request per country. Turn off for the fastest possible run.", "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 } } }, "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 } } } } } } } } } }