> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asccli.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Reviews

# reviews

> List and manage App Store customer reviews and ratings

The `reviews` command manages customer reviews and ratings from the App Store.

## Usage

```bash theme={null} theme={null}
asc reviews <subcommand> [flags]
```

## Subcommands

### List reviews

List customer reviews for an app:

```bash theme={null} theme={null}
asc reviews list --app APP_ID
asc reviews list --app APP_ID --sort -createdDate
asc reviews list --app APP_ID --stars 1
```

### Get review

Get details for a specific review:

```bash theme={null} theme={null}
asc reviews view --id REVIEW_ID
```

### Respond to review

Post a developer response to a review:

```bash theme={null} theme={null}
asc reviews respond \
  --review-id REVIEW_ID \
  --response "Thank you for your feedback! We've fixed this issue in v1.2.0."
```

### Get ratings

Get rating summary:

```bash theme={null} theme={null}
asc reviews ratings --app APP_ID
```

### Review summarizations

List App Store review summarizations for an app:

```bash theme={null} theme={null}
asc reviews summarizations --app "APP_ID"
asc reviews summarizations --app "APP_ID" --platform IOS --territory USA
```

### Manage existing review responses

Inspect or delete an existing response:

```bash theme={null} theme={null}
asc reviews response view --id "RESPONSE_ID"
asc reviews response delete --id "RESPONSE_ID" --confirm
asc reviews response for-review --review-id "REVIEW_ID"
```

## List flags

<ParamField path="--app" type="string" required>
  App ID to list reviews for
</ParamField>

<ParamField path="--sort" type="string">
  Sort order: `createdDate`, `-createdDate`, `rating`, `-rating`
</ParamField>

<ParamField path="--stars" type="number">
  Filter by star rating (1-5)
</ParamField>

<ParamField path="--territory" type="string">
  Territory code to filter reviews (e.g., `US`, `GB`)
</ParamField>

<ParamField path="--output" type="string">
  Output format: `json`, `table`, or `markdown`
</ParamField>

<ParamField path="--limit" type="number">
  Maximum number of results
</ParamField>

<ParamField path="--paginate" type="boolean">
  Fetch all pages automatically
</ParamField>

## Output example

```json theme={null} theme={null}
{
  "data": [
    {
      "id": "review-id",
      "type": "customerReviews",
      "attributes": {
        "rating": 5,
        "title": "Great app!",
        "body": "Love the new features in this update.",
        "reviewerNickname": "HappyUser",
        "createdDate": "2024-03-04T12:00:00Z",
        "territory": "USA"
      }
    }
  ]
}
```

## Example workflows

### View recent low-rated reviews

```bash theme={null} theme={null}
asc reviews list \
  --app 123456789 \
  --stars 1 \
  --sort -createdDate \
  --output table
```

### Respond to reviews

```bash theme={null} theme={null}
# Get low-rated reviews
asc reviews list --app 123456789 --stars 1 --output json | \
jq -r '.data[].id' | while read review_id; do
  asc reviews respond \
    --review-id "$review_id" \
    --response "Thank you for your feedback. We'd like to help resolve this issue. Please contact us at support@example.com."
done
```

### Export reviews to CSV

```bash theme={null} theme={null}
asc reviews list --app 123456789 --paginate --output json | \
jq -r '.data[] | [.attributes.rating, .attributes.title, .attributes.body, .attributes.createdDate] | @csv' > reviews.csv
```

### Get rating summary

```bash theme={null} theme={null}
asc reviews ratings --app 123456789 --output table
```

**Example output:**

```
Rating  Count  Percentage
5       1000   50%
4       500    25%
3       300    15%
2       150    7.5%
1       50     2.5%
Average: 4.2
```

## Response guidelines

<Note>
  Apple guidelines for responding to reviews:

  * Be professional and courteous
  * Don't request that users change their review
  * Don't include promotional content
  * Keep responses focused on addressing the feedback
  * You can only respond once per review
</Note>

## Related

<CardGroup cols={2}>
  <Card title="Review command" icon="clipboard-check" href="/commands/review">
    Manage App Store review submissions
  </Card>

  <Card title="Feedback command" icon="comment" href="/commands/feedback">
    View TestFlight feedback
  </Card>
</CardGroup>