Search
Get one Naver results page, with every block in page order.
GET | POST /v1/naver/searchSend parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.
Request
curl -G "https://gateway.apinoa.com/v1/naver/search" \
--data-urlencode "q=제주도 여행" \
-H "x-api-key: $APINOA_API_KEY"Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
country | enum | The market, as an ISO 3166 country code. KR | |
cursor | string | The previous page's cursor. Pass it alone for the next page. | |
device | enum | Which page to read: the desktop (default) or the mobile one. desktop mobile | |
limit | integer 1–100 | Results wanted (default 10, at most 100). More than one page is charged per page. | |
q | string | The query, search operators included. | |
timeRange | enum | Only results from this past period. hour day week month year | |
type | enum | What to search: web results (default), news, images or videos. web news images videos |
The same parameters, and every response type, are in the OpenAPI document.
Response
Returns ResultsPage in data. A real response, shortened: arrays keep their first entries and long text is cut.
{
"success": true,
"data": {
"engine": "naver",
"query": "제주도 여행",
"type": "web",
"outcome": "results",
"country": "KR",
"lang": "ko",
"device": "desktop",
"page": 1,
"items": [
{
"type": "ad",
"block": "top",
"url": "https://ader.naver.com/v1/DOP8VKF-E7rqPca3-poUhp4pweWQAlvUZZwUycnr9-2xt0UbNxa8IodbMJGVlZi9…",
"title": "제주도여행 특가 티오 제주 제주도 패키지 할인 에어카텔 특가",
"snippet": "조금더 알뜰한 제주도여행 , 주중/휴일 항공/숙소/렌트카 최대 90% 할인! 친절 상담, 재방문 & 만족도 100%",
"advertiser": "티오제주",
"displayUrl": "to-jeju.com",
"sitelinks": [
{
"url": "https://ader.naver.com/v1/uerU507GN-wSCmARZGbxsP3F2F-M9hqAaV2Ib8890xZxWQXM85HZzcAU9aK2WpB-…",
"title": "할인 에어카텔 묶을수록 할인!"
}
],
"ext": {"website": "http://www.to-jeju.com"},
"rank": 1,
"favicon": "https://search.pstatic.net/sunny?src=http%3A%2F%2Fwww.to-jeju.com%2Fimages%2Fsub%2F.ico&ty…",
"thumbnail": "https://searchad-phinf.pstatic.net/MjAyNTA5MTFfMTM4/MDAxNzU3NTY5NjUwNTM1.blal_q1dejQFIGl3y…"
},
{
"type": "ad",
"block": "top",
"url": "https://ader.naver.com/v1/F7DJv8YXih9wRHC6FhzUzNyz1-d1S4by03DRrv-eqPQKAGworfoqKNKnemUSeHh0…",
"title": "제주도여행 은 제주 바바 항공권부터 숙박, 렌트카까지",
"snippet": "제주도여행 , 항공+숙박+렌터카를 묶어서 한번에 OK!, 인기상품 71%D/C 특급호텔 특가전, 렌트카 특가전, 에어카텔 특가전 진행중~",
"advertiser": "제주바바",
"displayUrl": "jejubaba.com",
"sitelinks": [
{
"url": "https://ader.naver.com/v1/3TGXu_rgID0OAciKBPdynQXwyu23cU1ndgubIwb6AW107JksMiIs2Rgwc3_YyekR…",
"title": "톡톡 상담 제주여행문의하기"
}
],
"ext": {"website": "http://www.jejubaba.com", "services": ["네이버 톡톡"]},
"rank": 2,
"favicon": "https://search.pstatic.net/sunny?src=https%3A%2F%2Fwww.jejubaba.com%2Ffavicon.ico&type=f30…",
"thumbnail": "https://searchad-phinf.pstatic.net/MjAyNTExMDRfMTU3/MDAxNzYyMjIzMjQzMzAx.dCKVlNBV678yquqeK…"
},
{
"type": "other",
"kind": "block",
"title": "제주특별자치도",
"text": "제주특별자치도 국내인기지역 icon Jeju 전체 여행콘텐츠 상품예약 코스추천 도시정보 더보기 더보기 섬 전체가 하나의 거대한 관광자원인 제주도. 에메랄드빛 물빛…",
"links": [{"url": "https://travel.naver.com/domestic/14/summary", "title": "제주특별자치도"}],
"rank": 11
},
{
"type": "videoCarousel",
"title": "네이버 클립",
"items": [
{
"url": "https://m.naver.com/shorts/?mediaType=VOD&recId=%7B%22query%22%3A%22%EC%A0%9C%EC%A3%BC%EB%…",
"title": "26-1 제주갈치 충민정 #제주도 #제주도여행 #제주도맛집 #갈치구이...",
"channel": "모든리뷰샵",
"channelUrl": "https://clip.naver.com/@a11_mori",
"date": "2026-10-28",
"views": 133,
"thumbnail": "https://search.pstatic.net/common/?src=https%3A%2F%2Fclip-service-phinf.pstatic.net%2FMjAy…",
"video": "https://a02-g-smp-vod.akamaized.net/clip-home/c/read/v2/VOD_ALPHA/clip-home/81FA6BA6C0AA81…",
"avatar": "https://search.pstatic.net/common/?src=https%3A%2F%2Fclip-service-phinf.pstatic.net%2FMjAy…",
"certified": true,
"badge": "clipGold"
}
],
"rank": 13
}
],
"cursor": "2ghTTTaZIjcljKwKfuXUme91qVJQPyxJLxDjWRyTMP7iFkm-LMlIOTsFZYjkl8JaDZk0tKqHxE_ygoeSQSUrIl2mqn…",
"fetchedAt": "2026-10-30T01:00:09.136Z"
}
}Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_CURSOR | The cursor is not one this operation returned. Start again without it. |
| 400 | INVALID_PARAMS | A parameter is missing, unknown or out of range, or the engine does not take it. The message names it. |
| 401 | UNAUTHORIZED | The x-api-key header is missing, or the key is revoked or unknown. |
| 402 | INSUFFICIENT_BALANCE | The balance does not cover this call. Top up in the dashboard. |
| 429 | MARKETPLACE_SATURATED | Too many concurrent calls. Retry after the Retry-After seconds. |
| 502 | UPSTREAM_ERROR | The engine answered with something unusable. Retry with backoff. |
| 503 | SERVICE_UNAVAILABLE | A temporary failure. Retry with backoff. |
Every code is listed in Errors. Failed calls are not billed.
Pricing
Price $0.0012 per call, plus $0.0012 for each extra call it makes — at most 4 more, so $0.006 in total. List price; the rate steps down above 1,000 calls a day.