Naver

Search Naver blogs

Search Naver blog posts by keyword, by relevance or newest first, 30 a page, with any ads listed apart.

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

API key (`sfk_...`)

Parameters
3
querystringrequiredquery

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

min 1 chars · max 200 chars

pageintegeroptionalquery

Page number, from 1. Naver serves at most 30 pages of a search.

≥ 1 · ≤ 30

sortstringoptionalquery

`relevance` (Naver's default order) or `date` (newest first).

one of: relevance, date

Response fields
46

Endpoint-specific response payload.

dataquery
string

The search words, as sent.

datasort
string

The order used.

one of: relevance, date

Blog posts, in Naver's order, without ads.

dataposts[]rank
integer

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

≥ 0

dataposts[]title
string

Post title, highlight markup removed.

dataposts[]url
string

Post URL.

dataposts[]blogId
stringnullable

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

dataposts[]postId
stringnullable

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

dataposts[]snippet
stringnullable

Text excerpt Naver shows.

dataposts[]blogName
stringnullable

Name of the blog.

dataposts[]blogUrl
stringnullable

Blog home URL.

dataposts[]blogImageUrl
stringnullable

Blog profile image.

dataposts[]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.

dataposts[]publishedText
stringnullable

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

Images Naver previews from the post, at full size.

dataposts[]imageUrls[]
stringoptional
dataposts[]imageCount
integernullable

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

dataposts[]isAd
boolean

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

Paid ads Naver showed among this page's posts, in page order. Usually empty for non-commercial words.

dataads[]rank
integer

Position among this page's ad slots, from 1. Naver can show the same ad in more than one slot.

≥ 0

dataads[]title
string

Post title, highlight markup removed.

dataads[]url
string

Naver's ad click link, which leads to the advertiser's post.

dataads[]blogId
stringnullable

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

dataads[]postId
stringnullable

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

dataads[]snippet
stringnullable

Text excerpt Naver shows.

dataads[]blogName
stringnullable

Name of the blog.

dataads[]blogUrl
stringnullable

Blog home URL.

dataads[]blogImageUrl
stringnullable

Blog profile image.

dataads[]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.

dataads[]publishedText
stringnullable

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

Images Naver previews from the post, at full size.

dataads[]imageUrls[]
stringoptional
dataads[]imageCount
integernullable

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

dataads[]isAd
boolean

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

dataads[]afterPostRank
integer

Rank of the last post above the ad on the page; 0 when the ad comes before the first post of page 1.

≥ 0

Pagination state for the current page.

datapagepage
integer

Current page number (1-based).

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page number when more pages exist; null on the last page.

≥ 0

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

Responses

Naver blog search results.