# App Reviews

> Access app details and reviews from the Apple App Store and Google Play Store.

Source: https://cotera.co/docs/reference/tools/individual-tools/app-reviews

---

**Authentication Type:** API Key
**Description:** Access app details and reviews from the Apple App Store and Google Play Store.

***

## Authentication

To authenticate, you'll need a RapidAPI key for the [App Store and Google Play API](https://rapidapi.com/app-store-and-google-play-data/api/app-store-and-google-play-api).

***

## Apple App Store

Get app details, ratings, and reviews from the Apple App Store.

### Apple App Store Details

Get app details, ratings, and reviews from the Apple App Store.

**Operation Type:** Query (Read)

**Parameters:**

* **id** `number` (required): Apple App Store ID (find in URL: `apps.apple.com/.../id{ID}`)
* **language** `string` (nullable): Language code (default: "en")
* **country** `string` (nullable): Country code (default: "us")

**Returns:**

* **id** `number`: App Store ID
* **bundleId** `string`: Bundle ID
* **title** `string`: App title
* **artistName** `string` (nullable): Developer/artist name
* **seller** `string` (nullable): Seller name
* **description** `string` (nullable): App description
* **subtitle** `string` (nullable): App subtitle
* **whatsNew** `string` (nullable): What's new text
* **latestVersion** `string` (nullable): Latest version number
* **latestVersionDate** `string` (nullable): Latest version date
* **rating** `number` (nullable): Average rating
* **totalRatingCount** `number` (nullable): Total rating count
* **ratingBreakdown** `object` (nullable): Rating distribution
  * **star1** `number` (nullable): 1-star count
  * **star2** `number` (nullable): 2-star count
  * **star3** `number` (nullable): 3-star count
  * **star4** `number` (nullable): 4-star count
  * **star5** `number` (nullable): 5-star count
* **ageRating** `string` (nullable): Age rating
* **primaryGenre** `string` (nullable): Primary category
* **isFree** `boolean` (nullable): Whether app is free
* **sizeBytes** `number` (nullable): App size in bytes
* **appStoreUrl** `string` (nullable): App Store URL
* **iconUrl** `string` (nullable): Icon URL
* **developerSite** `string` (nullable): Developer website
* **privacyPolicyUrl** `string` (nullable): Privacy policy URL
* **reviews** `array of objects`: Recent reviews (limited)
  * **reviewId** `string`: Review ID
  * **date** `string` (nullable): Review date
  * **rating** `number` (nullable): Rating (1-5)
  * **title** `string` (nullable): Review title
  * **review** `string` (nullable): Review text
  * **userName** `string` (nullable): Reviewer name
* **customersAlsoBought** `array of objects` (nullable): Related apps
  * **id** `number`: App ID
  * **title** `string` (nullable): App title
  * **artistName** `string` (nullable): Developer name
  * **rating** `number` (nullable): Rating
  * **iconUrl** `string` (nullable): Icon URL
* **developerOtherApps** `array of objects` (nullable): Other apps by the developer
  * **id** `number`: App ID
  * **title** `string` (nullable): App title
  * **artistName** `string` (nullable): Developer name
  * **rating** `number` (nullable): Rating
  * **iconUrl** `string` (nullable): Icon URL

**Example Usage:**

```json
{
  "id": 284882215,
  "country": "us"
}
```

**Note:** Reviews returned are limited (\~8) due to API constraints. For comprehensive review analysis, use Google Play Reviews which supports higher volumes.

***

## Google Play Store

Get app reviews from the Google Play Store with pagination and filtering.

### Google Play Reviews

Get app reviews from Google Play Store with pagination and filtering support.

**Operation Type:** Query (Read)

**Parameters:**

* **bundleId** `string` (required): Android package name (e.g., "com.facebook.katana")
* **language** `string` (nullable): Language code (default: "en")
* **country** `string` (nullable): Country code (default: "us")
* **limit** `number` (nullable): Number of reviews (default: 100, max: 4000)
* **rating** `number` (nullable): Filter by star rating (1-5)
* **sort** `string` (nullable): Sort order: "newest" or "most\_relevant"
* **device** `string` (nullable): Device filter: "phone" or "tablet"
* **cursor** `string` (nullable): Pagination cursor from previous response

**Returns:**

* **bundleId** `string`: Package name
* **country** `string` (nullable): Country code
* **language** `string` (nullable): Language code
* **limit** `number` (nullable): Requested limit
* **sort** `string` (nullable): Sort order
* **cursor** `string` (nullable): Next page cursor
* **reviews** `array of objects`: Reviews list
  * **reviewId** `string`: Review ID
  * **timestamp** `string` (nullable): Review timestamp (ISO format)
  * **rating** `number` (nullable): Rating (1-5)
  * **review** `string` (nullable): Review text
  * **userName** `string` (nullable): Reviewer name
  * **pictureUrl** `string` (nullable): User avatar URL
  * **helpfulVotes** `number` (nullable): Helpful vote count
  * **relatedVersion** `string` (nullable): App version reviewed

**Example Usage:**

```json
{
  "bundleId": "com.spotify.music",
  "limit": 500,
  "rating": 1,
  "sort": "newest"
}
```

**Pagination Example:**

```json
{
  "bundleId": "com.spotify.music",
  "cursor": "eyJjdXJzb3JUeXBlIjoiTkVYVF9QQUdFIiwiY3Vyc29yVmFsdWUiOiIxMDAifQ=="
}
```

***

## Common Use Cases

**Product Development:**

* Analyze user feedback to identify bugs and feature requests
* Monitor sentiment trends after releases
* Compare user satisfaction across iOS and Android versions

**Competitive Analysis:**

* Compare ratings and review volumes across competitors
* Identify competitor weaknesses from negative reviews
* Track feature mentions across competitive apps

**App Store Optimization (ASO):**

* Monitor rating trends over time
* Identify keywords users frequently mention in reviews
* Track the impact of updates on user satisfaction

**Customer Support:**

* Identify common issues users report
* Prioritize bug fixes based on review frequency and sentiment
* Understand user expectations and pain points