# Google Play Store App Search Scraper (`fetch_cat/google-play-store-app-search-scraper`) Actor Export ranked public Google Play app search results by keyword, country, and language for ASO and competitor monitoring. - **URL**: https://apify.com/fetch\_cat/google-play-store-app-search-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Marketing, Business, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.30 / 1,000 item processeds 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Store App Search Scraper Export ranked public Google Play app search results by keyword, country, and language for ASO research, competitor monitoring, and app-market analysis. Enter up to 20 search terms and receive one dataset row per visible app result. The Actor works without a Google account, preserves the query and rank for every app, and can be scheduled or called through the Apify API and official Apify MCP server. ### What data can you export? - Android package ID, app title, developer, icon, and canonical Google Play URL - Search keyword and one-based result position - Visible rating, rating/review count, price text, and free-download status - Requested country and language plus the exact localized search URL - Collection timestamp - A `RUN_SUMMARY` with completed, failed, and pending queries - A `PENDING_WORK` checkpoint when a larger run reaches its safe runtime limit Google Play search cards do not expose every app-detail field in every layout. `installRange`, `category`, and other unavailable values are returned as `null` rather than guessed. ### Input example ```json { "searchQueries": ["meditation", "budget tracker"], "country": "US", "language": "en", "maxItemsPerQuery": 10 } ```` ### Output example ```json { "searchQuery": "meditation", "position": 1, "appId": "com.calm.android", "appTitle": "Calm - Sleep, Meditate, Relax", "developer": "Calm.com, Inc.", "rating": 4.4, "ratingCount": null, "installRange": null, "priceText": "In-app purchases", "isFree": true, "category": null, "detailUrl": "https://play.google.com/store/apps/details?id=com.calm.android", "iconUrl": "https://play-lh.googleusercontent.com/...", "country": "US", "language": "en", "sourceUrl": "https://play.google.com/store/search?q=meditation&c=apps&hl=en&gl=US", "scrapedAt": "2026-07-20T12:00:00.000Z" } ``` ### Input settings | Setting | JSON key | Description | |---|---|---| | Search queries | `searchQueries` | Required list of 1-20 keyword strings. Each query can contain up to 200 characters. | | Maximum apps per query | `maxItemsPerQuery` | Number of visible results to save per query, from 1 to 100. Default: `10`. | | Country | `country` | Two-letter country code such as `US`, `GB`, `DE`, or `IN`. Default: `US`. | | Language | `language` | Language code such as `en`, `es`, `de`, `fr`, or `pt-BR`. Default: `en`. | | Safe runtime limit | `maxRuntimeSecs` | Runtime budget from 35 to 270 seconds. The default `240` leaves time to save progress before shutdown. | Existing inputs that omit `maxRuntimeSecs` continue to use the default. ### Output fields | Field | Description | |---|---| | `searchQuery` | Keyword that produced the result. | | `position` | One-based position within the returned results for that query. | | `appId` | Android package identifier. | | `appTitle` | Public app name. | | `developer` | Developer shown on the search card, or `null`. | | `rating` | Visible average star rating, or `null`. | | `ratingCount` | Visible compact rating/review count, or `null`. | | `installRange` | Visible install/download range when present on the search card, otherwise `null`. | | `priceText` | Visible price or purchase label, or `null`. | | `isFree` | Whether the download is shown as free, or `null` when not determinable. In-app purchases do not make a free download paid. | | `category` | Visible category when present on the search card, otherwise `null`. | | `detailUrl` | Canonical public Google Play app URL. | | `iconUrl` | Public app icon URL, or `null`. | | `country` | Country code used for the search. | | `language` | Language code used for the search. | | `sourceUrl` | Localized public search URL used for the result. | | `scrapedAt` | ISO 8601 collection timestamp. | The default key-value store also exposes `RUN_SUMMARY`. If the safe runtime limit interrupts a larger workload, `PENDING_WORK` records the exact query and apps already saved so an Apify run resurrection can continue without duplicating them. ### Who is this for? - **ASO teams:** capture keyword rankings across countries and languages. - **App publishers:** identify competing Android apps returned for product terms. - **Agencies:** build recurring app-visibility reports for clients. - **Market researchers:** create localized lists of app IDs, developers, ratings, and listing URLs. - **Developers and data teams:** export results to CSV, Excel, JSON, API pipelines, warehouses, or agents. ### Search recipes - **US meditation competitors:** `{"searchQueries":["meditation"],"country":"US","language":"en","maxItemsPerQuery":10}` - **UK budgeting apps:** `{"searchQueries":["budget tracker"],"country":"GB","language":"en","maxItemsPerQuery":10}` - **German fitness results:** `{"searchQueries":["fitness tracker"],"country":"DE","language":"de","maxItemsPerQuery":20}` - **Multi-keyword snapshot:** add several related terms to `searchQueries`; each row retains its originating query. ### Pricing This Actor uses pay-per-event pricing. A run charges the `start` event once at **$0.005**, then the `item` event only for each app row successfully saved to the dataset. Resurrecting that same checkpointed run does not repeat the start charge. Failed queries, warnings, `RUN_SUMMARY`, and `PENDING_WORK` are not charged as items. | Apify tier | Price per saved app | Price per 1,000 saved apps | |---|---:|---:| | Free | $0.000575 | $0.575 | | Starter / Bronze | $0.000500 | $0.500 | | Scale / Silver | $0.000390 | $0.390 | | Business / Gold | $0.000300 | $0.300 | | Platinum | $0.000200 | $0.200 | | Diamond | $0.000140 | $0.140 | Add the $0.005 start event to those result costs. For example, 10 saved apps on the Free tier cost about **$0.01075** in Actor events. Apify platform usage for compute, storage, and data transfer may be billed separately; the run Pricing tab is authoritative. ### Tips for better results - Start with one specific keyword and 5-10 results before scaling. - Use matching country and language values when comparing localized rankings. - Schedule separate tasks per market so country-specific snapshots remain easy to compare. - Check `RUN_SUMMARY` when a run returns fewer rows than expected; it distinguishes query failures from safe-runtime cutoff. - Resurrect an interrupted run with the same input to continue from `PENDING_WORK`. ### Limits and practical notes - The Actor covers the public Google Play `/store/search` surface only. It does not fetch app-detail pages, reviews, charts, collections, developer catalogs, or private data. - It does not log in, accept cookies, solve CAPTCHAs, use private endpoints, or attempt stealth bypasses. - Google Play can vary results by country, language, time, and user context, so ranks are snapshots rather than permanent positions. - Search cards expose fewer fields than app-detail pages. Missing values remain `null`. - Temporary rate limits and source error pages are retried within a bounded run budget. One failed query does not discard valid rows from other queries. - A query that unexpectedly produces no parseable apps is reported as a failure instead of a misleading successful-empty result. ### API usage #### Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('fetch_cat/google-play-store-app-search-scraper').call({ searchQueries: ['meditation'], country: 'US', language: 'en', maxItemsPerQuery: 10, }); console.log(run.defaultDatasetId); ``` #### Python ```python import os from apify_client import ApifyClient client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('fetch_cat/google-play-store-app-search-scraper').call(run_input={ 'searchQueries': ['meditation'], 'country': 'US', 'language': 'en', 'maxItemsPerQuery': 10, }) print(run['defaultDatasetId']) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~google-play-store-app-search-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"searchQueries":["meditation"],"country":"US","language":"en","maxItemsPerQuery":10}' ``` ### MCP and AI agents Use the official Apify MCP server. The general endpoint, `https://mcp.apify.com`, can search and run Actors. This focused endpoint exposes only this Actor: ```text https://mcp.apify.com?tools=fetch_cat/google-play-store-app-search-scraper ``` Claude Code: ```bash claude mcp add --transport http apify-google-play-search 'https://mcp.apify.com?tools=fetch_cat/google-play-store-app-search-scraper' ``` Claude Desktop, Cursor, or another MCP client: ```json { "mcpServers": { "apify-google-play-search": { "url": "https://mcp.apify.com?tools=fetch_cat/google-play-store-app-search-scraper" } } } ``` Example prompts: - "Find the top 10 meditation apps in the US and return app IDs, rank, developer, and rating." - "Run separate German and UK searches for fitness tracker apps and compare the top results." - "Create a CSV-ready competitor list for budget tracker and expense manager keywords." ### Schedule Google Play keyword monitoring Save one task per market, then use an Apify schedule to run it daily or weekly. Export each dataset to Google Sheets or a warehouse, or attach a webhook that notifies your workflow when the run finishes. Compare `appId` and `position` across snapshots to detect new competitors and ranking changes. ### Related Actors - [Google Play Apps Scraper](https://apify.com/fetch_cat/google-play-apps-scraper) for search plus direct app-detail enrichment - [Google Play Reviews Scraper](https://apify.com/fetch_cat/google-play-reviews-scraper) for public Android review analysis - [Apple App Store Reviews Scraper](https://apify.com/fetch_cat/apple-app-store-reviews-scraper) for iOS reviews and ratings - [Google Trends Scraper](https://apify.com/fetch_cat/google-trends-scraper) for broader search-demand monitoring - [Google Ads Transparency Center Scraper](https://apify.com/fetch_cat/google-ads-transparency-scraper) for competitor advertising research ### FAQ #### Is this a Google Play Search API alternative? It provides a structured API workflow for public Google Play search results, but it is not an official Google API and does not provide private account data or every app-detail field. #### Can I export results to CSV, Excel, or JSON? Yes. Apify datasets support CSV, Excel, JSON, JSONL, XML, RSS, and HTML exports, plus API access. #### Does it require a Google account, cookies, or a token? No. It reads public search pages without Google login credentials or cookies. You still need an Apify token when calling the Actor through the API. #### Can I search multiple keywords? Yes. Add up to 20 strings to `searchQueries`. `maxItemsPerQuery` applies separately to each query. #### Can I compare countries and languages in one run? One run uses one country and language pair. Use separate runs or saved tasks for clean market comparisons. #### Why are installs, category, or counts sometimes null? The public search card does not consistently expose those fields. This search-only Actor returns `null` instead of opening app-detail pages or inventing values. #### What happens if one keyword fails? Valid results from other keywords remain in the dataset. `RUN_SUMMARY` records the failed query and cause. The run fails when no app rows can be saved at all. #### Is collecting public app search data legal? The Actor collects publicly visible search information. Your use of the data must comply with applicable laws, Google Play terms, privacy obligations, and your organizationโ€™s policies. ### Support If a run fails, returns no data, or a field looks wrong, open an issue or report a bug from the Actor page. Include the Apify run ID or run URL, input JSON, expected output, actual output, and one reproducible public URL, such as the corresponding Google Play search URL. Small, public examples make localization or source-layout problems faster to diagnose. # Actor input Schema ## `searchQueries` (type: `array`): Keywords to search on Google Play. ## `maxItemsPerQuery` (type: `integer`): Maximum number of app search results to save for each query. ## `country` (type: `string`): Two-letter Google Play country code, for example US, GB, DE, or IN. ## `language` (type: `string`): Google Play interface language, for example en, es, de, or fr. ## `maxRuntimeSecs` (type: `integer`): Maximum run time in seconds. The Actor stops accepting new work early enough to save a resumable checkpoint. Leave empty to use 240 seconds. ## Actor input object example ```json { "searchQueries": [ "notion", "fitness tracker" ], "maxItemsPerQuery": 10, "country": "US", "language": "en" } ``` # Actor output Schema ## `results` (type: `string`): Ranked app result rows from the requested Google Play searches. ## `runSummary` (type: `string`): Run status, completed and pending queries, warnings, and per-query failures. ## `pendingWork` (type: `string`): Resumable progress saved when the safe runtime limit interrupts a larger run. # 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 = { "searchQueries": [ "notion", "fitness tracker" ] }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/google-play-store-app-search-scraper").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 = { "searchQueries": [ "notion", "fitness tracker", ] } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/google-play-store-app-search-scraper").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 '{ "searchQueries": [ "notion", "fitness tracker" ] }' | apify call fetch_cat/google-play-store-app-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/google-play-store-app-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Play Store App Search Scraper", "description": "Export ranked public Google Play app search results by keyword, country, and language for ASO and competitor monitoring.", "version": "0.1", "x-build-id": "FasiNgxMBfg1JtRHh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~google-play-store-app-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-google-play-store-app-search-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/fetch_cat~google-play-store-app-search-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-google-play-store-app-search-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/fetch_cat~google-play-store-app-search-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-google-play-store-app-search-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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search queries", "minItems": 1, "maxItems": 20, "type": "array", "description": "Keywords to search on Google Play.", "items": { "type": "string", "minLength": 1, "maxLength": 200 } }, "maxItemsPerQuery": { "title": "Maximum apps per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of app search results to save for each query.", "default": 10 }, "country": { "title": "Country", "type": "string", "description": "Two-letter Google Play country code, for example US, GB, DE, or IN.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Google Play interface language, for example en, es, de, or fr.", "default": "en" }, "maxRuntimeSecs": { "title": "Safe runtime limit", "minimum": 35, "maximum": 270, "type": "integer", "description": "Maximum run time in seconds. The Actor stops accepting new work early enough to save a resumable checkpoint. Leave empty to use 240 seconds." } } }, "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 } } } } } } } } } } ```