# 🔥 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
- **Stats:** 141 total users, 1 monthly users, 100.0% runs succeeded, 7 bookmarks
- **User rating**: No ratings yet

## Pricing

$15.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

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

## 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.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

![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("💾 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 '{
  "lang": "en",
  "country": "us"
}' |
apify call bebity/google-play-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=bebity/google-play-api",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "🔥 Google Play Api",
        "description": "🚀 Discover \"Google Play API\" by Apify!\nGet Apps: Explore apps 📚.\nGet App Details: Crunchy details 🔍.\nGet Similar Apps: Spot trends 🚀.\nSearch Apps: Powerful searching 🔥.\nGet Developer Apps: Dive into a dev's creations 👨‍💻.\nGet App Reviews: Hear the users 🎤.\nPermissions 🛡️\nCategories 🌐 ...",
        "version": "0.0",
        "x-build-id": "C0zRJE2kNU4kGlvvR"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/bebity~google-play-api/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-bebity-google-play-api",
                "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/bebity~google-play-api/runs": {
            "post": {
                "operationId": "runs-sync-bebity-google-play-api",
                "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/bebity~google-play-api/run-sync": {
            "post": {
                "operationId": "run-sync-bebity-google-play-api",
                "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": [
                    "action"
                ],
                "properties": {
                    "action": {
                        "title": "🔨 Action",
                        "enum": [
                            "getApps",
                            "getAppDetails",
                            "getSimilarApps",
                            "searchApps",
                            "getDevelopperApps",
                            "getAppReviews",
                            "getAppPermissions",
                            "getCategories"
                        ],
                        "type": "string",
                        "description": "Select an action to perform",
                        "default": "getApps"
                    },
                    "num": {
                        "title": "🔢 Number max of rows",
                        "type": "integer",
                        "description": "Number of rows to get",
                        "default": 200
                    },
                    "appIdOrUrl": {
                        "title": "🔗 App id or url",
                        "type": "string",
                        "description": "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": {
                        "title": "🔗 Developer id or url",
                        "type": "string",
                        "description": "Provide developer id or url here => '5700313618786177705' or 'https://play.google.com/store/apps/dev?id=5700313618786177705'"
                    },
                    "category": {
                        "title": "📦 Category",
                        "enum": [
                            "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"
                        ],
                        "type": "string",
                        "description": "Select app category"
                    },
                    "collection": {
                        "title": "🆓 Collection",
                        "enum": [
                            "TOP_FREE",
                            "TOP_PAID",
                            "GROSSING"
                        ],
                        "type": "string",
                        "description": "Select your collection"
                    },
                    "age": {
                        "title": "🚸 Age",
                        "enum": [
                            "AGE_RANGE1",
                            "AGE_RANGE2",
                            "AGE_RANGE3"
                        ],
                        "type": "string",
                        "description": "Select age limitation"
                    },
                    "sort": {
                        "title": "⬆️ Order by",
                        "enum": [
                            "NEWEST",
                            "RATING",
                            "HELPFULNESS"
                        ],
                        "type": "string",
                        "description": "Select ordering",
                        "default": "NEWEST"
                    },
                    "lang": {
                        "title": "🗣️ Default informations language",
                        "pattern": "^[a-z]{2}$",
                        "type": "string",
                        "description": "Provide language. Example: 'en' / 'fr' ...."
                    },
                    "country": {
                        "title": "🏴󠁥󠁳󠁰󠁶󠁿 Default country",
                        "pattern": "^[a-z]{2}$",
                        "type": "string",
                        "description": "Provide country. Example: 'us' / 'fr' ...."
                    },
                    "fullDetail": {
                        "title": "✅ Full details (more informations but make more requests)",
                        "type": "boolean",
                        "description": "If checked, more informations will be provided but more requests will be made",
                        "default": false
                    },
                    "search": {
                        "title": "🔎 Search",
                        "type": "string",
                        "description": "Provide search query"
                    },
                    "price": {
                        "title": "🔖 Price",
                        "enum": [
                            "all",
                            "free",
                            "paid"
                        ],
                        "type": "string",
                        "description": "Select price"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
