# 🔥 Google Play Api (`bebity/google-play-api`) Actor

🚀 Discover "Google Play API" by Apify!
Get Apps: Explore apps 📚.
Get App Details: Crunchy details 🔍.
Get Similar Apps: Spot trends 🚀.
Search Apps: Powerful searching 🔥.
Get Developer Apps: Dive into a dev's creations 👨‍💻.
Get App Reviews: Hear the users 🎤.
Permissions 🛡️
Categories 🌐 ...

- **URL**: https://apify.com/bebity/google-play-api.md
- **Developed by:** [Bebity](https://apify.com/bebity) (community)
- **Categories:** Developer tools
- **Features:** Full permissions
- **Stats:** 146 total users, 1 monthly users, 97.4% runs succeeded, 7 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

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

![header](https://i.ibb.co/5K547mK/apify-Bebity-io-3.png)

## 🔥Google Play API🔥

Brought to you by **[Bebity](https://bebity.io)** ❤️

🚀 Fast and robust scraper to get google play data.
This Apify Actor is your ideal ally for navigating and harnessing the data of the Google Play Store with ease and efficiency! 🌟
🔓 Discover this actor, your magical key to unlock the infinite potential of the Google Play Store. Whether you are an app developer 🛠️, a data analyst 📊, or a marketer 🚀, this agile tool is a true Swiss Army knife 🗡️ for your data needs

### Actions

| Action              | Description                     | Required inputs     |
|---------------------|---------------------------------|---------------------|
| Get Apps            | Explore apps 📚                 |
| Get App Details     | Crunchy details 🔍              | App Id or Url
| Get Similar Apps    | Spot trends 🚀                  | App Id or Url
| Search Apps         | Powerful searching 🔥           | search
| Get Developer Apps  | Dive into a dev's creations 👨‍💻  | developer Id or Url
| Get App Reviews     | Hear the users 🎤               | App Id or Url
| Get App Permissions | Monitor permissions 🛡️          | App Id or Url
| Get Categories      | Navigate categories 🌐          |

### Exports

You can export with all Apify export methods

![enter image description here](https://i.ibb.co/qm8MfKb/Screenshot-from-2023-07-02-03-28-42.png)

### Inputs

| Input                  | Type            | Description                             | Required for        |
|------------------------|-----------------|-----------------------------------------|---------------------|
| 🔨 Action              | Action type     | Action to perform                       | All
| 🔢 Number max of rows  | Number          | Max rows to get                         |
| 🔗 App id or url       | String          | App id or store url                     | getAppDetails, getSimilarApps, getAppReviews, getAppPermissions
| 🔗 Developer id or url | String          | Developer id or store url               | getDevelopperApps
| 📦 Category            | Category type   | Store category                          |
| 🆓 collection          | Collection type | Store collection                        |
| 🚸 Age                 |  Age type       | Age filter                              |
| ⬆️ Order by             | Order by type   | Order by                                |
| 🗣️ Default language    | String          | Language, ex: en, fr, it                |
| 🏴󠁥󠁳󠁰󠁶󠁿 Default country     | String          | Country, ex: en, fr, it                 |
| ✅ Full details        | Boolean         | More information but make more requests |
| 🔎 Search              | String          | Search input                            |
| 🔖 Price               | Price type      | Price type filter                       |

#### Category type

```
APPLICATION
ANDROID_WEAR
ART_AND_DESIGN
AUTO_AND_VEHICLES
BEAUTY
BOOKS_AND_REFERENCE
BUSINESS
COMICS
COMMUNICATION
DATING
EDUCATION
ENTERTAINMENT
EVENTS
FINANCE
FOOD_AND_DRINK
HEALTH_AND_FITNESS
HOUSE_AND_HOME
LIBRARIES_AND_DEMO
LIFESTYLE
MAPS_AND_NAVIGATION
MEDICAL
MUSIC_AND_AUDIO
NEWS_AND_MAGAZINES
PARENTING
PERSONALIZATION
PHOTOGRAPHY
PRODUCTIVITY
SHOPPING
SOCIAL
SPORTS
TOOLS
TRAVEL_AND_LOCAL
VIDEO_PLAYERS
WATCH_FACE
WEATHER
GAME
GAME_ACTION
GAME_ADVENTURE
GAME_ARCADE
GAME_BOARD
GAME_CARD
GAME_CASINO
GAME_CASUAL
GAME_EDUCATIONAL
GAME_MUSIC
GAME_PUZZLE
GAME_RACING
GAME_ROLE_PLAYING
GAME_SIMULATION
GAME_SPORTS
GAME_STRATEGY
GAME_TRIVIA
GAME_WORD
FAMILY
```

#### Collection type

```
TOP_FREE
TOP_PAID
GROSSING
```

#### Order by type

```
NEWEST
RATING
HELPFULNESS
```

#### Price type

```
ALL
FREE
PAID
```

### Response examples

#### Apps

![enter image description here](https://i.ibb.co/XzJ1rXZ/Screenshot-from-2023-07-02-03-19-44.png)

#### Apps with ✅ Full details

![enter image description here](https://i.ibb.co/R26Vm7q/Screenshot-from-2023-07-02-03-21-29.png)

#### App reviews

![enter image description here](https://i.ibb.co/sjNb8kd/Screenshot-from-2023-07-02-03-23-15.png)

#### App permissions

![enter image description here](https://i.ibb.co/PQtN2NW/Screenshot-from-2023-07-02-03-24-38.png)

# Actor input Schema

## `action` (type: `string`):

Select an action to perform

## `num` (type: `integer`):

Number of rows to get

## `appIdOrUrl` (type: `string`):

Provide app id or url here => 'com.google.android.apps.translate' or 'https://play.google.com/store/apps/details?id=com.google.android.apps.translate'

## `devIdOrUrl` (type: `string`):

Provide developer id or url here => '5700313618786177705' or 'https://play.google.com/store/apps/dev?id=5700313618786177705'

## `category` (type: `string`):

Select app category

## `collection` (type: `string`):

Select your collection

## `age` (type: `string`):

Select age limitation

## `sort` (type: `string`):

Select ordering

## `lang` (type: `string`):

Provide language. Example: 'en' / 'fr' ....

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

Provide country. Example: 'us' / 'fr' ....

## `fullDetail` (type: `boolean`):

If checked, more informations will be provided but more requests will be made

## `search` (type: `string`):

Provide search query

## `price` (type: `string`):

Select price

## Actor input object example

```json
{
  "action": "getApps",
  "num": 200,
  "appIdOrUrl": "com.google.android.apps.translate",
  "devIdOrUrl": "com.google.android.apps.translate",
  "sort": "NEWEST",
  "lang": "en",
  "country": "us",
  "fullDetail": false,
  "search": "google"
}
```

# 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 = {
    "lang": "en",
    "country": "us"
};

// Run the Actor and wait for it to finish
const run = await client.actor("bebity/google-play-api").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 = {
    "lang": "en",
    "country": "us",
}

# Run the Actor and wait for it to finish
run = client.actor("bebity/google-play-api").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 '{
  "lang": "en",
  "country": "us"
}' |
apify call bebity/google-play-api --silent --output-dataset

```

## MCP server setup

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

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/7jiXXcm7k1SGt9mFr/builds/C0zRJE2kNU4kGlvvR/openapi.json