Retrieve Naver search results in structured JSON. where=web (default) returns organic_results with title, link, snippet, displayed link and source; where=news returns news_results with title, link, snippet, thumbnail and the publisher with its relative time. Korean text stays UTF-8 clean end-to-end. Pagination uses a 1-based start offset (step 15 for web, 10 for news). has_more comes from the real upstream next-page button.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
3 optional filters available.
string
Required
Search query in Korean or any language (max 500 characters). URL-encoded UTF-8.
coffee shops
string
Optional
Search vertical: web (general) or news.
example
integer
Optional
Result offset (1-based). Web step: 15, news step: 10.
0
integer
Optional
Sort order: 0=relevance (default), 1=date, 2=age.
relevance
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 400
Missing required query parameter
HTTP 422
Invalid parameter: where must be web or news, start must be >= 1, sort must be 0, 1 or 2
HTTP 503
Naver upstream is temporarily unavailable. Please retry shortly.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.