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

> Naver Shopping keyword insight — the ranked top search keywords for a category over a date range.

Fetch Naver Shopping's keyword insight ranking — the top search keywords for a
category over a date range. Use it to see what shoppers in a category are
actually searching for.

**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` *required*

Naver Shopping category id to rank keywords within.

**start\_date** `string` *required*

Start of the date range, `YYYY-MM-DD`.

**end\_date** `string` *required*

End of the date range, `YYYY-MM-DD`.

**time\_unit** `string` (default: date)

Aggregation unit, e.g. `date`, `week`, `month`.

**count** `integer` (default: 20)

Number of keywords to return.

## Response

**category\_id** `string`

Echo of the requested category.

**date\_range** `string`

The date range the ranking covers.

**result\_count** `integer`

Keywords returned.

**keywords** `Keyword[]`

Ranked keywords.

**Keyword**

**rank** `integer`

1-based rank.

**keyword** `string`

The search keyword.

## Example

```bash cURL theme={null}
curl "https://scrapebadger.com/v1/naver/shopping/insight?category_id=50000000&start_date=2026-08-01&end_date=2026-08-07&time_unit=date&count=20" \
  -H "X-API-Key: YOUR_API_KEY"
```

```javascript Node.js theme={null}
const res = await fetch(
  "https://scrapebadger.com/v1/naver/shopping/insight?" +
    new URLSearchParams({
      category_id: "50000000",
      start_date: "2026-08-01",
      end_date: "2026-08-07",
      time_unit: "date",
      count: "20",
    }),
  { 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/insight",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "category_id": "50000000",
        "start_date": "2026-08-01",
        "end_date": "2026-08-07",
        "time_unit": "date",
        "count": 20,
    },
)
data = res.json()
```

```json Response theme={null}
{
  "category_id": "50000000",
  "date_range": "2026-08-01 ~ 2026-08-07",
  "result_count": 20,
  "keywords": [
    { "rank": 1, "keyword": "반팔티" },
    { "rank": 2, "keyword": "린넨 셔츠" },
    { "rank": 3, "keyword": "샌들" }
  ]
}
```


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