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

> Returns a relative search-interest time series for a group of 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. Note the keywords form ONE combined series (their volumes are summed), not one series each; to compare terms against each other, call the endpoint once per term. 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 20, combined into ONE trend series (volumes summed, not compared). Required. To compare terms, issue one call per term. |
| `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, `1` to `11` (Naver's eleven bands, finest at the young end: `1` is 0-12, `11` is 60+). 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