# Shopify App Reviews

Return public merchant reviews for one Shopify app with numeric rating, text, ISO date, merchant or store name, country, usage tenure, helpful count and developer reply when present. Sort by newest and page through results.

- **Documentation:** [https://scrappa.co/docs/shopify-app-store-api/shopify_app_store_reviews](https://scrappa.co/docs/shopify-app-store-api/shopify_app_store_reviews)
- **API group:** Shopify App Store API
- **Endpoint:** `GET https://scrappa.co/api/shopify/reviews`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `handle` | string | Yes | App handle from search or the sitemap. id is accepted as an alias. |
| `sort` | string | No | newest is the only supported order. Other values return 422. |
| `locale` | string | No | Language code: en or de. |
| `page` | integer | No | Page number. Page 1 is the first page. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/shopify/reviews?handle=example-app&sort=newest"
```

## Example response

```json
{
    "search_parameters": {
        "engine": "shopify_app_store_reviews",
        "handle": "example-app",
        "sort": "newest",
        "locale": "en",
        "page": 1
    },
    "reviews": [
        {
            "id": "12345",
            "merchant": "Example Store",
            "rating": 5,
            "text": "Great app.",
            "date": "2026-03-01T00:00:00Z",
            "country": "US",
            "developer_reply": null
        }
    ],
    "pagination": {
        "current_page": 1,
        "next_page": 2,
        "total": 320
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A review parameter failed validation. |
| 404 | App Not Found | No public app for this handle. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
