Apinoa Docs

Search

获取一页 Naver 搜索结果,所有区块按页面顺序返回。

查看原始 .mdx
GET | POST /v1/naver/search

参数可以用 GET 的查询字符串发送,也可以用 POST 的 JSON 请求体发送,两者等价。

请求

curl -G "https://gateway.apinoa.com/v1/naver/search" \
  --data-urlencode "q=제주도 여행" \
  -H "x-api-key: $APINOA_API_KEY"

参数

参数类型必填说明
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

这些参数及所有响应类型也写在OpenAPI 文档中。

响应

在 data 中返回 ResultsPage。 真实响应的节选:数组只保留前几项,长文本已截断。

{
  "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"
  }
}

错误

状态代码含义
400INVALID_CURSOR该 cursor 不是本操作返回的。请不带它重新开始。
400INVALID_PARAMS参数缺失、未知、超出范围,或该引擎不接受。消息中会指出是哪一个。
401UNAUTHORIZED缺少 x-api-key 请求头,或密钥已吊销或未知。
402INSUFFICIENT_BALANCE余额不足以支付本次调用。请在控制台充值。
429MARKETPLACE_SATURATED并发调用过多。请等待 Retry-After 秒后重试。
502UPSTREAM_ERROR引擎返回了无法使用的内容。请退避后重试。
503SERVICE_UNAVAILABLE临时故障。请退避后重试。

全部错误代码见 Errors。失败的调用不计费。

价格

价格 每次调用 $0.0012,每多一次调用加 $0.0012——最多再加 4 次,合计最多 $0.006。标价;单日调用超过 1,000 次后单价下调。

本页内容