# Google Play Apps Search Scraper (`dt_org/dreemteam-google-play-apps`) Actor Extract ranked Google Play app search results with app IDs, ratings, installs, developers, categories, icons, descriptions, and displayed paid prices. - **URL**: https://apify.com/dt\_org/dreemteam-google-play-apps.md - **Developed by:** [DreamTeam](https://apify.com/dt_org) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.30 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Google Play Apps Search Scraper Google Play Apps Search Scraper turns Google Play keyword searches into clean, ranked app datasets for ASO research, competitor tracking, category analysis, and mobile app market research. Enter one or more keywords such as `fitness`, `vpn`, `meditation`, `photo editor`, or `budget planner`. The Actor returns one app per dataset row with the keyword, rank, app title, package ID, Google Play URL, rating, install band, developer, developer page, category, icon, description, and displayed paid price when Google Play shows one. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Google or Google Play. ### Use Cases - Track Google Play keyword rankings for ASO research. - Discover competing apps across mobile niches. - Build developer and category lead lists from live search results. - Compare ratings, install bands, titles, descriptions, categories, and visible paid prices across keywords. - Export structured app search data to spreadsheets, dashboards, databases, or BI tools. ### How It Works Provide a list of Google Play search keywords and choose how many ranked app results to collect per keyword. The Actor keeps the original keyword on every row, so you can compare the same app across multiple searches and see where it appeared. Good starter keywords: - `fitness` - `vpn` - `meditation` - `photo editor` - `budget planner` ### Input - `queries` - Google Play keywords to search. - `maxQueries` - maximum number of keywords processed from your list. - `maxResultsPerQuery` - maximum ranked app rows saved for each keyword. - `deduplicate` - removes repeated app rows within the same keyword while still keeping the same app when it ranks for different keywords. ### Example Input ```json { "queries": ["fitness"], "maxQueries": 10, "maxResultsPerQuery": 3, "deduplicate": true } ```` ### More Examples #### VPN Competitor Scan ```json { "queries": ["vpn"], "maxQueries": 1, "maxResultsPerQuery": 25, "deduplicate": true } ``` #### Multi-Keyword ASO Check ```json { "queries": ["fitness", "home workout", "calorie tracker"], "maxQueries": 3, "maxResultsPerQuery": 20, "deduplicate": true } ``` #### Paid App Price Scan ```json { "queries": ["paid games", "monument valley"], "maxQueries": 2, "maxResultsPerQuery": 10, "deduplicate": true } ``` ### Output Each dataset row represents one ranked Google Play app search result. Key fields: - `query` - keyword that produced the app row. - `rank` - app position in the collected results for that keyword. - `title` - app title. - `appId` - Android package ID parsed from the Google Play URL. - `appUrl` - public Google Play app URL. - `rating` - displayed rating. - `iconUrl` - app icon image URL. - `installsText` - displayed install band, for example `100,000,000+`. - `installsMin` - numeric lower bound parsed from the install band. - `developerName` - displayed developer name. - `developerUrl` - public Google Play developer page. - `priceText` - displayed paid app price, or `null` when no paid price is shown in the search row. - `priceAmount` - numeric price amount parsed from `priceText`. - `priceCurrency` - currency symbol or code parsed from `priceText`. - `descriptionText` - clean app description text. - `category` - displayed Google Play category. - `source` - source label for downstream filtering. - `collectedAt` - UTC collection timestamp. The key-value store `OUTPUT` object contains run status, counts, warnings, and errors. ### Result Counting Each app search result is written as one dataset row. Status summaries, no-result messages, errors, and quota-limit outcomes are reported in `OUTPUT` and do not create extra dataset rows. ### Tips Start with a few focused keywords, review the ranking and field coverage, then expand the keyword list. For ASO monitoring, run the same keyword set on a schedule and compare rank movement, new entrants, rating changes, and category mix over time. # Actor input Schema ## `queries` (type: `array`): Google Play search keywords to collect app rankings for, such as fitness, vpn, meditation, photo editor, or budget planner. ## `maxQueries` (type: `integer`): Maximum number of keywords processed from the list. ## `maxResultsPerQuery` (type: `integer`): Maximum number of Google Play app search results saved for each keyword. ## `deduplicate` (type: `boolean`): Remove repeated app rows within the same keyword while keeping the same app when it appears for different keywords. ## Actor input object example ```json { "queries": [ "fitness" ], "maxQueries": 10, "maxResultsPerQuery": 3, "deduplicate": true } ``` # Actor output Schema ## `results` (type: `string`): Dataset rows produced by this Actor. ## `summary` (type: `string`): Structured run status, counts, quota status, warnings, and errors. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("dt_org/dreemteam-google-play-apps").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("dt_org/dreemteam-google-play-apps").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call dt_org/dreemteam-google-play-apps --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dt_org/dreemteam-google-play-apps", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Play Apps Search Scraper", "description": "Extract ranked Google Play app search results with app IDs, ratings, installs, developers, categories, icons, descriptions, and displayed paid prices.", "version": "0.1", "x-build-id": "SqsjmgjIuIB3lxpKq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dt_org~dreemteam-google-play-apps/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dt_org-dreemteam-google-play-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/dt_org~dreemteam-google-play-apps/runs": { "post": { "operationId": "runs-sync-dt_org-dreemteam-google-play-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/dt_org~dreemteam-google-play-apps/run-sync": { "post": { "operationId": "run-sync-dt_org-dreemteam-google-play-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": { "queries": { "title": "Search Keywords", "type": "array", "description": "Google Play search keywords to collect app rankings for, such as fitness, vpn, meditation, photo editor, or budget planner.", "items": { "type": "string" }, "default": [ "fitness" ] }, "maxQueries": { "title": "Max Keywords", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of keywords processed from the list.", "default": 10 }, "maxResultsPerQuery": { "title": "Max App Results Per Keyword", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of Google Play app search results saved for each keyword.", "default": 3 }, "deduplicate": { "title": "Deduplicate Results", "type": "boolean", "description": "Remove repeated app rows within the same keyword while keeping the same app when it appears for different keywords.", "default": true } } }, "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 } } } } } } } } } } ```