# 🔥 Apple Store Api (`bebity/apple-store-api`) Actor

🚀 Discover the "Apple Store API" by Bebity! Unlock the power of the Apple Store and unleash its vast potential with ease and efficiency! 🌟 Whether you are an app developer 🛠️, a data analyst 📊, or a marketer 🚀, this versatile tool is your ultimate companion for all your Apple Store data needs.

- **URL**: https://apify.com/bebity/apple-store-api.md
- **Developed by:** [Bebity](https://apify.com/bebity) (community)
- **Categories:** Automation, Developer tools
- **Stats:** 94 total users, 1 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: 5.00 out of 5 stars

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

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

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

## 🔥Apple Store API🔥

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

🚀 Fast and robust scraper to get Apple Store data.
This Apify Actor is your ideal ally for navigating and harnessing the data of the Apple Store with ease and efficiency! 🌟
🔓 Discover this actor, your magical key to unlock the infinite potential of the Apple 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 Privacy     | Privacy details 🛡️             | App Id or Url
| Get App Ratings     | Ratings and reviews ⭐           | App Id or Url

### 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, getPrivacy, getRatings
| 🔗 Developer id or url | String          | Developer id or store url               | getDevelopperApps
| 📦 Category            | Category type   | Store category                          |
| 🆓 Collection          | Collection type | Store collection                        |
| ⬆️ 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                            |

#### Category type

```
BOOKS
BUSINESS
CATALOGS
EDUCATION
ENTERTAINMENT
FINANCE
FOOD_AND_DRINK
GAMES
GAMES_ACTION
GAMES_ADVENTURE
GAMES_ARCADE
GAMES_BOARD
GAMES_CARD
GAMES_CASINO
GAMES_DICE
GAMES_EDUCATIONAL
GAMES_FAMILY
GAMES_MUSIC
GAMES_PUZZLE
GAMES_RACING
GAMES_ROLE_PLAYING
GAMES_SIMULATION
GAMES_SPORTS
GAMES_STRATEGY
GAMES_TRIVIA
G

AMES_WORD
HEALTH_AND_FITNESS
LIFESTYLE
MAGAZINES_AND_NEWSPAPERS
MAGAZINES_ARTS
MAGAZINES_AUTOMOTIVE
MAGAZINES_WEDDINGS
MAGAZINES_BUSINESS
MAGAZINES_CHILDREN
MAGAZINES_COMPUTER
MAGAZINES_FOOD
MAGAZINES_CRAFTS
MAGAZINES_ELECTRONICS
MAGAZINES_ENTERTAINMENT
MAGAZINES_FASHION
MAGAZINES_HEALTH
MAGAZINES_HISTORY
MAGAZINES_HOME
MAGAZINES_LITERARY
MAGAZINES_MEN
MAGAZINES_MOVIES_AND_MUSIC
MAGAZINES_POLITICS
MAGAZINES_OUTDOORS
MAGAZINES_FAMILY
MAGAZINES_PETS
MAGAZINES_PROFESSIONAL
MAGAZINES_REGIONAL
MAGAZINES_SCIENCE
MAGAZINES_SPORTS
MAGAZINES_TEENS
MAGAZINES_TRAVEL
MAGAZINES_WOMEN
MEDICAL
MUSIC
NAVIGATION
NEWS
PHOTO_AND_VIDEO
PRODUCTIVITY
REFERENCE
SHOPPING
SOCIAL_NETWORKING
SPORTS
TRAVEL
UTILITIES
WEATHER
```

#### Collection type

```
TOP_MAC
TOP_FREE_MAC
TOP_GROSSING_MAC
TOP_PAID_MAC
NEW_IOS
NEW_FREE_IOS
NEW_PAID_IOS
TOP_FREE_IOS
TOP_FREE_IPAD
TOP_GROSSING_IOS
TOP_GROSSING_IPAD
TOP_PAID_IOS
TOP_PAID_IPAD
```

#### Order by type

```
RECENT
HELPFUL
```

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

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

❤️ **[Bebity](https://bebity.io)** ❤️

# 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

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

## Actor input object example

```json
{
  "action": "getApps",
  "num": 200,
  "appIdOrUrl": "com.google.android.apps.translate",
  "devIdOrUrl": "com.google.android.apps.translate",
  "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 = {
    "action": "getApps",
    "lang": "en",
    "country": "us"
};

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

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,bebity/apple-store-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/XErktmamiyjbwTzQ2/builds/JS0gx7sGKBuKQexN2/openapi.json