{ "openapi": "3.0.1", "info": { "title": "Google Play Scraper | Apps & Developer Emails", "description": "Extract Google Play apps, ratings, prices, developer contacts and optional reviews across 183 market presets. Search keywords or categories, browse developers, or supply app IDs. Pay per delivered row plus a start fee.", "version": "0.1", "x-build-id": "qhPC2U747li7eT1Ld" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~google-play-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-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/lentic_clockss~google-play-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-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/lentic_clockss~google-play-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-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": { "mode": { "title": "Mode", "enum": [ "auto", "search", "category", "home", "developer", "detail", "datasafety" ], "type": "string", "description": "Choose what to collect, or use auto to select a mode from your app links, package IDs, numeric developer ID, search keyword or category. Home needs no target field.", "default": "auto" }, "q": { "title": "Search keyword", "type": "string", "description": "Words to search for on Google Play, e.g. flashlight. Used in Search mode." }, "packageIds": { "title": "Package ids", "type": "array", "description": "Google Play package names, e.g. com.spotify.music (the id= part of an app link). Used for app details and data safety; each package name gets its own row limit.", "items": { "type": "string" } }, "detailUrls": { "title": "Detail URLs", "type": "array", "description": "Google Play app links, e.g. https://play.google.com/store/apps/details?id=com.spotify.music. Each link gets its own row limit.", "items": { "type": "string" } }, "developerId": { "title": "Developer id", "type": "string", "description": "Numeric ID from a Google Play developer link such as /store/apps/dev?id=5700313618786177705. Name-form links under /store/apps/developer are not supported for this input." }, "category": { "title": "Category CODE", "enum": [ "GAME", "SPORTS", "TRAVEL_AND_LOCAL", "FAMILY", "VIDEO_PLAYERS", "WEATHER", "FOOD_AND_DRINK", "EDUCATION", "COMICS", "BOOKS_AND_REFERENCE", "SOCIAL", "LIFESTYLE", "ENTERTAINMENT", "PHOTOGRAPHY", "PRODUCTIVITY", "SHOPPING", "ART_AND_DESIGN", "AUTO_AND_VEHICLES", "BEAUTY", "BUSINESS", "COMMUNICATION", "DATING", "EVENTS", "FINANCE", "HEALTH_AND_FITNESS", "HOUSE_AND_HOME", "LIBRARIES_AND_DEMO", "MAPS_AND_NAVIGATION", "MEDICAL", "MUSIC_AND_AUDIO", "NEWS_AND_MAGAZINES", "PARENTING", "PERSONALIZATION", "TOOLS", "ANDROID_WEAR", "APPLICATION", "WATCH_FACE", "FAMILY_ACTION", "FAMILY_CREATE", "FAMILY_EDUCATION", "GAME_ACTION", "GAME_ADVENTURE", "GAME_ARCADE", "GAME_BOARD", "GAME_CASUAL", "GAME_EDUCATIONAL", "GAME_SIMULATION", "GAME_STRATEGY", "GAME_RACING", "GAME_ROLE_PLAYING", "GAME_CASINO", "GAME_CARD", "GAME_MUSIC", "GAME_PUZZLE", "GAME_SPORTS", "GAME_TRIVIA", "GAME_WORD" ], "type": "string", "description": "Choose a Google Play category code, such as GAME, APPLICATION or WATCH_FACE. Some category shelves are empty; this mode does not collect Top Free, Top Paid or Top Grossing charts." }, "age": { "title": "FAMILY age range", "enum": [ "AGE_RANGE1", "AGE_RANGE2", "AGE_RANGE3" ], "type": "string", "description": "Optional FAMILY age filter: AGE_RANGE1 for ages 5 and under, AGE_RANGE2 for ages 6–8, or AGE_RANGE3 for ages 9 and over. Availability varies by storefront." }, "c": { "title": "Search catalog", "enum": [ "apps", "games" ], "type": "string", "description": "Use apps for keyword searches, including searches for games. The games catalog is not supported; use category GAME to browse games.", "default": "apps" }, "maxResults": { "title": "Max rows per query, category, developer, or app input", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Most app and review rows for each search query, category, developer, package ID, or detail URL (1–1,000). Default 70; larger numbers are collected in parts of 70. All row types count together. The whole run stops at your maximum total charge. Free Apify plan: up to 200 rows per run and 10 runs of this Actor.", "default": 70 }, "market": { "title": "Market preset", "enum": [ "us", "ph", "gb", "au", "jp", "tw", "de", "fr", "in", "br", "ca", "sg", "ae", "ag", "ai", "al", "am", "ao", "ar", "at", "az", "ba", "bb", "bd", "be", "bf", "bg", "bh", "bj", "bm", "bn", "bo", "bs", "bt", "bw", "by", "bz", "cd", "cf", "cg", "ch", "ci", "cl", "cm", "co", "cr", "cv", "cy", "cz", "dk", "dm", "do", "dz", "ec", "ee", "eg", "es", "et", "fi", "fj", "fm", "ga", "gd", "ge", "gh", "gm", "gn", "gq", "gr", "gt", "gw", "gy", "hk", "hn", "hr", "ht", "hu", "id", "ie", "il", "iq", "is", "it", "jm", "jo", "ke", "kg", "kh", "km", "kn", "kr", "kw", "ky", "kz", "la", "lb", "lc", "li", "lk", "lr", "ls", "lt", "lu", "lv", "ly", "ma", "md", "me", "mg", "mk", "ml", "mm", "mn", "mo", "mr", "mt", "mu", "mv", "mw", "mx", "my", "mz", "na", "ne", "ng", "ni", "nl", "no", "np", "nz", "om", "pa", "pe", "pg", "pk", "pl", "pr", "ps", "pt", "py", "qa", "ro", "rs", "ru", "rw", "sa", "sb", "sc", "se", "si", "sk", "sl", "sn", "so", "sr", "sv", "sz", "tc", "td", "tg", "th", "tj", "tm", "tn", "to", "tr", "tt", "tz", "ua", "ug", "uy", "uz", "vc", "ve", "vg", "vi", "vn", "vu", "ws", "ye", "za", "zm", "zw" ], "type": "string", "description": "Choose one of 183 Google Play country presets. Set hl or gl to override the preset language or country; app availability varies by market.", "default": "us" }, "hl": { "title": "Language (hl)", "pattern": "^[A-Za-z]{2,3}([-_][A-Za-z0-9]{2,8})*$", "type": "string", "description": "Language code such as en, de or pt-BR. Overrides the language selected by market." }, "gl": { "title": "Country (gl)", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter country code such as US or DE. Overrides the country selected by market; countries outside the presets are not verified." }, "enrichDetails": { "title": "Detail page for every row (always on)", "type": "boolean", "description": "Every app row is built from its details page, so support email, developer phone, website, address, privacy URL, price and rating are filled when the app lists them. Kept for compatibility: turning it off does not change the rows.", "default": true }, "includeDataSafety": { "title": "Include data-safety summary", "type": "boolean", "description": "Attach the app developer's public data-safety declarations to each app row when available. This is a summary, not an independent assessment of the app.", "default": false }, "includeReviews": { "title": "Include review rows", "type": "boolean", "description": "Add public reviews as separate billed rows, including review text, rating and available author details. App and review rows share each input's maxResults limit; off by default.", "default": false }, "includeSimilar": { "title": "Include similar apps", "type": "boolean", "description": "Attach similarApps recommendations and moreByDeveloper lists to each app row when available. These lists are not separate billed rows; off by default.", "default": false }, "workerBaseUrl": { "title": "Developer testing setting", "type": "string", "description": "Leave empty. Used only by the developer for testing." } } }, "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 } } } } } } } } } }