Naver AI Mode API

GET   /api/v1/search?engine=naver_ai_mode

Send a question to the naver_ai_mode engine to receive a structured answer. Text answers include Markdown and text blocks. Additional result collections depend on the source answer.

To continue an answer, pass pagination.conversation_token with the next question. Flight durations, stopovers, delivery fees and property prices retain the source display text when no machine value is available.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    The question to send to Naver AI Mode, up to 800 characters.

Conversation

  • Name
    conversation_token
    Required
    Optional
    Description

    Use pagination.conversation_token from a fresh response to continue the conversation. Up to 512 characters.

Engine

  • Name
    engine
    Required
    Required
    Description

    Set to naver_ai_mode.

API key

  • Name
    api_key
    Required
    Required
    Description

    Your SearchAPI API key. You can also use the Authorization: Bearer header.

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set to true to disable persistent storage and request logging.

Response

Response
GET
https://www.searchapi.io/api/v1/search?engine=naver_ai_mode&q=%EB%8B%A4%EC%9D%8C%EB%8B%AC+%EC%9D%B8%EC%B2%9C%EC%97%90%EC%84%9C+%EC%98%A4%EC%82%AC%EC%B9%B4+%EC%99%95%EB%B3%B5+%ED%95%AD%EA%B3%B5%EA%B6%8C+%EC%B5%9C%EC%A0%80%EA%B0%80+%EC%95%8C%EB%A0%A4%EC%A4%98
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "naver_ai_mode",
  "q": "다음달 인천에서 오사카 왕복 항공권 최저가 알려줘"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_J2OR1XvYom9LFMkaoGra4w0N",
    "status": "Success",
    "created_at": "2026-11-05T17:04:55Z",
    "request_time_taken": 11.24,
    "parsing_time_taken": 0.0,
    "total_time_taken": 11.24,
    "request_url": "https://search.naver.com/search.naver?ssc=tab.ait.all&query=%EB%8B%A4%EC%9D%8C%EB%8B%AC+%EC%9D%B8%EC...",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_J2OR1XvYom9LFMkaoGra4w0N.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_J2OR1XvYom9LFMkaoGra4w0N"
  },
  "search_parameters": {
    "engine": "naver_ai_mode",
    "q": "다음달 인천에서 오사카 왕복 항공권 최저가 알려줘"
  },
  "text_blocks": [
    {
      "type": "paragraph",
      "answer": "다음 달 인천에서 오사카로 가는 왕복 항공권 최저가는 파라타항공 직항 244,900원입니다. 2026년 12월 8일 출발해 11일 돌아오는 일정이며, 성인 1명 일반석 기준이에요.",
      "reference_indexes": [
        0
      ]
    },
    ...
  ],
  "markdown": "다음 달 인천에서 오사카로 가는 왕복 항공권 최저가는 **파라타항공 직항 244,900원**입니다. 2026년 12월 8일 출발해 11일 돌아오는 일정이며, 성인 1명 일반석 기준이에요.\n\n### 직항 최저가 일정\n[인천 ↔ 오사카 항공권 (파라타항공 외)](https://ai-flight.naver.com/flights/international/ICN:airport-OSA:city-20261208/OSA:city-ICN:airport-20261211?adult=1&isDirect=true&fareType=Y&selectType=c...",
  "reference_links": [
    {
      "index": 0,
      "title": "인천 ↔ 오사카 항공권 (파라타항공 외)",
      "link": "https://ai-flight.naver.com/flights/international/ICN:airport-OSA:city-20261208/OSA:city-ICN:airport...",
      "source": "네이버 항공권",
      "snippet": "[직항] 가는날: 2026.12.08 오는날: 2026.12.11 | 가격: 244,900원 (성인 1인)",
      "favicon": "https://techminds.pstatic.net/flight/assets/vertical/images/favicon/flight.ico"
    },
    ...
  ],
  "web_results": [
    {
      "position": 1,
      "title": "인천 오사카 항공권 최저가 제주항공 173,400~ (8월 기준)",
      "link": "https://blog.naver.com/us_someday/224371102621",
      "source": "썸데이",
      "platform": "네이버 블로그",
      "snippet": "항공권은 타이밍이 전부라, 이런 건 발견하는 즉시 공유하는 게 맞는 것 같아서 정리해 봤습니다. 인천 오사카 가격 바로 확인해 보세요! 오늘 확인한 최저가 인천(ICN) → 오사카(KIX) 왕복 기준, 8월 26일(수)부터 8월 28일(금)까지 3일 일정으로 검색했더니 173,400원이...",
      "date": "2026-08-07T05:39:00Z",
      "favicon": "https://blogpfthumb-phinf.pstatic.net/MjAyNTEyMzBfMTI2/MDAxNzY3MDMxMzU4MjU2.-K5HlNl6pIcp4TgLUO776mBd...",
      "ref_id": "90000003_00000000000000343D8F539D"
    },
    ...
  ],
  "cards": [
    {
      "type": "flight",
      "position": 1,
      "title": "인천 ↔ 오사카 항공권 (파라타항공 외)",
      "flight_id": "20261208|ICN|OSA|WE-20261211|OSA|ICN|WE",
      "link": "https://ai-flight.naver.com/flights/international/ICN:airport-OSA:city-20261208/OSA:city-ICN:airport...",
      "flight_type": "round_trip",
      "origin": {
        "city": "인천",
        "country": "대한민국",
        "airport_code": "ICN"
      },
      "destination": {
        "city": "오사카",
        "country": "일본"
      },
      "departure_date": "2026-12-08",
      "return_date": "2026-12-11",
      "travel_class": "일반석",
      "price": "244,900원",
      "extracted_price": 244900,
      "description": "[직항] 가는날: 2026.12.08 오는날: 2026.12.11 | 가격: 244,900원 (성인 1인)",
      "airline": "파라타항공",
      "airline_logo": "https://techminds.pstatic.net/flight/vertical-static/flight/airlines/WE.png",
      "airline_code": "WE",
      "stopover": "직항",
      "duration": "1시간 50분",
      "passengers": "성인 1",
      "has_more_flights": true,
      "is_featured": true,
      "is_price_confirmed": false
    },
    ...
  ],
  "search_queries": [
    "다음달 인천에서 오사카 왕복 항공권 최저가 알려줘"
  ],
  "response_metadata": {
    "conversation_id": "67ed0274b0d8493f",
    "turn": 1,
    "topic": "local",
    "topics": [
      {
        "name": "transportation",
        "score": 0.9727
      }
    ],
    "refined_query": "다음달 인천에서 오사카 왕복 항공권 최저가 알려줘"
  },
  "pagination": {
    "conversation_token": "eyJjaGF0X2lkIjoiNjdlZDAyNzRiMGQ4NDkzZiIsInNlc3Npb24iOiJB..."
  }
}

