Apinoa Docs

Search

Get one Naver results page, with every block in page order.

View raw .mdx
GET | POST /v1/naver/search

Send 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

ParameterTypeRequiredNotes
countryenumThe market, as an ISO 3166 country code. KR
cursorstringThe previous page's cursor. Pass it alone for the next page.
deviceenumWhich page to read: the desktop (default) or the mobile one. desktop mobile
limitinteger 1–100Results wanted (default 10, at most 100). More than one page is charged per page.
qstringThe query, search operators included.
timeRangeenumOnly results from this past period. hour day week month year
typeenumWhat 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

StatusCodeMeaning
400INVALID_CURSORThe cursor is not one this operation returned. Start again without it.
400INVALID_PARAMSA parameter is missing, unknown or out of range, or the engine does not take it. The message names it.
401UNAUTHORIZEDThe x-api-key header is missing, or the key is revoked or unknown.
402INSUFFICIENT_BALANCEThe balance does not cover this call. Top up in the dashboard.
429MARKETPLACE_SATURATEDToo many concurrent calls. Retry after the Retry-After seconds.
502UPSTREAM_ERRORThe engine answered with something unusable. Retry with backoff.
503SERVICE_UNAVAILABLEA 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.

On this page