# Naver Search Trend API (https://www.socialcrawl.dev/platforms/naver/search-trend)

> Returns a relative search-interest time series for up to 5 Korean keywords from Naver Data Lab, under `data.results[].data[]` as `{period, ratio}` pairs. This is Korea's equivalent of Google Trends, and for the Korean market it is the more meaningful signal because Naver carries the majority of Korean search. IMPORTANT: `ratio` is a RELATIVE index scaled 0-100 within the window you requested, not an absolute search count, so values are not comparable between two different requests. History starts 2016-01-01; an earlier `start_date` is clamped up to it. A keyword with no measurable volume returns no data points and is not charged.

TL;DR: `GET /v1/naver/search-trend` 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 |
| --- | --- | --- |
| `keywords` | yes | Comma-separated Korean keywords, up to 5, combined into ONE trend series. Required. |
| `start_date` | no | Window start, `YYYY-MM-DD`. Defaults to 12 months before `end_date`. Clamped up to 2016-01-01, the earliest 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) |
| `group_name` | no | Label for the series in the response. Defaults to the first keyword. |
| `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-band codes, `0` to `11` (Naver's eleven bands, finest at the young end). NOTE this endpoint uses different codes from `shopping-insight/*`, which takes 10/20/30/40/50/60. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/naver/search-trend?keywords=%EC%82%BC%EC%84%B1%EC%A0%84%EC%9E%90%2C%EA%B0%A4%EB%9F%AD%EC%8B%9C" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

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