{ "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 } } } } } } } } } }