# Google Play Scraper - App Details, Developer & Similar Apps (`appdata-labs/google-play-scraper`) Actor

One Google Play scraper for four jobs: full app details by package name or URL, every app a developer publishes, the similar apps Google Play shows next to an app, and the apps in any category. Installs, ratings, prices and developer contact, as compact JSON for AI agents.

- **URL**: https://apify.com/appdata-labs/google-play-scraper.md
- **Developed by:** [Kobkoon Janngam](https://apify.com/appdata-labs) (community)
- **Categories:** Agents, MCP servers, Developer tools
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 app returneds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Play Scraper — App Details, Developer Catalogue, Similar Apps and Categories

**One Google Play scraper for four jobs:** the full listing of any Android app, every app a developer publishes, the apps Google Play shows as similar to an app, and the apps in a category.
**It is for** app marketers, mobile market researchers, B2B sales teams building lead lists of app companies, and AI agents that need Google Play data in one tool call.
**Quick start:** press **Start** with no configuration. Details mode reads ten well-known apps (Spotify, Duolingo, Netflix, WhatsApp and six more) and returns ten rows in about 20 seconds. Then pick a `mode` and paste your own apps, developers or categories.

### Sample output

From real runs on 18 November 2026 against the US store. Ratings are rounded to two decimals here; the dataset carries Google Play's full value. Your run returns whatever the store shows that day.

**`details` mode** (the default)

| title | developer | installs | score | genre |
|---|---|---|---|---|
| Spotify: Music and Podcasts | Spotify AB | 1,000,000,000+ | 4.35 | Music & Audio |
| Duolingo: Learn Languages | Duolingo | 500,000,000+ | 4.75 | Education |
| WhatsApp | WhatsApp LLC | 10,000,000,000+ | 4.63 | Communication |
| Microsoft Teams | Microsoft Corporation | 500,000,000+ | 4.65 | Business |

**`developer` mode**, `developers: ["Netflix"]`, `includeDetails: true`

| title | developer | installs | score | developerEmail |
|---|---|---|---|---|
| Netflix | Netflix, Inc. | 1,000,000,000+ | 4.81 | playstore@netflix.com |
| Netflix Playground | Netflix, Inc. | 1,000,000+ | 4.41 | playstore@netflix.com |
| Bloons TD 6 NETFLIX | Netflix, Inc. | 5,000,000+ | 4.65 | playstore@netflix.com |

**`similar` mode**, `appUrlsOrIds: ["com.duolingo"]`

| seedTitle | rank | title | developer | score |
|---|---|---|---|---|
| Duolingo: Learn Languages | 1 | Learn to Read - Duolingo ABC | Duolingo | 3.87 |
| Duolingo: Learn Languages | 2 | Duolingo English Test (DET) | Duolingo | 2.86 |

**`category` mode**, `categories: ["FINANCE"]`

| category | categoryPosition | title | installs | developerEmail |
|---|---|---|---|---|
| FINANCE | 1 | Kalshi: Trade Sports & Events | 5,000,000+ | support@kalshi.com |
| FINANCE | 2 | Wise: International Transfers | 50,000,000+ | support@wise.com |
| FINANCE | 4 | TradingView: Track All Markets | 50,000,000+ | mobile-support@tradingview.com |

Every row starts with `mode`, then `appId`, `title`, `url`, `summary`, `developer`, `score`, `price`, `icon` and `country`. Details and category rows are the full listing: `installs`, `minInstalls`, `ratings`, `reviews`, `histogram`, `genre`, `contentRating`, `released`, `updated`, `version`, `developerEmail`, `developerWebsite`, `privacyPolicy` and more. Every row stays under 4 KB, so an agent can read a whole result without flooding its context.

### The four modes

| `mode` | Reads | You give it | You get |
|---|---|---|---|
| `details` | `appUrlsOrIds` | package names or Play URLs | one full listing per app per country |
| `developer` | `developers` | a name as you would type it ("Netflix"), the exact Play name ("Spotify AB"), a developer page URL, or any app they made | every app that publisher has on Google Play |
| `similar` | `appUrlsOrIds` | package names or Play URLs | the apps Google Play lists as similar, ranked, with the seed app on every row |
| `category` | `categories` | category IDs (`FINANCE`), store names ("Health & Fitness") or `TOP` | the apps on that category page, in page order, each with its full listing |

A bare company name is tried as typed and then with the usual company forms (", Inc.", " LLC", " AB" and others), because Google Play only answers to the exact publisher string. `SUMMARY` records which spelling worked.

Each entry is judged on its own. A typo, an unknown category or a publisher that does not exist is skipped with its reason in the log and in `SUMMARY`; the run fails, with a message that says why, only when nothing could be read.

### What it does not do

**This Actor does not search Google Play and does not read reviews.** It also does not read top charts through Google Play's internal API. Search lives at `/store/search` and reviews and charts at Google Play's internal `batchexecute` RPC, and `play.google.com/robots.txt` disallows both. We follow that. For the same reason an app *name* is not accepted in details or similar mode: turning a name into an app needs search. Use the package name, or the URL from the app's page.

### Input

| Field | Default | Notes |
|---|---|---|
| `mode` | `details` | `details`, `developer`, `similar` or `category`. |
| `appUrlsOrIds` | ten popular apps | Read in details and similar modes. |
| `developers` | `["com.netflix.mediaclient"]` | Read in developer mode. |
| `categories` | `["HEALTH_AND_FITNESS"]` | Read in category mode. A page lists roughly 30 to 90 apps. |
| `countries` | `["us"]` | Two-letter storefront codes. Each country is read separately. |
| `language` | `en` | Text language, independent of country. |
| `maxAppsPerInput` | `50` | Per developer, seed app or category, per country. Up to 200; category pages cap at 100. |
| `includeDetails` | `false` | Developer and similar modes: add installs, rating count, category, dates and the developer's published email, website and privacy policy. About 1.5 s per app. |

### Pricing

Pay per app row returned, in any mode. Entries that were skipped and apps that could not be read cost nothing. With `includeDetails` on in developer or similar mode, each app whose details were fetched adds a second, smaller charge. A run never returns more rows than the maximum charge you set covers.

The developer email and website are what each developer chose to publish on Google Play. Use them in line with the privacy and anti-spam rules that apply to you.

### Works well with

Same publisher, same output conventions, same honest-failure rules:

- [**app-store-scraper**](https://apify.com/appdata-labs/app-store-scraper) — Search with rank, details, reviews, charts and publisher catalogues in one App Store Actor.
- [**app-store-app-details**](https://apify.com/appdata-labs/app-store-app-details) — Full App Store listing for any app, or search the store by keyword.
- [**app-store-reviews**](https://apify.com/appdata-labs/app-store-reviews) — Customer reviews, filtered by stars, keyword and date — pay only for matches.
- [**app-store-top-charts**](https://apify.com/appdata-labs/app-store-top-charts) — Top free, paid and grossing charts for any country and category.
- [**app-store-developer-apps**](https://apify.com/appdata-labs/app-store-developer-apps) — Every iOS app a publisher has released, from one app or the publisher name.
- [**google-play-app-details**](https://apify.com/appdata-labs/google-play-app-details) — Full Google Play listing: installs, rating histogram, developer contact.
- [**google-play-developer-apps**](https://apify.com/appdata-labs/google-play-developer-apps) — Every Android app a publisher has released.
- [**google-play-similar-apps**](https://apify.com/appdata-labs/google-play-similar-apps) — Competitors Google Play itself shows next to an app.
- [**google-play-category-apps**](https://apify.com/appdata-labs/google-play-category-apps) — The apps in any Google Play category, with installs and developer contact.

### Disclaimer

This is an **unofficial** tool. It is not affiliated with, authorised by, endorsed by, or in
any way officially connected to Google LLC. "Google Play", "Android" and "Google" are
trademarks of Google LLC.

It reads only **public, unauthenticated** Google Play pages — the app listing
(`/store/apps/details`), the developer page (`/store/apps/developer`), the similar-apps cluster
(`/store/apps/collection/cluster`) and the category pages (`/store/apps/category/*` and
`/store/apps/top`). None of those paths are disallowed by `play.google.com/robots.txt`. It signs
into nothing, stores no credentials, and returns nothing behind a login or a paywall.

Google can change its pages at any time. When a page cannot be read, this Actor says so in the
log and in `SUMMARY` rather than handing you an empty result that looks like an answer.

# Actor input Schema

## `mode` (type: `string`):

What to fetch. "details": the full listing of each app in appUrlsOrIds. "developer": every app by each publisher in developers. "similar": the apps Google Play shows as similar to each app in appUrlsOrIds. "category": the apps listed on each Google Play category page in categories. This Actor does not search Google Play and does not read reviews.

## `appUrlsOrIds` (type: `array`):

Read in details and similar modes. Each entry is a package name (com.spotify.music) or a Google Play app URL (https://play.google.com/store/apps/details?id=com.spotify.music). An entry that is neither is skipped with its reason; the run fails only when none can be read. App names are not accepted, because turning a name into an app needs Google Play search, which this Actor does not use.

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

Read in developer mode. Each entry can be a developer name as you would type it ("Netflix", tried with the usual company suffixes such as ", Inc." and " AB"), the exact name Google Play prints ("Spotify AB"), a Google Play developer page URL (https://play.google.com/store/apps/developer?id=Spotify+AB), or any app the publisher made (com.netflix.mediaclient), which is resolved to its developer.

## `categories` (type: `array`):

Read in category mode. Google Play category IDs (HEALTH_AND_FITNESS, FINANCE) or the names the store shows ("Health & Fitness"). "TOP" reads the overall top-apps page. An unknown category is skipped with its reason. Each page lists roughly 30 to 90 apps.

## `countries` (type: `array`):

Two-letter country codes of the Google Play storefronts to read. Availability, prices, similar apps and category pages all differ by country, so each country is read separately.

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

Language code for the text Google Play returns (titles, summaries, descriptions), such as "en", "th" or "pt-br". Independent of country.

## `maxAppsPerInput` (type: `integer`):

In developer, similar and category modes: how many apps to return for each developer, seed app or category, in each country. Category pages are capped at 100. Ignored in details mode, which returns one row per app.

## `includeDetails` (type: `boolean`):

Off by default. In developer and similar modes, each app also gets its install count, number of ratings and reviews, category, content rating, release and update dates, and the developer email, website and privacy policy from its listing page. Adds about 1.5 seconds per app and is charged per app enriched. Details and category rows already carry all of this, so it changes nothing there.

## Actor input object example

```json
{
  "mode": "developer",
  "appUrlsOrIds": [
    "com.spotify.music",
    "https://play.google.com/store/apps/details?id=com.duolingo"
  ],
  "developers": [
    "Netflix",
    "https://play.google.com/store/apps/developer?id=Spotify+AB"
  ],
  "categories": [
    "FINANCE",
    "Health & Fitness",
    "TOP"
  ],
  "countries": [
    "us",
    "gb",
    "de"
  ],
  "language": "en",
  "maxAppsPerInput": 20,
  "includeDetails": true
}
```

# Actor output Schema

## `rows` (type: `string`):

One row per app: mode, title, developer, rating, price and store link, plus installs and developer contact where the mode or includeDetails provides them.

## `summary` (type: `string`):

What was requested, what was delivered, and the per-request counts behind it — enough to check a run without reading every row.

# 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 = {
    "mode": "details",
    "appUrlsOrIds": [
        "com.spotify.music",
        "com.duolingo",
        "com.netflix.mediaclient",
        "com.whatsapp",
        "com.instagram.android",
        "org.telegram.messenger",
        "com.zhiliaoapp.musically",
        "com.google.android.youtube",
        "com.microsoft.teams",
        "com.ubercab"
    ],
    "developers": [
        "com.netflix.mediaclient"
    ],
    "categories": [
        "HEALTH_AND_FITNESS"
    ],
    "countries": [
        "us"
    ],
    "language": "en",
    "maxAppsPerInput": 50,
    "includeDetails": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("appdata-labs/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 = {
    "mode": "details",
    "appUrlsOrIds": [
        "com.spotify.music",
        "com.duolingo",
        "com.netflix.mediaclient",
        "com.whatsapp",
        "com.instagram.android",
        "org.telegram.messenger",
        "com.zhiliaoapp.musically",
        "com.google.android.youtube",
        "com.microsoft.teams",
        "com.ubercab",
    ],
    "developers": ["com.netflix.mediaclient"],
    "categories": ["HEALTH_AND_FITNESS"],
    "countries": ["us"],
    "language": "en",
    "maxAppsPerInput": 50,
    "includeDetails": False,
}

# Run the Actor and wait for it to finish
run = client.actor("appdata-labs/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 '{
  "mode": "details",
  "appUrlsOrIds": [
    "com.spotify.music",
    "com.duolingo",
    "com.netflix.mediaclient",
    "com.whatsapp",
    "com.instagram.android",
    "org.telegram.messenger",
    "com.zhiliaoapp.musically",
    "com.google.android.youtube",
    "com.microsoft.teams",
    "com.ubercab"
  ],
  "developers": [
    "com.netflix.mediaclient"
  ],
  "categories": [
    "HEALTH_AND_FITNESS"
  ],
  "countries": [
    "us"
  ],
  "language": "en",
  "maxAppsPerInput": 50,
  "includeDetails": false
}' |
apify call appdata-labs/google-play-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,appdata-labs/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/6mLVsS1Fcdyjz80zm/builds/AdbMvQcVLyUeNdlpA/openapi.json
