{ "openapi": "3.0.1", "info": { "title": "App Store Top Charts Scraper ยท Ratings + Rank Changes", "description": "Apple App Store top charts (free, paid, grossing) for any country and category, plus keyword search. Every row carries rating, rating count, bundle ID and release date, and scheduled runs show rank changes and new entries. Official Apple feeds, no login.", "version": "0.1", "x-build-id": "v1MXBo8DSQhTDyNhY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thequietstack~app-store-charts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thequietstack-app-store-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/thequietstack~app-store-charts/runs": { "post": { "operationId": "runs-sync-thequietstack-app-store-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/thequietstack~app-store-charts/run-sync": { "post": { "operationId": "run-sync-thequietstack-app-store-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": { "charts": { "title": "Charts", "type": "array", "description": "Which top charts to scrape. Leave empty to run keyword search only.", "items": { "type": "string", "enum": [ "top-free", "top-paid", "top-grossing" ], "enumTitles": [ "Top free", "Top paid", "Top grossing" ] }, "default": [ "top-free", "top-paid", "top-grossing" ] }, "categories": { "title": "Categories", "type": "array", "description": "\"all\" for the overall chart, or category names / IDs: games, games/puzzle, productivity, health & fitness, finance, 6014 ... One chart per category.", "default": [ "all" ], "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes (us, gb, de, jp ...). One chart per country.", "default": [ "us" ], "items": { "type": "string" } }, "device": { "title": "Device", "enum": [ "iphone", "ipad" ], "type": "string", "description": "iPhone or iPad charts.", "default": "iphone" }, "appsPerChart": { "title": "Apps per chart", "minimum": 1, "maximum": 100, "type": "integer", "description": "Apple publishes the top 100 of every chart.", "default": 100 }, "searchTerms": { "title": "Keyword search", "type": "array", "description": "Optional. Search results in App Store order, one search per keyword and country, with the same fields as the chart rows.", "items": { "type": "string" } }, "resultsPerSearchTerm": { "title": "Results per keyword", "minimum": 1, "maximum": 200, "type": "integer", "description": "Apple's search API returns up to 200.", "default": 50 }, "trackRankChanges": { "title": "Track rank changes between runs", "type": "boolean", "description": "Saves a small snapshot of each chart in a named key-value store in your account. The next run fills previousRank, rankChange and isNewInChart. Schedule the Actor daily to get a rank history.", "default": true }, "historyStoreName": { "title": "Snapshot store name", "type": "string", "description": "Named key-value store for the rank snapshots. Use different names to keep separate histories.", "default": "app-store-charts-history" }, "maxResults": { "title": "Hard limit: total rows in this run", "minimum": 1, "type": "integer", "description": "The run stops cleanly at this number. You are never charged for more rows than this.", "default": 5000 }, "concurrency": { "title": "Parallel charts", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many charts are fetched at the same time.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Requests go direct first. Only retries (after HTTP 403/429/5xx) use the proxy, on a fresh IP each time.", "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 } } } } } } } } } }