> ## 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.

# Shopping Bestsellers

> Naver Shopping bestseller product rankings by category, age bracket, sort metric and period.

Fetch Naver Shopping's bestseller product rankings. Scope the chart by
category, age bracket, the metric it is sorted by and the period. Each product
carries its rank, the `nv_mid` catalogue id, title, price, discount, review
score and count, mall name and imagery.

**Credits:** 5

> [!NOTE]
>
> This endpoint returns Naver Shopping's **ranking data only**. General product
> search and SmartStore storefront listings are not offered.

## Authorization

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

Your ScrapeBadger API key.

## Query Parameters

**category\_id** `string` (default: ALL)

Category to rank within. `ALL` for the overall chart, or a Naver Shopping
category id.

**age\_type** `string` (default: ALL)

Age bracket to rank for. `ALL`, or a specific bracket.

**sort\_type** `string` (default: PRODUCT\_CLICK)

The metric the chart is sorted by, e.g. `PRODUCT_CLICK`.

**period\_type** `string` (default: DAILY)

The ranking period, e.g. `DAILY`.

## Response

**category\_id** `string`

Echo of the requested category.

**age\_type** `string`

Echo of the requested age bracket.

**sort\_type** `string`

Echo of the requested sort metric.

**period\_type** `string`

Echo of the requested period.

**sync\_date** `string`

When Naver last synced this ranking.

**result\_count** `integer`

Products returned.

**products** `Product[]`

Ranked products.

**Product**

**rank** `integer`

1-based rank in the chart.

**nv\_mid** `string`

Naver Shopping catalogue id.

**title** `string`

**price** `integer`

List price in KRW.

**discount\_price** `integer`

Discounted price in KRW, when on offer.

**discount\_rate** `integer`

Discount percentage, when on offer.

**review\_score** `number`

Average review score.

**review\_count** `integer`

**mall\_name** `string`

The mall selling the product.

**product\_url** `string`

**image\_url** `string`

**is\_ad** `boolean`

Whether the entry is a sponsored placement.

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/naver/shopping/bestsellers?category_id=ALL&age_type=ALL&sort_type=PRODUCT_CLICK&period_type=DAILY" \
  -H "X-API-Key: YOUR_API_KEY"
```

```javascript Node.js theme={null}
const res = await fetch(
  "https://scrapebadger.com/v1/naver/shopping/bestsellers?" +
    new URLSearchParams({
      category_id: "ALL",
      age_type: "ALL",
      sort_type: "PRODUCT_CLICK",
      period_type: "DAILY",
    }),
  { 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/shopping/bestsellers",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "category_id": "ALL",
        "age_type": "ALL",
        "sort_type": "PRODUCT_CLICK",
        "period_type": "DAILY",
    },
)
data = res.json()
```

```json Response theme={null}
{
  "category_id": "ALL",
  "age_type": "ALL",
  "sort_type": "PRODUCT_CLICK",
  "period_type": "DAILY",
  "sync_date": "2026-08-07T00:00:00+00:00",
  "result_count": 100,
  "products": [
    {
      "rank": 1,
      "nv_mid": "82613579214",
      "title": "삼성전자 갤럭시 버즈3 프로",
      "price": 279000,
      "discount_price": 229000,
      "discount_rate": 18,
      "review_score": 4.8,
      "review_count": 12043,
      "mall_name": "삼성전자 공식스토어",
      "product_url": "https://shopping.naver.com/catalog/82613579214",
      "image_url": "https://shopping-phinf.example.net/82613579214.jpg",
      "is_ad": false
    }
  ]
}
```


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