Naver

Search Naver images

Search Naver images by keyword, with the original image and the page it is on.

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

pageintegeroptionalquery

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

≥ 1 · ≤ 30

Response fields
27

Endpoint-specific response payload.

dataquery
string

The search words, as sent.

Images, in Naver's relevance order.

dataimages[]rank
integer

Position in the results, from 1.

≥ 0

dataimages[]id
string

Naver's image id.

dataimages[]title
stringnullable

Title of the page the image is on.

dataimages[]imageUrl
string

The original image URL.

dataimages[]thumbnailUrl
stringnullable

Naver's thumbnail of the image.

dataimages[]pageUrl
stringnullable

The page the image is on.

dataimages[]sourceName
stringnullable

Where the image comes from, e.g. `네이버 블로그` or `포토뉴스`.

dataimages[]sourceDomain
stringnullable

Host of the page, e.g. `news.naver.com`.

dataimages[]section
stringnullable

Naver's section for the source, e.g. `blog`, `news`, `cafe`, `web`.

dataimages[]width
integernullable

Original width in pixels.

dataimages[]height
integernullable

Original height in pixels.

dataimages[]isGif
boolean

Whether the image is an animated GIF.

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

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

Responses

Naver image search results.