Naver AI Mode API
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.
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
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
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
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
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
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
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
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
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
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
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
},
...
]
}