# Naver Shopping Insight Category API (https://www.socialcrawl.dev/platforms/naver/shopping-insight-category)

> Returns a relative click-share time series for up to 3 Naver Shopping categories under `data.results[].data[]` as `{period, ratio}` pairs. Set `breakdown` to split one category by `device`, `gender`, or `age` instead of comparing categories. Partly fills the gap left by Naver retiring its Shopping SEARCH corpus on 2026-07-31: this gives demand and click TRENDS for a category, though not individual product listings or prices, which no Naver API offers any more. `ratio` is a relative index within the requested window, not an absolute count. Shopping Insight history starts 2017-08-01 (later than search-trend's 2016-01-01); an earlier `start_date` is clamped up to it. An unknown category id returns no data points and is not charged.

TL;DR: `GET /v1/naver/shopping-insight/category` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `category_code` | yes | Comma-separated Naver Shopping category ids, up to 3 (e.g. `50000000` for 패션의류). Required. When `breakdown` is set, only the first id is used. Naver publishes no category-list API, so see the platform guide for the id table. |
| `start_date` | no | Window start, `YYYY-MM-DD`. Defaults to 12 months before `end_date`. Clamped up to 2017-08-01, the earliest Shopping Insight data Naver holds. |
| `end_date` | no | Window end, `YYYY-MM-DD`. Defaults to today. |
| `time_unit` | no | Aggregation bucket: `date`, `week`, or `month` (default `month`). (date \| week \| month) |
| `device` | no | Restrict to `pc` or `mo` (mobile). Omit for both. (pc \| mo) |
| `gender` | no | Restrict to `f` or `m`. Omit for both. (f \| m) |
| `ages` | no | Comma-separated age buckets: `10`, `20`, `30`, `40`, `50`, `60`. NOTE these differ from `search-trend`, which takes 1-11. |
| `breakdown` | no | Split a single category by `device`, `gender`, or `age` instead of comparing several categories. (device \| gender \| age) |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/naver/shopping-insight/category" \
  --data-urlencode "category_code=50000000" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Naver Shopping Insight Category API return?

Returns a click-share time series for up to 3 Naver Shopping categories as results[].data[] {period, ratio} pairs. breakdown splits one category by device, gender, or age. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Naver Shopping Insight Category endpoint?

Use it for Korean shopping demand trends by category. It partly covers the gap left by Naver retiring its Shopping search corpus, though it gives trends, not product listings or prices.

### How much does the Naver Shopping Insight Category API cost?

Each call costs 5 credits, so the 100 free credits every new account gets cover 20 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Naver Shopping Insight Category API need?

The one required parameter is category_code (comma-separated Naver Shopping category ids, up to 3 e.g). It also accepts 7 optional parameters, all listed on this page.

### How do I call the Naver Shopping Insight Category API?

Send a GET request to https://www.socialcrawl.dev/v1/naver/shopping-insight/category?category_code=50000000 with your API key in the x-api-key header. An Authorization: Bearer header works too.

See the full Naver API: https://www.socialcrawl.dev/platforms/naver

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl Naver Shopping Insight Category API return?
- How do I get Naver Shopping Insight Category data with the SocialCrawl API?