Inline Images

Inline Images
GET
https://www.searchapi.io/api/v1/search?engine=naver_ai_mode&q=%ED%95%9C%EA%B5%AD%EC%97%90%EC%84%9C+%EA%B0%80%EC%9E%A5+%EC%9C%A0%EB%AA%85%ED%95%9C+%EB%AA%85%EC%86%8C+10%EA%B3%B3%EC%9D%98+%EC%9D%B4%EB%AF%B8%EC%A7%80
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "naver_ai_mode",
  "q": "한국에서 가장 유명한 명소 10곳의 이미지"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "inline_images": [
    {
      "position": 1,
      "title": "한국 여행지 추천: 유명한 명소 탐방하기",
      "link": "http://blog.naver.com/qdqy2380/223107879416",
      "thumbnail": "http://blogfiles.naver.net/MjAyMzA1MjFfMjAx/MDAxNjg0NjYxODA1ODA0.pW_a4IHz55-PXt_XrtTw7OaxYn5Oi9SuXhg...",
      "platform": "네이버 블로그",
      "source": "Dot.style",
      "date": "2023-05-21T09:36:00Z",
      "ref_id": "blog_95966243e15f6448c39671f73730c5f1",
      "favicon": "http://blogpfthumb.phinf.naver.net/MjAyMzA0MjFfMjgz/MDAxNjgyMDMwNjI1MjQ3.8XcVUyMwI14jzkb7AsvspZBr7QR...",
      "is_featured": true
    },
    ...
  ]
}

Inline Shopping

