# App Store & Google Play Scraper – Apps, Reviews, Search, Charts (`pulsedata/app-store-google-play-scraper`) Actor

Scrape Google Play and the Apple App Store in one actor: full app details (ratings, installs, price, developer, version, screenshots), reviews with replies, keyword search results, top charts by category & country, and developer portfolios. Fast, no proxies needed.

- **URL**: https://apify.com/pulsedata/app-store-google-play-scraper.md
- **Developed by:** [PulseData](https://apify.com/pulsedata) (community)
- **Categories:** E-commerce, Business, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 app scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## App Store & Google Play Scraper – Apps, Reviews, Search, Top Charts

One actor for **both mobile app stores**. Get full app details, user reviews (with developer replies), keyword search results, top charts per category and country, and every app of a developer – from **Google Play** and the **Apple App Store** – as clean JSON/CSV.

- **App details**: title, description, developer (+ email/website/address on Google Play), rating, number of ratings, rating histogram, installs, price/currency, in-app purchases, ads, content rating, version, release/update dates, what's new, icon, screenshots, video, required OS, size, languages, privacy policy.
- **Reviews**: reviewer name, score, title, text, date, app version, thumbs up, developer reply & date (Google Play), per-criteria ratings, storefront country (App Store). Newest first, by rating or most helpful.
- **Search**: apps ranking for any keyword in any country/language – ASO keyword research.
- **Top charts**: top free / paid / grossing / new, per category, per country.
- **Developer portfolios**: all apps of a publisher.

No proxies or login required. Fast and cheap: **$1 per 1,000 apps, $0.20 per 1,000 reviews.**

### Input examples

Apps + reviews:

```json
{
  "apps": [
    "https://play.google.com/store/apps/details?id=com.spotify.music",
    "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580"
  ],
  "country": "us", "language": "en",
  "includeReviews": true, "maxReviewsPerApp": 500, "reviewsSort": "newest",
  "reviewsCountries": ["us", "gb", "de"]
}
```

Keyword research (ASO):

```json
{ "searchTerms": ["meditation", "sleep sounds"], "stores": "both", "maxSearchResults": 100, "country": "de", "language": "de", "includeAppDetails": true, "includeReviews": false }
```

Top charts:

```json
{ "topCharts": [ { "collection": "TOP_FREE", "category": "HEALTH_AND_FITNESS", "num": 100 }, { "collection": "GROSSING", "num": 50 } ], "country": "us" }
```

Google Play category IDs: `APPLICATION`, `GAME`, `BUSINESS`, `EDUCATION`, `FINANCE`, `HEALTH_AND_FITNESS`, `SHOPPING`, `TOOLS`, `GAME_ACTION`, … App Store genres: `GAMES`, `BUSINESS`, `EDUCATION`, `FINANCE`, `HEALTH_AND_FITNESS`, `SHOPPING`, `UTILITIES`, `GAMES_ACTION`, … (or numeric genre IDs).

### Output

Items have a `type` of `app` or `review` (use the dataset views or filter by `type`).

```json
{
  "type": "app", "store": "google-play", "appId": "com.spotify.music",
  "title": "Spotify: Music and Podcasts", "developer": "Spotify AB", "developerEmail": "android-support@spotify.com",
  "score": 4.34, "ratings": 32994517, "histogram": { "1": 2193010, "2": 703640, "3": 1246120, "4": 2937350, "5": 25915000 },
  "installs": "1,000,000,000+", "minInstalls": 1000000000, "price": 0, "free": true, "offersIAP": true, "adSupported": true,
  "genre": "Music & Audio", "contentRating": "Teen", "version": "VARY", "updated": "2026-08-18T06:18:15.000Z",
  "url": "https://play.google.com/store/apps/details?id=com.spotify.music&hl=en&gl=us"
}
```

```json
{
  "type": "review", "store": "app-store", "appId": "324684580", "reviewId": "14442249531",
  "userName": "Cooler spiel das beste", "score": 3, "title": "Danke für die Antwort", "text": "…",
  "date": "2026-08-18T10:25:03.000Z", "version": "9.1.74", "country": "de"
}
```

### Use cases

- **ASO & market research** – keyword rankings, competitor ratings, category leaders, pricing.
- **Review mining & sentiment analysis** – export thousands of reviews to spot bugs, feature requests and trends; feed them to an LLM.
- **Competitor monitoring** – schedule daily runs and diff versions, ratings and reviews.
- **Lead generation** – developer contact emails and websites from Google Play listings.
- **Academic datasets** – app metadata at scale.

### Notes

- Google Play reviews can be paged essentially without limit; the App Store exposes the most recent ~500 reviews per storefront – list several `reviewsCountries` to collect more.
- Store content depends on `country`/`language` – set them to match the market you research.
- Built on the well-maintained open-source libraries `google-play-scraper` and `app-store-scraper`.

### Pricing

Pay per event: **$0.001 per app** and **$0.0002 per review**. Nothing else.

### Ready-made report from this actor

Skip the setup: **[App-Market Intelligence — US Top Charts 2026](https://pulsdata.gumroad.com/l/app-market-us-2026/LAUNCH)** — 840 top-chart apps from both stores analysed (publisher concentration, category benchmarks, monetization, app age) as a PDF report + full CSV dataset, built with this exact actor (launch discount applied at the link).

### Integrations

Schedule, run via API/SDK, export JSON/CSV/Excel, send to Google Sheets, Make, Zapier, n8n, Airtable; usable as an MCP tool by AI agents.

# Actor input Schema

## `apps` (type: `array`):

App store URLs or IDs, one per line. Google Play: `https://play.google.com/store/apps/details?id=com.spotify.music` or `com.spotify.music`. App Store: `https://apps.apple.com/us/app/spotify/id324684580`, `id324684580` or `324684580`.

## `searchTerms` (type: `array`):

Keywords to search in the stores (e.g. `meditation`, `budget planner`). Results are scraped as apps.

## `stores` (type: `string`):

Which store(s) to use for keyword search, top charts and developer listings.

## `maxSearchResults` (type: `integer`):

Up to 250 for Google Play, 200 for the App Store.

## `topCharts` (type: `array`):

Scrape top chart lists. Each item: `{"collection": "TOP_FREE"|"TOP_PAID"|"GROSSING"|"NEW_FREE"|"NEW_PAID", "category": "GAME"|"HEALTH_AND_FITNESS"|... (Google Play category id or App Store genre name/id, optional), "num": 100}`.

## `developers` (type: `array`):

Developer IDs/names or developer page URLs to list all their apps (e.g. `Spotify AB`, `https://play.google.com/store/apps/dev?id=...`, `https://apps.apple.com/us/developer/spotify/id324684583`).

## `country` (type: `string`):

Two-letter store country code (us, gb, de, fr, in, br, …). Affects availability, prices, charts and reviews.

## `language` (type: `string`):

Language code for Google Play content and reviews (en, de, fr, es, …).

## `includeAppDetails` (type: `boolean`):

For apps found via search, charts or developers, fetch the full detail page (description, installs, ratings histogram, version, permissions…). Off = only the list data.

## `includeReviews` (type: `boolean`):

Scrape reviews for every app (from the `apps` list, and from search/charts/developers if enabled below).

## `reviewsForDiscoveredApps` (type: `boolean`):

By default reviews are only scraped for the apps you list explicitly. Enable to also scrape reviews for apps discovered via search, top charts or developer pages.

## `maxReviewsPerApp` (type: `integer`):

0 = all available (Google Play allows tens of thousands; App Store exposes the latest ~500 per country).

## `reviewsSort` (type: `string`):

Order in which reviews are collected (newest first, by rating, or most helpful).

## `reviewsCountries` (type: `array`):

App Store reviews are per country. List several codes to collect reviews from multiple storefronts (e.g. us, gb, de). Defaults to the main country.

## `includePermissions` (type: `boolean`):

Adds the list of Android permissions and the Data Safety section to Google Play app items (two extra requests per app).

## `proxyConfiguration` (type: `object`):

Usually not needed. Enable Apify Proxy if you run very large volumes.

## Actor input object example

```json
{
  "apps": [
    "https://play.google.com/store/apps/details?id=com.spotify.music",
    "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580"
  ],
  "searchTerms": [],
  "stores": "both",
  "maxSearchResults": 50,
  "topCharts": [],
  "developers": [],
  "country": "us",
  "language": "en",
  "includeAppDetails": true,
  "includeReviews": true,
  "reviewsForDiscoveredApps": false,
  "maxReviewsPerApp": 100,
  "reviewsSort": "newest",
  "reviewsCountries": [],
  "includePermissions": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

Apps and reviews stored in the default dataset (JSON/CSV/Excel via the dataset API).

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "apps": [
        "https://play.google.com/store/apps/details?id=com.spotify.music",
        "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pulsedata/app-store-google-play-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "apps": [
        "https://play.google.com/store/apps/details?id=com.spotify.music",
        "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("pulsedata/app-store-google-play-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "apps": [
    "https://play.google.com/store/apps/details?id=com.spotify.music",
    "https://apps.apple.com/us/app/spotify-music-and-podcasts/id324684580"
  ]
}' |
apify call pulsedata/app-store-google-play-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pulsedata/app-store-google-play-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/3ZLOLBtpCctdfsWC4/builds/uI2vEgxQZJ4ZDzXIZ/openapi.json