{ "openapi": "3.0.1", "info": { "title": "App Stores Scraper", "description": "Effortlessly gather app data from both the Google Play Store and Apple App Store.\nOur Actor is designed for speed, reliability, and scalability, handling multiple apps in a single run with ease.\nPerfect for businesses, developers, and analysts looking to gain insights and make data-driven decisions.", "version": "0.0", "x-build-id": "N3VflF2vL5ItmqSRL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraped_org~app-stores-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraped_org-app-stores-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/scraped_org~app-stores-scraper/runs": { "post": { "operationId": "runs-sync-scraped_org-app-stores-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/scraped_org~app-stores-scraper/run-sync": { "post": { "operationId": "run-sync-scraped_org-app-stores-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": [ "action" ], "properties": { "action": { "title": "Action", "enum": [ "apple_store_app_details", "apple_store_top_apps", "apple_store_search_apps", "google_play_app_details", "google_play_app_reviews", "google_play_top_apps", "google_play_search_apps" ], "type": "string", "description": "Select an action to perform", "default": "apple_store_app_details" }, "country": { "title": "Country", "minLength": 2, "maxLength": 2, "type": "string", "description": "2 letters country code (ISO 3166-2)", "default": "us" }, "language": { "title": "Language", "minLength": 2, "maxLength": 2, "type": "string", "description": "2 letters language code (ISO 639-1)", "default": "en" }, "apple_app_ids": { "title": "Apple App IDs", "type": "array", "description": "Apple App IDs", "default": [ "284882215" ], "items": { "type": "string" } }, "apple_store_max_reviews": { "title": "Apple Store Maximum Reviews", "minimum": 1, "type": "integer", "description": "How many reviews to extract", "default": 20 }, "apple_store_top_apps_device_types": { "title": "Apple Device Types", "type": "array", "description": "Apple Device Types", "items": { "type": "string", "enum": [ "iphone", "ipad" ], "enumTitles": [ "iPhone", "iPad" ] }, "default": [ "iphone" ] }, "apple_store_top_apps_modes": { "title": "Apple Store Modes", "type": "array", "description": "Apple Store Modes", "items": { "type": "string", "enum": [ "top-free", "top-paid" ], "enumTitles": [ "Top Free", "top-paid" ] }, "default": [ "top-free" ] }, "apple_store_top_apps_genres": { "title": "Apple Store Genres", "type": "array", "description": "Apple Store Genres", "items": { "type": "string", "enum": [ "36", "6000", "6001", "6002", "6003", "6004", "6005", "6006", "6007", "6008", "6009", "6010", "6011", "6012", "6013", "6015", "6016", "6017", "6018", "6020", "6021", "6023", "6024", "6026", "6027", "7001", "7002", "7003", "7004", "7005", "7006", "7009", "7011", "7012", "7013", "7014", "7015", "7016", "7017", "7018", "7019" ], "enumTitles": [ "Kids Apps", "Business Apps", "Weather Apps", "Utilities Apps", "Travel Apps", "Sports Apps", "Social Networking Apps", "Reference Apps", "Productivity Apps", "Photo video Apps", "News Apps", "Navigation Apps", "Music Apps", "Lifestyle Apps", "Health Fitness Apps", "Finance Apps", "Entertainment Apps", "Education Apps", "Books Apps", "Medical Apps", "Magazines Newspapers Apps", "Food Drink Apps", "Shopping Apps", "Developer tools Apps", "Graphics design Apps", "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 Games" ] }, "default": [ "6005" ] }, "apple_store_search_apps": { "title": "Apple Store Search Apps", "type": "string", "description": "Search apps in Apple Store" }, "google_bundle_ids": { "title": "Google Bundle IDs", "type": "array", "description": "Google Bundle IDs", "items": { "type": "string" } }, "google_play_reviews_sort_by": { "title": "Google Play Review Sort By", "enum": [ "newest", "most_relevant", "rating" ], "type": "string", "description": "Google Play Review Sort By", "default": "newest" }, "google_play_reviews_device_type": { "title": "Google Play Review Device Type", "enum": [ "all", "phone", "tablet", "chromebook", "tv" ], "type": "string", "description": "Google Play Review Device Type", "default": "all" }, "google_play_reviews_rating": { "title": "Google Play Review Rating", "enum": [ "all", "1", "2", "3", "4", "5" ], "type": "string", "description": "Google Play Review Rating", "default": "all" }, "google_play_max_reviews": { "title": "Google Play Maximum Reviews", "minimum": 1, "type": "integer", "description": "How many reviews to extract", "default": 100 }, "google_play_top_apps_modes": { "title": "Google Play Modes", "type": "array", "description": "Google Play Modes", "items": { "type": "string", "enum": [ "topselling_free", "topselling_paid", "topgrossing", "movers_shakers", "topselling_new_free", "topselling_new_paid" ], "enumTitles": [ "Top Selling Free", "Top Selling Paid", "Top Grossing", "Movers Shakers", "Top Selling New Free", "Top Selling New Paid" ] }, "default": [ "topselling_free" ] }, "google_play_top_apps_categories": { "title": "Google Play Categories", "type": "array", "description": "Google Play Categories", "items": { "type": "string", "enum": [ "OVERALL", "APPLICATION", "GAME", "ART_AND_DESIGN", "AUTO_AND_VEHICLES", "BEAUTY", "BOOKS_AND_REFERENCE", "BUSINESS", "COMICS", "COMMUNICATION", "DATING", "EDUCATION", "ENTERTAINMENT", "EVENTS", "FINANCE", "FOOD_AND_DRINK", "HEALTH_AND_FITNESS", "HOUSE_AND_HOME", "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", "LIBRARIES_AND_DEMO", "GAME_ARCADE", "GAME_PUZZLE", "GAME_CARD", "GAME_CASUAL", "GAME_RACING", "GAME_SPORTS", "GAME_ACTION", "GAME_ADVENTURE", "GAME_BOARD", "GAME_CASINO", "GAME_EDUCATIONAL", "GAME_MUSIC", "GAME_ROLE_PLAYING", "GAME_SIMULATION", "GAME_STRATEGY", "GAME_TRIVIA", "GAME_WORD", "ANDROID_WEAR", "FAMILY", "FAMILY_ACTION", "FAMILY_BRAINGAMES", "FAMILY_CREATE", "FAMILY_EDUCATION", "FAMILY_MUSICVIDEO", "FAMILY_PRETEND" ] }, "default": [ "SOCIAL" ] }, "google_play_max_top_apps": { "title": "Google Play Maximum Top Apps", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many Top Apps to extract", "default": 200 }, "google_play_search_apps": { "title": "Google Play Search Apps", "type": "string", "description": "Search apps in Google Play" }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler." } } }, "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 } } } } } } } } } }