Naver

Search Naver cafe articles

Search Naver cafe (community forum) articles by keyword, 30 a page.

GET/v1/naver/search/cafes
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
25

Endpoint-specific response payload.

dataquery
string

The search words, as sent.

datasort
string

The order used.

one of: relevance, date

Cafe articles, in Naver's order.

dataarticles[]rank
integer

Position in the results, from 1.

≥ 0

dataarticles[]title
string

Article title, highlight markup removed.

dataarticles[]url
string

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

dataarticles[]cafeId
stringnullable

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

dataarticles[]articleId
stringnullable

The article number in the cafe.

dataarticles[]snippet
stringnullable

Text excerpt.

dataarticles[]cafeName
stringnullable

The cafe's name.

dataarticles[]cafeUrl
stringnullable

The cafe's home URL.

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[]thumbnailUrl
stringnullable

Article image.

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

Responses

Naver cafe article search results.