Naver

Search the Naver encyclopedia

Search Naver's encyclopedia (지식백과) by keyword: the first 30 dictionary entries, articles and explainer videos.

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

API key (`sfk_...`)

Parameters
1
querystringrequiredquery

Search words, in Korean or any other language, e.g. `손흥민`. Control characters are removed.

min 1 chars · max 200 chars

Response fields
26

Endpoint-specific response payload.

dataquery
string

The search words, as sent.

Encyclopedia entries, in Naver's relevance order.

dataentries[]rank
integer

Position in the results, from 1.

≥ 0

dataentries[]id
string

The entry's id, the last part of its URL, e.g. `1ys3nI3eT9u0G4NTirfz0Z`.

dataentries[]title
string

Entry title, highlight markup removed.

dataentries[]url
string

Entry URL on Naver's encyclopedia (지식백과).

The entry's title in other languages, e.g. `Son Heung Min`.

dataentries[]otherTitles[]language
stringnullable

Language code Naver gives, e.g. `en`.

dataentries[]otherTitles[]text
string

The title in that language.

dataentries[]summary
stringnullable

Opening text of the entry, as Naver shows it.

dataentries[]category
stringnullable

Naver's subject for the entry, e.g. `시사·상식`.

The dictionary or publication the entry comes from.

dataentries[]sourceid
stringnullable

The source's id on Naver.

dataentries[]sourcename
stringnullable

The reference work it comes from, e.g. `시사상식사전`.

dataentries[]contentType
stringnullable

Naver's kind of entry, e.g. `skb` (dictionary entry), `doc`, `magazine` or `long_form_video`.

dataentries[]videoDuration
stringnullable

Length of a video entry as Naver prints it, e.g. `4:03`.

dataentries[]thumbnailUrl
stringnullable

The entry's image.

dataentries[]likeCount
integernullable

Likes on the entry.

datahasMore
boolean

Whether Naver has more entries than these. Only the first 30 can be fetched: Naver loads the rest only in its own page.

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/search/encyclopedia?query=손흥민" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Naver encyclopedia entries.