Naver

Search Naver News

Search Naver News by keyword, with each article's publisher, date and related coverage.

GET/v1/naver/search/news
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
34

Endpoint-specific response payload.

dataquery
string

The search words, as sent.

datasort
string

The order used.

one of: relevance, date

News articles, in Naver's order.

dataarticles[]rank
integer

Position in the results, from 1.

≥ 0

dataarticles[]title
string

Headline, highlight markup removed.

dataarticles[]url
string

Article URL on the publisher's site.

dataarticles[]naverNewsUrl
stringnullable

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

dataarticles[]snippet
stringnullable

Text excerpt.

The publisher.

dataarticles[]pressname
stringnullable

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

dataarticles[]pressurl
stringnullable

Publisher page on Naver News.

dataarticles[]presslogoUrl
stringnullable

Publisher logo.

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

dataarticles[]publishedText
stringnullable

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

dataarticles[]pageLabel
stringnullable

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

dataarticles[]thumbnailUrl
stringnullable

Article image.

Related articles Naver groups under this one.

dataarticles[]related[]title
string

Headline.

dataarticles[]related[]url
string

Article URL on the publisher's site.

dataarticles[]related[]naverNewsUrl
stringnullable

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

dataarticles[]related[]pressName
stringnullable

Publisher name.

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

dataarticles[]related[]publishedText
stringnullable

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

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

Responses

Naver News search results.