Naver

Search Naver web documents

Get the web documents Naver shows for a keyword on its main results page.

GET/v1/naver/search/web
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
19

Endpoint-specific response payload.

dataquery
string

The search words, as sent.

Web documents, in Naver's order.

datadocuments[]rank
integer

Position in the results, from 1.

≥ 0

datadocuments[]title
string

Page title, highlight markup removed.

datadocuments[]url
string

Page URL.

datadocuments[]snippet
stringnullable

Text excerpt.

datadocuments[]siteName
stringnullable

Site name Naver shows, e.g. `나무위키`.

datadocuments[]siteUrl
stringnullable

Site home URL.

datadocuments[]displayUrl
stringnullable

The breadcrumb Naver prints under the title, e.g. `namu.wiki › 손흥민`.

datadocuments[]faviconUrl
stringnullable

Site icon.

datadocuments[]imageUrl
stringnullable

Preview image, when Naver shows one.

datadocuments[]notice
stringnullable

Naver's note on the result, e.g. that the site is user-edited.

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

Responses

Naver web document results.