Naver

Get Naver Shopping keyword trend

Get how often Naver Shopping users clicked on up to five keywords inside a category over time.

GET/v1/naver/trends/shopping-keywords
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
8
categorystringrequiredquery

Naver Shopping category id, e.g. `50000000` (패션의류). List them with the shopping categories endpoint.

pattern: ^[0-9]{8}$

queryarrayrequiredquery

Shopping keywords to compare inside the category, 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: `10s`, `20s`, `30s`, `40s`, `50s`, `60s`. Default: every age.

any of: 10s, 20s, 30s, 40s, 50s, 60s (comma-separated)

Response fields
20

Endpoint-specific response payload.

datalookupStatus
string

`not_found` for an unknown category id; `no_data` when none of the keywords had clicks in the period.

one of: found, not_found, no_data

A Naver Shopping category.

datacategoryid
string

Category id.

datacategoryname
stringnullable

Category name.

datacategorypath
stringnullable

Full path, e.g. `패션의류 > 여성의류`.

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 keyword, in the order given.

dataseries[]query
string

The keyword.

The series, oldest first. Every keyword in the answer has the same periods, with null where it had no clicks; a period no keyword had clicks in is 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
numbernullable

Relative interest, 0 to 100: 100 is the highest point across every keyword in this answer. Null when the keyword had no clicks in a period another keyword had.

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/shopping-keywords?category=50000000&query=원피스,코트" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Naver Shopping keyword click trends.