{
"openapi": "3.0.1",
"info": {
"title": "Google Play Scraper: App Data, Developers & Categories",
"description": "Google Play app data: name, description, price, rating and 1–5 star breakdown, installs, version, update date, developer email and website, screenshots. Find apps by link or package name, developer, category or similar apps, in 174 countries. Export to JSON, CSV or Excel, or via API. No login.",
"version": "1.0",
"x-build-id": "dqYkPOGlo0ao7hUGf"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/steadyscrape~google-play-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-steadyscrape-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/steadyscrape~google-play-scraper/runs": {
"post": {
"operationId": "runs-sync-steadyscrape-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/steadyscrape~google-play-scraper/run-sync": {
"post": {
"operationId": "run-sync-steadyscrape-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": {
"apps": {
"title": "Apps",
"type": "array",
"description": "Google Play package names or app links (com.duolingo, https://play.google.com/store/apps/details?id=com.duolingo). Each one is scraped in full, and is where similar apps and developer apps start from.",
"items": {
"type": "string"
}
},
"developers": {
"title": "Developers",
"type": "array",
"description": "Developer names as Google Play shows them (Duolingo, Google LLC) or developer links (https://play.google.com/store/apps/developer?id=Google+LLC, https://play.google.com/store/apps/dev?id=5700313618786177705). Every app the developer's page lists is scraped: up to 20 by name, or up to 30 from a developer page with a numeric id (its own page plus its list by name, keeping only that developer's apps).",
"items": {
"type": "string"
}
},
"categories": {
"title": "Categories",
"type": "array",
"description": "Google Play categories. Every app the category page lists is scraped (25 to 120 apps, in sections such as \"Popular apps\"), each with the section it was listed in and its position.",
"items": {
"type": "string",
"enum": [
"APPLICATION",
"FAMILY",
"ANDROID_WEAR",
"ART_AND_DESIGN",
"AUTO_AND_VEHICLES",
"BEAUTY",
"BOOKS_AND_REFERENCE",
"BUSINESS",
"COMICS",
"COMMUNICATION",
"EDUCATION",
"ENTERTAINMENT",
"EVENTS",
"FINANCE",
"FOOD_AND_DRINK",
"HEALTH_AND_FITNESS",
"HOUSE_AND_HOME",
"LIFESTYLE",
"MAPS_AND_NAVIGATION",
"MUSIC_AND_AUDIO",
"PARENTING",
"PERSONALIZATION",
"PHOTOGRAPHY",
"PRODUCTIVITY",
"SHOPPING",
"SOCIAL",
"SPORTS",
"TOOLS",
"TRAVEL_AND_LOCAL",
"VIDEO_PLAYERS",
"WATCH_FACE",
"WEATHER",
"GAME",
"GAME_ACTION",
"GAME_ADVENTURE",
"GAME_ARCADE",
"GAME_BOARD",
"GAME_CARD",
"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 (APPLICATION)",
"Kids (FAMILY)",
"Watch apps (ANDROID_WEAR)",
"Art & Design (ART_AND_DESIGN)",
"Auto & Vehicles (AUTO_AND_VEHICLES)",
"Beauty (BEAUTY)",
"Books & Reference (BOOKS_AND_REFERENCE)",
"Business (BUSINESS)",
"Comics (COMICS)",
"Communication (COMMUNICATION)",
"Education (EDUCATION)",
"Entertainment (ENTERTAINMENT)",
"Events (EVENTS)",
"Finance (FINANCE)",
"Food & Drink (FOOD_AND_DRINK)",
"Health & Fitness (HEALTH_AND_FITNESS)",
"House & Home (HOUSE_AND_HOME)",
"Lifestyle (LIFESTYLE)",
"Maps & Navigation (MAPS_AND_NAVIGATION)",
"Music & Audio (MUSIC_AND_AUDIO)",
"Parenting (PARENTING)",
"Personalization (PERSONALIZATION)",
"Photography (PHOTOGRAPHY)",
"Productivity (PRODUCTIVITY)",
"Shopping (SHOPPING)",
"Social (SOCIAL)",
"Sports (SPORTS)",
"Tools (TOOLS)",
"Travel & Local (TRAVEL_AND_LOCAL)",
"Video Players & Editors (VIDEO_PLAYERS)",
"Watch faces (WATCH_FACE)",
"Weather (WEATHER)",
"All games (GAME)",
"Games: Action (GAME_ACTION)",
"Games: Adventure (GAME_ADVENTURE)",
"Games: Arcade (GAME_ARCADE)",
"Games: Board (GAME_BOARD)",
"Games: Card (GAME_CARD)",
"Games: Casual (GAME_CASUAL)",
"Games: Educational (GAME_EDUCATIONAL)",
"Games: Music (GAME_MUSIC)",
"Games: Puzzle (GAME_PUZZLE)",
"Games: Racing (GAME_RACING)",
"Games: Role Playing (GAME_ROLE_PLAYING)",
"Games: Simulation (GAME_SIMULATION)",
"Games: Sports (GAME_SPORTS)",
"Games: Strategy (GAME_STRATEGY)",
"Games: Trivia (GAME_TRIVIA)",
"Games: Word (GAME_WORD)"
]
}
},
"includeSimilarApps": {
"title": "Also scrape similar apps",
"type": "boolean",
"description": "For each app in Apps, also scrape the apps Google Play lists as similar to it (up to 50).",
"default": false
},
"includeDeveloperApps": {
"title": "Also scrape each app's developer's other apps",
"type": "boolean",
"description": "For each app in Apps, also scrape the other apps of its developer, as listed on the developer's page.",
"default": false
},
"maxAppsPerSource": {
"title": "Max apps per list",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "A cap on the apps taken from each developer, category or similar-apps list, in the order Google Play lists them. Apps given in Apps are always scraped. Leave it empty for every app a list shows (up to 200).",
"default": 200
},
"countries": {
"title": "Countries",
"type": "array",
"description": "Google Play countries. Everything is read once per country: price, currency, rating, texts and the developer and category lists change by country.",
"items": {
"type": "string",
"enum": [
"af",
"al",
"dz",
"ao",
"ai",
"ag",
"ar",
"am",
"au",
"at",
"az",
"bs",
"bh",
"bb",
"by",
"be",
"bz",
"bj",
"bm",
"bt",
"bo",
"ba",
"bw",
"br",
"vg",
"bn",
"bg",
"bf",
"kh",
"cm",
"ca",
"cv",
"ky",
"td",
"cl",
"cn",
"co",
"cg",
"cd",
"cr",
"ci",
"hr",
"cy",
"cz",
"dk",
"dm",
"do",
"ec",
"eg",
"sv",
"ee",
"sz",
"fj",
"fi",
"fr",
"ga",
"gm",
"ge",
"de",
"gh",
"gr",
"gd",
"gt",
"gw",
"gy",
"hn",
"hk",
"hu",
"is",
"in",
"id",
"iq",
"ie",
"il",
"it",
"jm",
"jp",
"jo",
"kz",
"ke",
"xk",
"kw",
"kg",
"la",
"lv",
"lb",
"lr",
"ly",
"lt",
"lu",
"mo",
"mg",
"mw",
"my",
"mv",
"ml",
"mt",
"mr",
"mu",
"mx",
"fm",
"md",
"mn",
"me",
"ms",
"ma",
"mz",
"mm",
"na",
"nr",
"np",
"nl",
"nz",
"ni",
"ne",
"ng",
"mk",
"no",
"om",
"pk",
"pw",
"pa",
"pg",
"py",
"pe",
"ph",
"pl",
"pt",
"qa",
"ro",
"ru",
"rw",
"st",
"sa",
"sn",
"rs",
"sc",
"sl",
"sg",
"sk",
"si",
"sb",
"za",
"kr",
"es",
"lk",
"kn",
"lc",
"vc",
"sr",
"se",
"ch",
"tw",
"tj",
"tz",
"th",
"to",
"tt",
"tn",
"tr",
"tm",
"ug",
"ua",
"ae",
"gb",
"us",
"uy",
"uz",
"vu",
"ve",
"vn",
"ye",
"zm",
"zw"
],
"enumTitles": [
"Afghanistan (af)",
"Albania (al)",
"Algeria (dz)",
"Angola (ao)",
"Anguilla (ai)",
"Antigua & Barbuda (ag)",
"Argentina (ar)",
"Armenia (am)",
"Australia (au)",
"Austria (at)",
"Azerbaijan (az)",
"Bahamas (bs)",
"Bahrain (bh)",
"Barbados (bb)",
"Belarus (by)",
"Belgium (be)",
"Belize (bz)",
"Benin (bj)",
"Bermuda (bm)",
"Bhutan (bt)",
"Bolivia (bo)",
"Bosnia & Herzegovina (ba)",
"Botswana (bw)",
"Brazil (br)",
"British Virgin Islands (vg)",
"Brunei (bn)",
"Bulgaria (bg)",
"Burkina Faso (bf)",
"Cambodia (kh)",
"Cameroon (cm)",
"Canada (ca)",
"Cape Verde (cv)",
"Cayman Islands (ky)",
"Chad (td)",
"Chile (cl)",
"China (cn)",
"Colombia (co)",
"Congo - Brazzaville (cg)",
"Congo - Kinshasa (cd)",
"Costa Rica (cr)",
"Côte d’Ivoire (ci)",
"Croatia (hr)",
"Cyprus (cy)",
"Czechia (cz)",
"Denmark (dk)",
"Dominica (dm)",
"Dominican Republic (do)",
"Ecuador (ec)",
"Egypt (eg)",
"El Salvador (sv)",
"Estonia (ee)",
"Eswatini (sz)",
"Fiji (fj)",
"Finland (fi)",
"France (fr)",
"Gabon (ga)",
"Gambia (gm)",
"Georgia (ge)",
"Germany (de)",
"Ghana (gh)",
"Greece (gr)",
"Grenada (gd)",
"Guatemala (gt)",
"Guinea-Bissau (gw)",
"Guyana (gy)",
"Honduras (hn)",
"Hong Kong SAR China (hk)",
"Hungary (hu)",
"Iceland (is)",
"India (in)",
"Indonesia (id)",
"Iraq (iq)",
"Ireland (ie)",
"Israel (il)",
"Italy (it)",
"Jamaica (jm)",
"Japan (jp)",
"Jordan (jo)",
"Kazakhstan (kz)",
"Kenya (ke)",
"Kosovo (xk)",
"Kuwait (kw)",
"Kyrgyzstan (kg)",
"Laos (la)",
"Latvia (lv)",
"Lebanon (lb)",
"Liberia (lr)",
"Libya (ly)",
"Lithuania (lt)",
"Luxembourg (lu)",
"Macao SAR China (mo)",
"Madagascar (mg)",
"Malawi (mw)",
"Malaysia (my)",
"Maldives (mv)",
"Mali (ml)",
"Malta (mt)",
"Mauritania (mr)",
"Mauritius (mu)",
"Mexico (mx)",
"Micronesia (fm)",
"Moldova (md)",
"Mongolia (mn)",
"Montenegro (me)",
"Montserrat (ms)",
"Morocco (ma)",
"Mozambique (mz)",
"Myanmar (Burma) (mm)",
"Namibia (na)",
"Nauru (nr)",
"Nepal (np)",
"Netherlands (nl)",
"New Zealand (nz)",
"Nicaragua (ni)",
"Niger (ne)",
"Nigeria (ng)",
"North Macedonia (mk)",
"Norway (no)",
"Oman (om)",
"Pakistan (pk)",
"Palau (pw)",
"Panama (pa)",
"Papua New Guinea (pg)",
"Paraguay (py)",
"Peru (pe)",
"Philippines (ph)",
"Poland (pl)",
"Portugal (pt)",
"Qatar (qa)",
"Romania (ro)",
"Russia (ru)",
"Rwanda (rw)",
"São Tomé & Príncipe (st)",
"Saudi Arabia (sa)",
"Senegal (sn)",
"Serbia (rs)",
"Seychelles (sc)",
"Sierra Leone (sl)",
"Singapore (sg)",
"Slovakia (sk)",
"Slovenia (si)",
"Solomon Islands (sb)",
"South Africa (za)",
"South Korea (kr)",
"Spain (es)",
"Sri Lanka (lk)",
"St. Kitts & Nevis (kn)",
"St. Lucia (lc)",
"St. Vincent & Grenadines (vc)",
"Suriname (sr)",
"Sweden (se)",
"Switzerland (ch)",
"Taiwan (tw)",
"Tajikistan (tj)",
"Tanzania (tz)",
"Thailand (th)",
"Tonga (to)",
"Trinidad & Tobago (tt)",
"Tunisia (tn)",
"Türkiye (tr)",
"Turkmenistan (tm)",
"Uganda (ug)",
"Ukraine (ua)",
"United Arab Emirates (ae)",
"United Kingdom (gb)",
"United States (us)",
"Uruguay (uy)",
"Uzbekistan (uz)",
"Vanuatu (vu)",
"Venezuela (ve)",
"Vietnam (vn)",
"Yemen (ye)",
"Zambia (zm)",
"Zimbabwe (zw)"
]
},
"default": [
"us"
]
},
"language": {
"title": "Language",
"enum": [
"",
"af",
"sq",
"am",
"ar",
"hy",
"az",
"bn",
"eu",
"be",
"bg",
"my",
"ca-ES",
"zh-Hans",
"zh-Hant",
"hr-HR",
"cs-CZ",
"da-DK",
"nl-NL",
"en-AU",
"en-CA",
"en-IN",
"en-GB",
"en-US",
"et",
"fil",
"fi-FI",
"fr-FR",
"fr-CA",
"gl",
"ka",
"de-DE",
"el-GR",
"gu",
"he-IL",
"hi-IN",
"hu-HU",
"is",
"id-ID",
"it-IT",
"ja-JP",
"kn",
"kk",
"km",
"ko-KR",
"ky",
"lo",
"lv",
"lt",
"mk",
"ms-MY",
"ml",
"mr",
"mn",
"ne",
"nb-NO",
"fa",
"pl-PL",
"pt-BR",
"pt-PT",
"pa",
"ro-RO",
"ru-RU",
"sr",
"si",
"sk-SK",
"sl-SI",
"es-MX",
"es-ES",
"es-US",
"sw",
"sv-SE",
"ta-IN",
"te",
"th-TH",
"tr-TR",
"uk-UA",
"ur-PK",
"uz",
"vi-VN",
"zu"
],
"type": "string",
"description": "Language of the listings and of the list headings. Leave the default to use each country's main language.",
"default": ""
}
}
},
"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
}
}
}
}
}
}
}
}
}
}