Naver

Get Naver search trend

Get how often people searched Naver for up to five keywords over time.

GET/v1/naver/trends/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
7
queryarrayrequiredquery

Search terms to compare, comma-separated, up to 5, e.g. `아이폰,갤럭시`.

startDatestringoptionalquery

First day, `YYYY-MM-DD`. Default: one year before `endDate`.

pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$

endDatestringoptionalquery

Last day, `YYYY-MM-DD`. Default: yesterday in Korea.

pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$

timeUnitstringoptionalquery

One point per `date` (day), `week` or `month`.

one of: date, week, month

devicestringoptionalquery

Only searches or clicks from this device. Default: both.

one of: pc, mobile

genderstringoptionalquery

Only this gender. Default: both.

one of: female, male

agesarrayoptionalquery

Only these age groups, comma-separated: `0-12`, `13-18`, `19-24`, `25-29`, `30-34`, `35-39`, `40-44`, `45-49`, `50-54`, `55-59`, `60+`. Default: every age.

any of: 0-12, 13-18, 19-24, 25-29, 30-34, 35-39, 40-44, 45-49, 50-54, 55-59, 60+ (comma-separated)

Response fields
16

Endpoint-specific response payload.

datalookupStatus
string

`no_data` when Naver has no search volume for any of the terms.

one of: found, no_data

datastartDate
string

First day the points cover, `YYYY-MM-DD`. For a weekly or monthly search trend this is the first day of the month the requested start falls in: Naver counts those from the month's start.

dataendDate
string

Last day used, `YYYY-MM-DD`.

datatimeUnit
string

Period of each point.

one of: date, week, month

One series per term, in the order given.

dataseries[]query
string

The term.

The series, oldest first; periods with no data are left out.

dataseries[]points[]date
string

Start of the period, `YYYY-MM-DD` (the day, the week's Monday, or the month's first day).

dataseries[]points[]value
number

Relative interest, 0 to 100: 100 is the highest point across every series in this answer.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/naver/trends/search?query=아이폰,갤럭시" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Naver search volume trend.