# Top Ranking Mobile Apps (`codebyte/top-ranking-mobile-apps`) Actor Scrape top trending apps for both Apple App Store and Google Play Store. Extract by category, country, device, and date including download estimates, revenue estimates, ratings, publisher info and pricing data. Monitor competitor rankings, track market trends, measure app performance across regions. - **URL**: https://apify.com/codebyte/top-ranking-mobile-apps.md - **Developed by:** [Codebyte](https://apify.com/codebyte) (community) - **Categories:** E-commerce, Lead generation, SEO tools - **Stats:** 56 total users, 21 monthly users, 100.0% runs succeeded, 3 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## App Store Top Charts Scraper Scrape top trending apps for both **Apple App Store** and **Google Play Store**. Extract top-ranked apps by category, country, device, and date — including download estimates, revenue estimates, ratings, publisher info, and pricing data. ### What does the App Store Top Charts Scraper do? This Actor retrieves app category ranking data for both iOS App Store and Google Play Store, covering **90+ countries** and **100+ categories** including all major app and game subcategories. For each ranked app, the scraper returns: - **Rank position** and previous rank (track movement over time) - **App name**, app ID, and icon URL - **Publisher name** and publisher ID - **Estimated worldwide monthly downloads** (humanized, e.g., "400k") - **Estimated worldwide monthly revenue** (humanized, e.g., "$600k") - **Price** with currency and formatted value - **Rating** score and rating count - **In-app purchases** availability flag - **Ranking type** — each request returns three top-25 charts: **Top Free**, **Top Paid**, and **Top Grossing** (up to 75 apps per request) - **App overview URL** for each app Use it to monitor competitor rankings, track market trends, benchmark app performance across regions, or build datasets for app market intelligence. Rankings are updated at different time intervals: App Store rankings are accurate and updated hourly, while Google Play store rankings are updated daily. ### Use cases - **Competitive intelligence** — Track how competing apps rank across categories and countries over time. - **Market research** — Identify top-performing apps in specific categories and regions. - **Trend analysis** — Monitor ranking changes by date to spot emerging apps and declining ones. - **Investment research** — Evaluate app revenue and download estimates for due diligence. - **ASO (App Store Optimization)** — Understand category landscapes to inform keyword and positioning strategies. ### How to use 1. Configure your requests by specifying the store (App Store or Google Play), country, category, device type (iOS only), and date. 2. Run the Actor — each request returns up to 75 results (Top 25 Free + Top 25 Paid + Top 25 Grossing). 3. Retrieve structured JSON results from the output dataset. #### Example input ```json { "app_store_requests": [ { "country": "US", "category": "6015", "device": "iphone", "date": "1 day" } ], "google_play_requests": [ { "country": "US", "category": "game", "date": "3 days" } ] } ```` ### Input schema The Actor accepts two arrays of request objects — one for each store. #### App Store Requests (`app_store_requests`) Each item requires: | Field | Type | Description | |-------|------|-------------| | `country` | string | ISO country code (e.g., `US`, `GB`, `DE`, `JP`). 90+ countries supported. | | `category` | string | iOS category ID. `0` = Overall. See full list in input schema (e.g., `6015` = Games, `6016` = Finance, `6017` = Entertainment). | | `device` | string | `iphone` or `ipad`. | | `date` | string | Ranking date. Accepts `YYYY-MM-DD` or relative format like `1 day`, `3 days`, `1 week`. Defaults to `1 day` (yesterday). Must be within the last 30 days. | #### Google Play Requests (`google_play_requests`) Each item requires: | Field | Type | Description | |-------|------|-------------| | `country` | string | ISO country code (e.g., `US`, `GB`, `DE`, `JP`). 90+ countries supported. | | `category` | string | Google Play category slug. `all` = Overall. See full list in input schema (e.g., `game`, `finance`, `entertainment`, `game_action`). | | `date` | string | Ranking date. Accepts `YYYY-MM-DD` or relative format like `1 day`, `3 days`, `1 week`. Defaults to `1 day` (yesterday). Must be within the last 30 days. | #### Supported countries (both stores) US, GB, DE, FR, JP, KR, CN, IN, BR, AU, CA, IT, ES, NL, SE, NO, DK, FI, PL, CZ, RU, TR, SA, AE, EG, ZA, NG, MX, AR, CL, CO, TH, VN, ID, PH, MY, SG, HK, TW, and 50+ more. #### Supported iOS categories Overall, Business, Weather, Utilities, Travel, Sports, Social Networking, Reference, Productivity, Photo & Video, News, Navigation, Music, Lifestyle, Health & Fitness, Games (+ 18 subcategories), Finance, Entertainment, Education, Books, Medical, Food & Drink, Shopping, Developer Tools, Kids (+ age subcategories), and more. #### Supported Google Play categories Overall, Art & Design, Auto & Vehicles, Beauty, Books & Reference, Business, Comics, Communication, Dating, Education, Entertainment, Events, Family, Finance, Food & Drink, Game (+ 18 subcategories), Health & Fitness, House & Home, Lifestyle, Maps & Navigation, Medical, Music & Audio, News & Magazines, Parenting, Personalization, Photography, Productivity, Shopping, Social, Sports, Tools, Travel & Local, Video Players, Weather, and more. ### Output Each request returns up to **75 dataset items** — 25 apps per ranking type: | `_ranking_type` | Description | |-----------------|-------------| | `free` | Top 25 Free Downloads | | `paid` | Top 25 Paid Downloads | | `grossing` | Top 25 Top Grossing | Results are pushed to the default dataset. Each item represents one ranked app and contains: #### Example output item ```json { "os": "ios", "publisher_id": 347363505, "publisher_name": "LEGO", "in_app_purchases": false, "humanized_worldwide_last_month_downloads": { "downloads": 400000, "downloads_rounded": 400, "prefix": null, "string": "400k", "units": "k" }, "humanized_worldwide_last_month_revenue": { "prefix": "< $", "revenue": 1000, "revenue_rounded": 5, "string": "< $5k", "units": "k" }, "icon_url": "...", "rank": 1, "previous_rank": 1, "app_id": 1486159728, "name": "LEGO® Builder: 3D Instructions", "price": { "currency": "USD", "value": 0, "string_value": "$0.00", "subunit_to_unit": 100 }, "rating": 4.80131, "rating_count": 239089, "app_overview_url": "...", "_ranking_type": "free", "_store": "app_store", "_country": "US", "_category": "6015", "_date": "2025-03-01", "_device": "iphone" } ``` #### Output fields reference | Field | Type | Description | |-------|------|-------------| | `name` | string | App name | | `app_id` | string/integer | App Store or Google Play app identifier | | `os` | string | Operating system (`ios` or `android`) | | `rank` | integer | Current rank position in the category | | `previous_rank` | integer/null | Previous rank position (null if new entry) | | `_ranking_type` | string | Ranking list type: `free`, `paid`, or `grossing` | | `publisher_name` | string | App publisher/developer name | | `publisher_id` | integer/string | Publisher identifier | | `rating` | number | Average user rating | | `rating_count` | integer | Total number of ratings | | `price` | object | Price details including `currency`, `value`, and `string_value` | | `in_app_purchases` | boolean | Whether the app offers in-app purchases | | `humanized_worldwide_last_month_downloads` | object | Estimated monthly downloads with humanized string (e.g., "400k") | | `humanized_worldwide_last_month_revenue` | object | Estimated monthly revenue with humanized string (e.g., "$600k") | | `icon_url` | string | URL to the app icon image | | `app_overview_url` | string | App overview page URL | | `_store` | string | Store identifier: `app_store` or `google_play` | | `_country` | string | Country code used for the request | | `_category` | string | Category ID/slug used for the request | | `_date` | string | Date used for the request | | `_device` | string | Device type used for the request | ### Integrations Connect the App Store Top Charts Scraper with other apps and services using the [Apify integrations](https://apify.com/integrations). You can integrate with Make, Zapier, Slack, Discord, or use webhooks to automate actions whenever a run finishes. Export data directly to Google Sheets, Google Drive, Amazon S3, or other storage solutions. # Actor input Schema ## `app_store_requests` (type: `array`): List of App Store category ranking requests. Each item maps to one API call. ## `google_play_requests` (type: `array`): List of Google Play category ranking requests. Each item maps to one API call. ## Actor input object example ```json { "app_store_requests": [ { "country": "US", "category": "0", "device": "iphone", "date": "1 day" } ], "google_play_requests": [ { "country": "US", "category": "all", "date": "1 day" } ] } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "app_store_requests": [ { "country": "US", "category": "0", "device": "iphone", "date": "1 day" } ], "google_play_requests": [ { "country": "US", "category": "all", "date": "1 day" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("codebyte/top-ranking-mobile-apps").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "app_store_requests": [{ "country": "US", "category": "0", "device": "iphone", "date": "1 day", }], "google_play_requests": [{ "country": "US", "category": "all", "date": "1 day", }], } # Run the Actor and wait for it to finish run = client.actor("codebyte/top-ranking-mobile-apps").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "app_store_requests": [ { "country": "US", "category": "0", "device": "iphone", "date": "1 day" } ], "google_play_requests": [ { "country": "US", "category": "all", "date": "1 day" } ] }' | apify call codebyte/top-ranking-mobile-apps --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=codebyte/top-ranking-mobile-apps", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Top Ranking Mobile Apps", "description": "Scrape top trending apps for both Apple App Store and Google Play Store. Extract by category, country, device, and date including download estimates, revenue estimates, ratings, publisher info and pricing data. Monitor competitor rankings, track market trends, measure app performance across regions.", "version": "0.1", "x-build-id": "8kttbebceaJX1WpYF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codebyte~top-ranking-mobile-apps/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codebyte-top-ranking-mobile-apps", "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/codebyte~top-ranking-mobile-apps/runs": { "post": { "operationId": "runs-sync-codebyte-top-ranking-mobile-apps", "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/codebyte~top-ranking-mobile-apps/run-sync": { "post": { "operationId": "run-sync-codebyte-top-ranking-mobile-apps", "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": { "app_store_requests": { "title": "App Store Requests", "type": "array", "description": "List of App Store category ranking requests. Each item maps to one API call.", "items": { "type": "object", "properties": { "country": { "title": "Country", "type": "string", "description": "Country code for the ranking", "editor": "select", "enum": [ "AE", "AO", "AR", "AT", "AU", "AZ", "BE", "BF", "BG", "BH", "BJ", "BO", "BR", "BY", "CA", "CG", "CH", "CI", "CL", "CM", "CN", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "DZ", "EC", "EE", "EG", "ES", "FI", "FR", "GB", "GE", "GH", "GR", "GT", "HK", "HR", "HU", "ID", "IE", "IL", "IN", "IQ", "IT", "JO", "JP", "KE", "KH", "KR", "KW", "KZ", "LA", "LB", "LK", "LT", "LU", "LV", "LY", "MA", "ML", "MM", "MO", "MT", "MX", "MY", "MZ", "NG", "NI", "NL", "NO", "NZ", "OM", "PA", "PE", "PH", "PK", "PL", "PT", "PY", "QA", "RO", "RS", "RU", "SA", "SE", "SG", "SI", "SK", "SN", "SV", "TH", "TN", "TR", "TW", "TZ", "UA", "UG", "US", "UY", "UZ", "VE", "VN", "YE", "ZA", "ZM", "ZW" ], "enumTitles": [ "United Arab Emirates", "Angola", "Argentina", "Austria", "Australia", "Azerbaijan", "Belgium", "Burkina Faso", "Bulgaria", "Bahrain", "Benin", "Bolivia", "Brazil", "Belarus", "Canada", "Congo", "Switzerland", "Côte d'Ivoire", "Chile", "Cameroon", "China", "Colombia", "Costa Rica", "Cyprus", "Czech Republic", "Germany", "Denmark", "Dominican Republic", "Algeria", "Ecuador", "Estonia", "Egypt", "Spain", "Finland", "France", "United Kingdom", "Georgia", "Ghana", "Greece", "Guatemala", "Hong Kong", "Croatia", "Hungary", "Indonesia", "Ireland", "Israel", "India", "Iraq", "Italy", "Jordan", "Japan", "Kenya", "Cambodia", "South Korea", "Kuwait", "Kazakhstan", "Laos", "Lebanon", "Sri Lanka", "Lithuania", "Luxembourg", "Latvia", "Libya", "Morocco", "Mali", "Myanmar", "Macau", "Malta", "Mexico", "Malaysia", "Mozambique", "Nigeria", "Nicaragua", "Netherlands", "Norway", "New Zealand", "Oman", "Panama", "Peru", "Philippines", "Pakistan", "Poland", "Portugal", "Paraguay", "Qatar", "Romania", "Serbia", "Russia", "Saudi Arabia", "Sweden", "Singapore", "Slovenia", "Slovakia", "Senegal", "El Salvador", "Thailand", "Tunisia", "Turkey", "Taiwan", "Tanzania", "Ukraine", "Uganda", "US", "Uruguay", "Uzbekistan", "Venezuela", "Vietnam", "Yemen", "South Africa", "Zambia", "Zimbabwe" ], "default": "US" }, "category": { "title": "Category", "type": "string", "description": "iOS App Store category ID", "editor": "select", "enum": [ "0", "6000", "6001", "6002", "6003", "6004", "6005", "6006", "6007", "6008", "6009", "6010", "6011", "6012", "6013", "6014", "6015", "6016", "6017", "6018", "6020", "6023", "6024", "6026", "6027", "7001", "7002", "7003", "7004", "7005", "7006", "7009", "7011", "7012", "7013", "7014", "7015", "7016", "7017", "7018", "7019", "9007", "10000", "10001", "10002" ], "enumTitles": [ "Overall", "Business", "Weather", "Utilities", "Travel", "Sports", "Social Networking", "Reference", "Productivity", "Photo & Video", "News", "Navigation", "Music", "Lifestyle", "Health & Fitness", "Games", "Finance", "Entertainment", "Education", "Books", "Medical", "Food & Drink", "Shopping", "Developer Tools", "Graphics & Design", "Games / Action", "Games / Adventure", "Games / Casual", "Games / Board", "Games / Card", "Games / Casino", "Games / Family", "Games / Music", "Games / Puzzle", "Games / Racing", "Games / Role Playing", "Games / Simulation", "Games / Sports", "Games / Strategy", "Games / Trivia", "Games / Word", "Kids", "Kids / Ages 5 & Under", "Kids / Ages 6-8", "Kids / Ages 9-11" ], "default": "0" }, "device": { "title": "Device", "type": "string", "description": "Device type", "editor": "select", "enum": [ "iphone", "ipad" ], "enumTitles": [ "iPhone", "iPad" ], "default": "iphone" }, "date": { "title": "Date", "type": "string", "description": "Date for the ranking in YYYY-MM-DD or relative format (e.g. '1 day', '3 days', '1 week'). Must be within the last 30 days.", "editor": "datepicker", "dateType": "absoluteOrRelative", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "default": "1 day" } }, "required": [ "country", "category", "device" ], "additionalProperties": false }, "default": [ { "country": "US", "category": "0", "device": "iphone", "date": "1 day" } ] }, "google_play_requests": { "title": "Google Play Requests", "type": "array", "description": "List of Google Play category ranking requests. Each item maps to one API call.", "items": { "type": "object", "properties": { "country": { "title": "Country", "type": "string", "description": "Country code for the ranking", "editor": "select", "enum": [ "AE", "AO", "AR", "AT", "AU", "AZ", "BE", "BF", "BG", "BH", "BJ", "BO", "BR", "BY", "CA", "CG", "CH", "CI", "CL", "CM", "CN", "CO", "CR", "CY", "CZ", "DE", "DK", "DO", "DZ", "EC", "EE", "EG", "ES", "FI", "FR", "GB", "GE", "GH", "GR", "GT", "HK", "HR", "HU", "ID", "IE", "IL", "IN", "IQ", "IT", "JO", "JP", "KE", "KH", "KR", "KW", "KZ", "LA", "LB", "LK", "LT", "LU", "LV", "LY", "MA", "ML", "MM", "MO", "MT", "MX", "MY", "MZ", "NG", "NI", "NL", "NO", "NZ", "OM", "PA", "PE", "PH", "PK", "PL", "PT", "PY", "QA", "RO", "RS", "RU", "SA", "SE", "SG", "SI", "SK", "SN", "SV", "TH", "TN", "TR", "TW", "TZ", "UA", "UG", "US", "UY", "UZ", "VE", "VN", "YE", "ZA", "ZM", "ZW" ], "enumTitles": [ "United Arab Emirates", "Angola", "Argentina", "Austria", "Australia", "Azerbaijan", "Belgium", "Burkina Faso", "Bulgaria", "Bahrain", "Benin", "Bolivia", "Brazil", "Belarus", "Canada", "Congo", "Switzerland", "Côte d'Ivoire", "Chile", "Cameroon", "China", "Colombia", "Costa Rica", "Cyprus", "Czech Republic", "Germany", "Denmark", "Dominican Republic", "Algeria", "Ecuador", "Estonia", "Egypt", "Spain", "Finland", "France", "United Kingdom", "Georgia", "Ghana", "Greece", "Guatemala", "Hong Kong", "Croatia", "Hungary", "Indonesia", "Ireland", "Israel", "India", "Iraq", "Italy", "Jordan", "Japan", "Kenya", "Cambodia", "South Korea", "Kuwait", "Kazakhstan", "Laos", "Lebanon", "Sri Lanka", "Lithuania", "Luxembourg", "Latvia", "Libya", "Morocco", "Mali", "Myanmar", "Macau", "Malta", "Mexico", "Malaysia", "Mozambique", "Nigeria", "Nicaragua", "Netherlands", "Norway", "New Zealand", "Oman", "Panama", "Peru", "Philippines", "Pakistan", "Poland", "Portugal", "Paraguay", "Qatar", "Romania", "Serbia", "Russia", "Saudi Arabia", "Sweden", "Singapore", "Slovenia", "Slovakia", "Senegal", "El Salvador", "Thailand", "Tunisia", "Turkey", "Taiwan", "Tanzania", "Ukraine", "Uganda", "US", "Uruguay", "Uzbekistan", "Venezuela", "Vietnam", "Yemen", "South Africa", "Zambia", "Zimbabwe" ], "default": "US" }, "category": { "title": "Category", "type": "string", "description": "Google Play category", "editor": "select", "enum": [ "all", "art_and_design", "auto_and_vehicles", "beauty", "books_and_reference", "business", "comics", "communication", "dating", "education", "entertainment", "events", "family", "finance", "food_and_drink", "game", "health_and_fitness", "house_and_home", "libraries_and_demo", "lifestyle", "maps_and_navigation", "medical", "music_and_audio", "news_and_magazines", "parenting", "personalization", "photography", "productivity", "shopping", "social", "sports", "tools", "travel_and_local", "video_players", "weather", "game_action", "game_adventure", "game_arcade", "game_board", "game_card", "game_casino", "game_casual", "game_educational", "game_music", "game_puzzle", "game_racing", "game_role_playing", "game_simulation", "game_sports", "game_strategy", "game_trivia", "game_word", "family_action", "family_braingames", "family_create", "family_education", "family_musicvideo", "family_pretend", "application", "app_wallpaper", "app_widgets", "game_family", "game_wallpaper", "game_widgets", "media_and_video", "transportation" ], "enumTitles": [ "Overall", "Art & Design", "Auto & Vehicles", "Beauty", "Books & Reference", "Business", "Comics", "Communication", "Dating", "Education", "Entertainment", "Events", "Family", "Finance", "Food & Drink", "Game", "Health & Fitness", "House & Home", "Libraries & Demo", "Lifestyle", "Maps & Navigation", "Medical", "Music & Audio", "News & Magazines", "Parenting", "Personalization", "Photography", "Productivity", "Shopping", "Social", "Sports", "Tools", "Travel & Local", "Video Players & Editors", "Weather", "Game / Action", "Game / Adventure", "Game / Arcade", "Game / Board", "Game / Card", "Game / Casino", "Game / Casual", "Game / Educational", "Game / Music", "Game / Puzzle", "Game / Racing", "Game / Role Playing", "Game / Simulation", "Game / Sports", "Game / Strategy", "Game / Trivia", "Game / Word", "Family / Action & Adventure", "Family / Brain Games", "Family / Creativity", "Family / Education", "Family / Music & Video", "Family / Pretend Play", "Application", "App Wallpaper", "App Widgets", "Family", "Wallpaper", "Widgets", "Media & Video", "Transportation" ], "default": "all" }, "date": { "title": "Date", "type": "string", "description": "Date for the ranking in YYYY-MM-DD or relative format (e.g. '1 day', '3 days', '1 week'). Must be within the last 30 days.", "editor": "datepicker", "dateType": "absoluteOrRelative", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "default": "1 day" } }, "required": [ "country", "category" ], "additionalProperties": false }, "default": [ { "country": "US", "category": "all", "date": "1 day" } ] } } }, "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 } } } } } } } } } } ```