Inline Shopping
GET
https://www.searchapi.io/api/v1/search?engine=naver_ai_mode&q=%EB%AC%B4%EC%84%A0+%EC%9D%B4%EC%96%B4%ED%8F%B0+%EC%B6%94%EC%B2%9C
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "naver_ai_mode",
  "q": "무선 이어폰 추천"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "inline_shopping": [
    {
      "position": 1,
      "title": "필립스 커널형 무선 블루투스 이어폰 TAT1109",
      "product_id": "90648198024",
      "ref_id": "00000009_00151b0dbb88",
      "link": "https://product.shopping.naver.com/inflow/outlink/ai-tab?p=13103686932&tr=aitab",
      "category_id": "50000003:50000209:50024379:50024439",
      "price": "19,900",
      "extracted_price": 19900,
      "delivery_fee": "무료배송",
      "seller": "필립스 오디오 공식몰",
      "thumbnail": "https://shopping-phinf.pstatic.net/main_9064819/90648198024.jpg",
      "original_price": "99,000",
      "extracted_original_price": 99000,
      "discount_percentage": 79,
      "rating": 4.74,
      "reviews": 3918,
      "description": "품목_M : 블루투스이어폰 | 블루투스버전_M : 블루투스5.4 | 형태_M : 무선, 커널형 | 사용범위_M : 10m이내 | 드라이버_M : 1cm | 코덱_M : SBC | 음압감도_M : 97dB | 주파수응답_M : 20~20000Hz | 조작기능_M : 터치버튼 | 방수등급_...",
      "extensions": [
        "official",
        ...
      ],
      "delivery_info": {
        "type": "tomorrow",
        "arrival_date": "11.7.(토) 도착"
      },
      "best_pick": {
        "type": "fastDelivery",
        "label": "배송 빠른",
        "delivery_arrival": "tomorrow"
      },
      "is_featured": true
    },
    ...
  ]
}

Inline Videos

Inline Videos
GET
https://www.searchapi.io/api/v1/search?engine=naver_ai_mode&q=2026%EB%85%84+%EC%9C%A0%ED%8A%9C%EB%B8%8C%EC%97%90%EC%84%9C+%EA%B0%80%EC%9E%A5+%EB%A7%8E%EC%9D%B4+%EC%A1%B0%ED%9A%8C%EB%90%9C+%EB%AE%A4%EC%A7%81%EB%B9%84%EB%94%94%EC%98%A4
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "naver_ai_mode",
  "q": "2026년 유튜브에서 가장 많이 조회된 뮤직비디오"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "inline_videos": [
    {
      "position": 1,
      "title": "유튜브에서 싫어요 가장많이 받은 비버의 레전드 노래",
      "link": "https://www.youtube.com/watch?v=1GzYbxpfH00",
      "thumbnail": "https://i.ytimg.com/vi/1GzYbxpfH00/maxresdefault.jpg",
      "source": "YouTube",
      "channel": "레몬사이다",
      "date": "2025-09-23T07:13:00Z",
      "description": "〈Baby〉는 캐나다 출신 팝 가수 저스틴 비버(Justin Bieber)가 2010년에 발표한 곡으로, 그의 대표곡이자 세계적인 스타로 도약하게 만든 결정적인 히트곡입니다. 이 곡은 첫 정규 앨범 《My World 2.0》에 수록되었으며, 미국의 래퍼 루다크리스(Ludacris)가 피...",
      "ref_id": "a00000fa_29601a87848e0daabc4ed13d",
      "is_featured": true
    },
    ...
  ]
}

Local Results

Local Results
GET
https://www.searchapi.io/api/v1/search?engine=naver_ai_mode&q=%EC%84%9C%EC%9A%B8+%EB%A7%9B%EC%A7%91+%EC%B6%94%EC%B2%9C
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "naver_ai_mode",
  "q": "서울 맛집 추천"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "local_results": [
    {
      "position": 1,
      "title": "몽브루",
      "place_id": "1068275528",
      "link": "https://map.naver.com/p/entry/place/1068275528?entry=pai&placePath=%2Fhome%3Fentry%3Dpai",
      "type": "카페,디저트",
      "category_id": "220563",
      "address": "서울 강북구 수유동",
      "gps_coordinates": {
        "latitude": 37.6437493,
        "longitude": 127.0038848
      },
      "description": "카페|디저트-일반 | 옵션: 포장,남/녀 화장실 구분,무선 인터넷,예약,단체 이용 가능,제로페이,지역화폐 (카드형),지역화폐 (모바일형),간편결제,주차,반려동물 동반 | 운영: 2026-11-06(금) 11:00~23:00 (오늘), 2026-11-07(토) 11:00~23:00, 20...",
      "open_state": "영업 종료",
      "reviews": 3573,
      "thumbnail": "https://ldb-phinf.pstatic.net/20241109_8/1731127615912qKkGH_JPEG/KakaoTalk_20241109_134129812_04.jpg",
      "images": [
        "https://ldb-phinf.pstatic.net/20241109_8/1731127615912qKkGH_JPEG/KakaoTalk_20241109_134129812_04.jpg",
        ...
      ],
      "reservation": "https://pcmap.place.naver.com/place/1068275528/booking?entry=pai&service-target=aitab",
      "extensions": [
        "placePlus"
      ],
      "is_featured": true
    },
    ...
  ]
}