{
"openapi": "3.0.1",
"info": {
"title": "Google Play Scraper: Apps & Top Charts",
"description": "Scrape Google Play apps, top charts (free, paid, grossing) for any country and category, keyword search rankings and developer catalogs: ratings, installs, prices, versions, contacts. No browser.",
"version": "0.1",
"x-build-id": "VABPVR7Ql4cUuR2MS"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/robertosan16~google-play-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-robertosan16-google-play-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/robertosan16~google-play-scraper/runs": {
"post": {
"operationId": "runs-sync-robertosan16-google-play-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/robertosan16~google-play-scraper/run-sync": {
"post": {
"operationId": "run-sync-robertosan16-google-play-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",
"properties": {
"appIds": {
"title": "Apps",
"type": "array",
"description": "Package names such as com.spotify.music or Google Play app links.",
"items": {
"type": "string"
}
},
"searchTerms": {
"title": "Search keywords",
"type": "array",
"description": "Keywords to search on Google Play. Each search returns up to 30 apps with their rank, as the store shows them, which is useful for ASO keyword tracking.",
"items": {
"type": "string"
}
},
"charts": {
"title": "Top charts",
"type": "array",
"description": "Google Play top charts to scrape, with the rank of each app.",
"items": {
"type": "string",
"enum": [
"topselling_free",
"topselling_paid",
"topgrossing"
],
"enumTitles": [
"Top free",
"Top paid",
"Top grossing"
]
}
},
"chartCategories": {
"title": "Chart categories",
"type": "array",
"description": "Categories of the top charts. \"All apps\" and \"All games\" are the main charts.",
"items": {
"type": "string",
"enum": [
"APPLICATION",
"ANDROID_WEAR",
"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",
"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",
"WATCH_FACE",
"WEATHER",
"FAMILY",
"GAME",
"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"
],
"enumTitles": [
"All apps",
"Wear OS",
"Art & Design",
"Auto & Vehicles",
"Beauty",
"Books & Reference",
"Business",
"Comics",
"Communication",
"Dating",
"Education",
"Entertainment",
"Events",
"Finance",
"Food & Drink",
"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",
"Watch Face",
"Weather",
"Family (kids)",
"All games",
"Games: Action",
"Games: Adventure",
"Games: Arcade",
"Games: Board",
"Games: Card",
"Games: Casino",
"Games: Casual",
"Games: Educational",
"Games: Music",
"Games: Puzzle",
"Games: Racing",
"Games: Role Playing",
"Games: Simulation",
"Games: Sports",
"Games: Strategy",
"Games: Trivia",
"Games: Word"
]
},
"default": [
"APPLICATION"
]
},
"chartDepth": {
"title": "Apps per chart",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "How many places of each chart to scrape, from 1 to 200.",
"default": 100
},
"developers": {
"title": "Developers",
"type": "array",
"description": "Developer names such as Spotify AB, numeric developer IDs or developer page links. All apps of each developer are scraped.",
"items": {
"type": "string"
}
},
"countries": {
"title": "Countries",
"type": "array",
"description": "Two-letter country codes such as US, GB, DE or JP. Prices, charts and search results differ by country. Every source is scraped for each country.",
"default": [
"US"
],
"items": {
"type": "string"
}
},
"language": {
"title": "Language",
"enum": [
"en",
"de",
"fr",
"es",
"es-419",
"pt-BR",
"pt-PT",
"it",
"nl",
"pl",
"tr",
"ru",
"uk",
"ar",
"he",
"hi",
"id",
"th",
"vi",
"ja",
"ko",
"zh-CN",
"zh-TW",
"sv",
"da",
"no",
"fi",
"cs",
"ro",
"hu",
"el",
"ms",
"fil"
],
"type": "string",
"description": "Language of titles and descriptions where the developer provides translations.",
"default": "en"
},
"includeDetails": {
"title": "Load full app details",
"type": "boolean",
"description": "Open each app page for ratings count, rating histogram, exact installs, version, update date, developer contacts, screenshots and the full description. Turn off for fast, lightweight lists.",
"default": true
},
"maxItems": {
"title": "Maximum results",
"minimum": 0,
"type": "integer",
"description": "Stop after this many results. Leave empty or 0 for no limit."
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "The Actor connects directly, which is fastest. If Google Play starts limiting requests, it switches to Apify Proxy automatically. Turn on a proxy here only to use it from the start.",
"default": {
"useApifyProxy": false
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}