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

# List Product Reviews

> Paginated review list for a Naver storefront product, with sort control.

List the **individual reviews** for a storefront product, paginated and sortable. Each review carries its rating, body, author (masked), options purchased and media.

**Credits:** 5

> [!NOTE]
>
> Brand Store products are fully supported. SmartStore review listing requires a `checkout_merchant_no` and may be unavailable.

## Authorization

**X-API-Key** `string` *required*

Your ScrapeBadger API key.

## Path Parameters

**origin\_product\_no** `string` *required*

The product's origin product number.

## Query Parameters

**store\_url** `string` *required*

Store/brand slug.

**product\_no** `string` *required*

Channel product number (the storefront `/products/{no}` id, not the origin product number).

**host** `string` (default: smartstore)

`brand` or `smartstore`.

**checkout\_merchant\_no** `integer`

SmartStore only — passed through when known.

**page** `integer` (default: 1)

1-based page.

**sort** `string` (default: REVIEW\_RANKING)

`REVIEW_RANKING` or `REVIEW_CREATE_DATE_DESC`.

## Response

**origin\_product\_no** `string`

**page** `integer`

**page\_size** `integer`

**sort** `string`

**total\_count** `integer`

Total reviews, when reported.

**reviews** `Review[]`

Reviews.

**Review**

**review\_id** `string`

**rating** `integer`

**content** `string`

**author\_masked** `string`

**option** `string`

The purchased option, when shown.

**created\_at** `string`

**images** `string[]`

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/naver/products/5123456789/reviews?store_url=nike&product_no=7001234567&host=brand&page=1" \
  -H "X-API-Key: YOUR_API_KEY"
```

```javascript Node.js theme={null}
const res = await fetch(
  "https://scrapebadger.com/v1/naver/products/5123456789/reviews?" +
    new URLSearchParams({"store_url": "nike", "product_no": "7001234567", "host": "brand", "page": "1"}),
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();
```

```python Python theme={null}
import requests

res = requests.get(
    "https://scrapebadger.com/v1/naver/products/5123456789/reviews",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"store_url": "nike", "product_no": "7001234567", "host": "brand", "page": "1"},
)
data = res.json()
```

```json Response theme={null}
{
  "origin_product_no": "5123456789",
  "page": 1,
  "page_size": 20,
  "sort": "REVIEW_RANKING",
  "total_count": 5231,
  "reviews": [
    {
      "review_id": "r900100",
      "rating": 5,
      "content": "사이즈 정사이즈이고 배송 빨라요",
      "author_masked": "kim****",
      "option": "270",
      "created_at": "2026-07-28T00:00:00+09:00",
      "images": [
        "https://review-phinf.example.net/r900100.jpg"
      ]
    }
  ]
}
```

## Errors

| Status | Meaning |
| - | - |
| `404` | The requested resource does not exist or has been removed. |
| `422` | Naver served a challenge instead of content — **not billed**. Retry; it succeeds. |
| `502` | Unexpected upstream failure — **not billed**. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.