# App Store Reviews

> Hear what people say about any iPhone or iPad app: read its App Store reviews and star rating by country, and start a workflow when a new review, or a low-rated one, comes in.

App · 4 actions. Web page: https://docs.lodol.com/docs/integrations/app-store-reviews

## Actions

### Find app

Find apps on the App Store by name, best match first, to get their numbers.

**Inputs**

- Name (`query`, text, required): The app's name, or words from it.
- Country (`country`, text): The App Store country, as a two-letter code such as us, gb or de. Defaults to us.
- How many (`limit`, number): The most to list, up to 50. Defaults to 50. From 1 to 50.

**Outputs**

- `apps` (list): The apps, best match first
- `count` (number): How many

**Example output**

```json
{
  "apps": [
    {
      "bundle_id": "com.acme.notes",
      "category": "Productivity",
      "developer": "Acme, Inc.",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/example/512x512bb.jpg",
      "id": "284882215",
      "link": "https://apps.apple.com/us/app/acme-notes/id284882215",
      "name": "Acme Notes",
      "price": "Free",
      "rating": 4.6,
      "ratings": 18213,
      "released_at": "2026-10-23T09:58:23Z",
      "version": "5.2.0"
    }
  ],
  "count": 1
}
```

### Get app

Get an app's name, developer, star rating, latest version and App Store link.

**Inputs**

- App (`app`, text, required): The app's App Store link, its number (the digits after id in the link), or its bundle ID such as com.example.app.
- Country (`country`, text): The App Store country, as a two-letter code such as us, gb or de. Defaults to us.

**Outputs**

- `bundle_id` (text): Its bundle ID
- `category` (text): Its App Store category
- `developer` (text): Who makes it
- `icon` (text): A link to its icon
- `id` (text): The app's App Store number
- `link` (text): Its App Store link
- `name` (text): Its name
- `price` (text): Its price, such as Free
- `rating` (number): Its average star rating in this country
- `ratings` (number): How many ratings that average is of
- `released_at` (text): When that version came out (ISO 8601)
- `version` (text): Its latest version

**Example output**

```json
{
  "bundle_id": "com.acme.notes",
  "category": "Productivity",
  "developer": "Acme, Inc.",
  "icon": "https://is1-ssl.mzstatic.com/image/thumb/example/512x512bb.jpg",
  "id": "284882215",
  "link": "https://apps.apple.com/us/app/acme-notes/id284882215",
  "name": "Acme Notes",
  "price": "Free",
  "rating": 4.6,
  "ratings": 18213,
  "released_at": "2026-10-23T09:58:23Z",
  "version": "5.2.0"
}
```

### Get rating summary

Get an app's overall star rating, and how its newest reviews (up to 500) split by stars.

**Inputs**

- App (`app`, text, required): The app's App Store link, its number (the digits after id in the link), or its bundle ID such as com.example.app.
- Country (`country`, text): The App Store country, as a two-letter code such as us, gb or de. Defaults to us.

**Outputs**

- `app` (text): The app's name
- `country` (text): The country read
- `five_star` (number): How many have 5 stars
- `four_star` (number): How many have 4 stars
- `oldest_recent_review_at` (text): When the oldest of them was written
- `one_star` (number): How many have 1 star
- `rating` (number): Its overall average star rating
- `ratings` (number): How many ratings that's of
- `recent_average` (number): Their average stars
- `recent_reviews` (number): How many of its newest reviews were read
- `three_star` (number): How many have 3 stars
- `two_star` (number): How many have 2 stars

**Example output**

```json
{
  "app": "Acme Notes",
  "country": "us",
  "five_star": 61,
  "four_star": 25,
  "oldest_recent_review_at": "2026-09-30T08:00:00-07:00",
  "one_star": 14,
  "rating": 4.6,
  "ratings": 18213,
  "recent_average": 3.9,
  "recent_reviews": 120,
  "three_star": 11,
  "two_star": 9
}
```

### List reviews

List an app's App Store reviews in one country, newest or most helpful first, optionally only some star ratings.

**Inputs**

- App (`app`, text, required): The app's App Store link, its number (the digits after id in the link), or its bundle ID such as com.example.app.
- Country (`country`, text): The App Store country, as a two-letter code such as us, gb or de. Defaults to us.
- Order (`sort`, text): Newest or most helpful first. Defaults to newest. One of: `mostrecent` (Newest first), `mosthelpful` (Most helpful first). Default: `mostrecent`.
- From stars (`min_rating`, number): Only reviews with at least this many stars. From 1 to 5.
- To stars (`max_rating`, number): Only reviews with at most this many stars, such as 2 for unhappy ones. From 1 to 5.
- How many (`limit`, number): The most to list, up to 500. Defaults to 50. From 1 to 500.

**Outputs**

- `app` (text): The app's name
- `count` (number): How many
- `country` (text): The country read
- `reviews` (list): The reviews

**Example output**

```json
{
  "app": "Acme Notes",
  "count": 1,
  "country": "us",
  "reviews": [
    {
      "author": "TracyToast",
      "helpful_votes": 3,
      "id": "14718715406",
      "rating": 2,
      "text": "Since the last update the app closes whenever I add a picture to a note.",
      "title": "Crashes when I attach a photo",
      "version": "5.2.0",
      "votes": 4,
      "written_at": "2026-10-27T11:26:07-07:00"
    }
  ]
}
```
