Naver

Get Naver Shopping category trend

Get how often Naver Shopping users clicked into a category over time.

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

API key (`sfk_...`)

Parameters
7
categorystringrequiredquery

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

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

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
18

Endpoint-specific response payload.

datalookupStatus
string

`not_found` for an unknown category id; `no_data` when the category had no 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

The series, oldest first.

datapoints[]date
string

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

datapoints[]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/shopping-category?category=50000000" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Naver Shopping category click trend.