Naver

Get Naver search brief

Get the top Naver blog posts, news, cafe articles, KnowledgeiN questions and web documents for a keyword.

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

API key (`sfk_...`)

Parameters
2
querystringrequiredquery

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

min 1 chars · max 200 chars

limitintegeroptionalquery

Results to keep from each source, 1 to 10.

≥ 1 · ≤ 10

Response fields
91

Endpoint-specific response payload.

dataquery
string

The search words, as sent.

Whether each source answered.

datasectionsblogs
string

`included`: the section is complete. `unavailable`: Naver did not answer for it this time, so it is empty; the other sections are complete.

one of: included, unavailable

datasectionsnews
string

`included`: the section is complete. `unavailable`: Naver did not answer for it this time, so it is empty; the other sections are complete.

one of: included, unavailable

datasectionscafes
string

`included`: the section is complete. `unavailable`: Naver did not answer for it this time, so it is empty; the other sections are complete.

one of: included, unavailable

datasectionskin
string

`included`: the section is complete. `unavailable`: Naver did not answer for it this time, so it is empty; the other sections are complete.

one of: included, unavailable

datasectionsweb
string

`included`: the section is complete. `unavailable`: Naver did not answer for it this time, so it is empty; the other sections are complete.

one of: included, unavailable

Top blog posts, without ads.

datablogs[]rank
integer

Position among the posts (organic results), from 1. Ads never take a rank here.

≥ 0

datablogs[]title
string

Post title, highlight markup removed.

datablogs[]url
string

Post URL.

datablogs[]blogId
stringnullable

Blog id of a Naver blog post; null for other blog hosts.

datablogs[]postId
stringnullable

Post number (`logNo`) of a Naver blog post.

datablogs[]snippet
stringnullable

Text excerpt Naver shows.

datablogs[]blogName
stringnullable

Name of the blog.

datablogs[]blogUrl
stringnullable

Blog home URL.

datablogs[]blogImageUrl
stringnullable

Blog profile image.

datablogs[]publishedAt
stringnullable

When it was published, ISO 8601. Worked out from the date Naver prints, so it is exact to the unit printed (`5분 전` to the minute, `2026.11.14.` to the day); null when Naver printed no date.

datablogs[]publishedText
stringnullable

The date as Naver printed it, e.g. `3시간 전` or `2026.11.14.`.

Images Naver previews from the post, at full size.

datablogs[]imageUrls[]
stringoptional
datablogs[]imageCount
integernullable

How many images the post has, as Naver counts them.

datablogs[]isAd
boolean

Whether the result is a paid ad: always `false` in `posts`, `true` in `ads`.

Top news articles.

datanews[]rank
integer

Position in the results, from 1.

≥ 0

datanews[]title
string

Headline, highlight markup removed.

datanews[]url
string

Article URL on the publisher's site.

datanews[]naverNewsUrl
stringnullable

The same article on Naver News, when it is there.

datanews[]snippet
stringnullable

Text excerpt.

The publisher.

datanews[]pressname
stringnullable

Publisher name, e.g. `연합뉴스`.

datanews[]pressurl
stringnullable

Publisher page on Naver News.

datanews[]presslogoUrl
stringnullable

Publisher logo.

datanews[]publishedAt
stringnullable

When it was published, ISO 8601. Worked out from the date Naver prints, so it is exact to the unit printed (`5분 전` to the minute, `2026.11.14.` to the day); null when Naver printed no date.

datanews[]publishedText
stringnullable

The date as Naver printed it, e.g. `3시간 전` or `2026.11.14.`.

datanews[]pageLabel
stringnullable

Print placement Naver shows for a newspaper, e.g. `A22면 TOP`.

datanews[]thumbnailUrl
stringnullable

Article image.

Related articles Naver groups under this one.

datanews[]related[]title
string

Headline.

datanews[]related[]url
string

Article URL on the publisher's site.

datanews[]related[]naverNewsUrl
stringnullable

The same article on Naver News, when it is there.

datanews[]related[]pressName
stringnullable

Publisher name.

datanews[]related[]publishedAt
stringnullable

When it was published, ISO 8601. Worked out from the date Naver prints, so it is exact to the unit printed (`5분 전` to the minute, `2026.11.14.` to the day); null when Naver printed no date.

datanews[]related[]publishedText
stringnullable

The date as Naver printed it, e.g. `3시간 전` or `2026.11.14.`.

Top cafe articles.

datacafes[]rank
integer

Position in the results, from 1.

≥ 0

datacafes[]title
string

Article title, highlight markup removed.

datacafes[]url
string

Article URL, `cafe.naver.com/<cafe>/<article>`.

datacafes[]cafeId
stringnullable

The cafe's URL name, e.g. `kleagueworld`.

datacafes[]articleId
stringnullable

The article number in the cafe.

datacafes[]snippet
stringnullable

Text excerpt.

datacafes[]cafeName
stringnullable

The cafe's name.

datacafes[]cafeUrl
stringnullable

The cafe's home URL.

datacafes[]publishedAt
stringnullable

When it was published, ISO 8601. Worked out from the date Naver prints, so it is exact to the unit printed (`5분 전` to the minute, `2026.11.14.` to the day); null when Naver printed no date.

datacafes[]publishedText
stringnullable

The date as Naver printed it, e.g. `3시간 전` or `2026.11.14.`.

datacafes[]thumbnailUrl
stringnullable

Article image.

Top KnowledgeiN questions.

datakin[]rank
integer

Position in the results, from 1.

≥ 0

datakin[]title
string

Question title, highlight markup removed.

datakin[]url
string

Question URL on KnowledgeiN.

datakin[]questionId
stringnullable

The question's `docId`.

datakin[]directoryId
stringnullable

The question's category id (`dirId`).

datakin[]snippet
stringnullable

Excerpt of the question and its answer.

Category path, e.g. `["Q&A", "축구"]`.

datakin[]category[]
stringoptional

Tags, without the leading `#`.

datakin[]tags[]
stringoptional
datakin[]answerCount
integernullable

Number of answers.

datakin[]upvotes
integernullable

Upvotes (`UP`).

datakin[]answeredBy
stringnullable

Masked id of the answerer Naver shows, e.g. `ihj9****`.

datakin[]publishedAt
stringnullable

When it was published, ISO 8601. Worked out from the date Naver prints, so it is exact to the unit printed (`5분 전` to the minute, `2026.11.14.` to the day); null when Naver printed no date.

datakin[]publishedText
stringnullable

The date as Naver printed it, e.g. `3시간 전` or `2026.11.14.`.

Top web documents.

dataweb[]rank
integer

Position in the results, from 1.

≥ 0

dataweb[]title
string

Page title, highlight markup removed.

dataweb[]url
string

Page URL.

dataweb[]snippet
stringnullable

Text excerpt.

dataweb[]siteName
stringnullable

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

dataweb[]siteUrl
stringnullable

Site home URL.

dataweb[]displayUrl
stringnullable

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

dataweb[]faviconUrl
stringnullable

Site icon.

dataweb[]imageUrl
stringnullable

Preview image, when Naver shows one.

dataweb[]notice
stringnullable

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

datanewestAt
stringnullable

The most recent publication time across the dated results, ISO 8601.

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

Responses

Naver search brief across sources.