| Mix app, search, and developer URLs with a keyword in one run, in the store country and language you choose, and get 50+ fields per app, full developer portfolios, and reviews 150 per page, nested under each app or as one record per review. |
play.google.com/store/apps/details?id=com.instagram.android), search pages (play.google.com/store/search?q=workout\&c=apps), developer pages (play.google.com/store/apps/developer?id=Supercell), bare app IDs (com.instagram.android) or numeric developer IDs. hl and gl in a URL override the language and country for that entry. Category and top-chart pages aren't supported.
## `search` (type: `string`):
Enter a keyword to search Google Play apps, e.g. habit tracker. Runs as its own query next to any URLs. Google Play shows about 30 apps per search.
## `price` (type: `string`):
Only return free or paid apps in search results.
## `country` (type: `string`):
Two-letter country code of the Google Play store, e.g. US, GB, DE. Sets prices, availability and reviews. A gl parameter on a URL overrides it for that entry.
## `lang` (type: `string`):
Language of app texts, e.g. en, de, pt-BR. An hl parameter on a URL overrides it for that entry.
## `includeReviews` (type: `boolean`):
Attach reviews to every app in a reviewsList array. Set Max review pages per app too, or every app pages through all of its reviews.
## `onlyIncludeReviews` (type: `boolean`):
Save each review as its own dataset record and skip the app record. Implies Include reviews. Use it for apps with more than about 20,000 reviews.
## `reviewsSort` (type: `string`):
Order of the reviews.
## `maxReviewPages` (type: `integer`):
Review pages to fetch per app, up to 150 reviews each. Leave empty to fetch every page.
## `maxItems` (type: `integer`):
Maximum number of records saved across all queries. Nested reviews belong to their app's record and don't count; with Only output reviews, each review counts. Leave empty for no limit.
## `customMapFunction` (type: `string`):
Optional JavaScript function that reshapes each record before it is saved, e.g. (object) => ({ appId: object.appId, title: object.title, score: object.score }). With Include reviews it receives the app before reviewsList is attached. If it throws, the original record is saved.
## `outputConnector` (type: `string`):
Optional MCP connector to deliver the results to. Authorize it first in Apify Console β Settings β API & Integrations β MCP connectors.
## `deliverTarget` (type: `string`):
URL or ID of where the connector writes. Notion: a page URL (a typed database is created for you) or an existing database URL. Todoist: a project URL or ID. Some services need none.
## `deliverMode` (type: `string`):
perPost writes one record per app or review; summary writes a single roll-up for the run.
## `deliverMaxItems` (type: `integer`):
Optional cap on how many records perPost delivers (ignored in summary mode).
## Actor input object example
```json
{
"startUrls": [
"https://play.google.com/store/apps/details?id=com.instagram.android"
],
"search": "habit tracker",
"price": "all",
"country": "US",
"lang": "en",
"includeReviews": false,
"onlyIncludeReviews": false,
"reviewsSort": "NEWEST",
"maxItems": 1000,
"deliverMode": "perPost"
}
```
# Actor output Schema
## `dataset` (type: `string`):
No description
# 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 '