Naver News API Documentation
Search the news tab of Naver, South Korea's leading search engine, and retrieve each article's headline, outlet and publication date, with a publisher link, snippet, thumbnail, print edition page and related articles when available, as structured JSON, 10 results per page for up to 2,000 results per query.
API Parameters
Search Query
-
- Name
-
q - Required
- Required
- Description
-
This parameter is used for the terms you want to search on Naver News, such as
삼성전자orhyundai motor ev. Korean, English and other languages are supported. Quoted phrases and the minus operator have no effect on Naver News.
Sorting
-
- Name
-
sort_by - Required
- Optional
- Description
-
Sets the order of the results. Available values are:
-
relevanceDefault most_recentNewest articles first.oldestOldest articles first.
-
Filters
-
- Name
-
time_period - Required
- Optional
- Description
-
Restricts results to articles published within a recent time window. Available values are:
last_hourlast_2_hourslast_3_hourslast_4_hourslast_5_hourslast_6_hourslast_daylast_weeklast_monthlast_3_monthslast_6_monthslast_year
-
- Name
-
time_period_min - Required
- Optional
- Description
-
Start date of a custom date range, in
MM/DD/YYYYformat, such as06/01/2002, between01/01/1990and today in Korea. Withouttime_period_max, the range ends today. A custom range takes precedence overtime_period.
-
- Name
-
time_period_max - Required
- Optional
- Description
-
End date of a custom date range, in
MM/DD/YYYYformat, such as06/30/2002, between01/01/1990and today in Korea. Withouttime_period_min, the range starts on01/01/1990, the earliest date Naver News covers.
-
- Name
-
press_id - Required
- Optional
- Description
-
Restricts results to one outlet, by its Naver press code, such as
1032for 경향신문 or1001for 연합뉴스. A result'spress_id, when present, holds its outlet's code. Check the full list of Naver News press codes.
-
- Name
-
article_type - Required
- Optional
- Description
-
Restricts results to one kind of article. Available values are:
videoVideo clips.printArticles from a newspaper's print edition, with theirnewspaper_page.press_releasePress releases.auto_generatedArticles Naver News labels as automatically generated.
Pagination
-
- Name
-
page - Required
- Optional
- Description
-
Page of results to return, from
1(default) to200. Each page has 10 results, and Naver News returns up to 2,000 results per query.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
naver_news.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Full Response
https://www.searchapi.io/api/v1/search?engine=naver_news&q=%EC%82%BC%EC%84%B1%EC%A0%84%EC%9E%90
- 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_news",
"q": "삼성전자"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_ZFoJXlG716gRAzRPPfbi2TDJ",
"status": "Success",
"created_at": "2026-11-12T14:45:40Z",
"request_time_taken": 4.03,
"parsing_time_taken": 0.04,
"total_time_taken": 4.07,
"request_url": "https://search.naver.com/search.naver?where=news&ssc=tab.news.all&query=%EC%82%BC%EC%84%B1%EC%A0%84%...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_ZFoJXlG716gRAzRPPfbi2TDJ.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_ZFoJXlG716gRAzRPPfbi2TDJ"
},
"search_parameters": {
"engine": "naver_news",
"q": "삼성전자"
},
"organic_results": [
{
"position": 1,
"title": "삼성 AI 안경 베일 벗었다…12월 10일 국내 출시·65만원부터",
"link": "https://www.yna.co.kr/view/AKR20261112140300017?input=1195m",
"source": "연합뉴스",
"source_link": "https://media.naver.com/press/001",
"press_id": "1001",
"favicon": "https://search.pstatic.net/common/?src=https%3A%2F%2Fmimgnews.pstatic.net%2Fimage%2Fupload%2Foffice_...",
"date": "45분 전",
"snippet": "구글 제미나이 탑재…번역·길 안내·회의자료 요약 지원 젠틀몬스터 등 30종 공개…국내에는 16종 출시 삼성전자가 구글, 젠틀몬스터, 워비파커와 협업한 인공지능(AI) 안경 '인텔리전트 아이웨어'를 공개하고 다음 달 한국과 미국 시장에 출시한다. 삼성전자는 12일(현지시간) 미국 뉴욕에서 젠틀몬스터... ",
"thumbnail": "https://search.pstatic.net/common/?src=https%3A%2F%2Fimgnews.pstatic.net%2Fimage%2Forigin%2F001%2F20...",
"naver_news_link": "https://n.news.naver.com/mnews/article/001/0016439479?sid=105",
"is_press_pick": true,
"related_news": [
{
"title": "삼성, AI글라스 출격…\"실시간 통역·관광 가이드 가능\"",
"link": "https://www.hankyung.com/article/2026111238961",
"source": "한국경제",
"press_id": "1015",
"date": "44분 전",
"naver_news_link": "https://n.news.naver.com/mnews/article/015/0005353398?sid=101",
"is_press_pick": true
},
"..."
],
"related_news_count": 15,
"related_news_link": "https://search.naver.com/search.naver?de=&docid=0010016439479&ds=&field=0&mynews=0&news_office_check..."
},
"..."
],
"pagination": {
"current_page": 1,
"next_page": 2
}
}
The organic_results array holds the articles in page order. link opens the article on the
outlet's website and naver_news_link opens its copy on Naver News, which outlets that do not partner with
Naver lack. date is shown as Naver shows it: a relative age such as 3시간 전 for recent
articles and a date such as 2026.10.07. for older ones. Naver shortens long headlines with an ellipsis.
related_news lists the articles on the same story that Naver shows under a result. When Naver groups more
of them, related_news_count gives their number and related_news_link opens the full list.
is_press_pick and is_video appear only when they are true. Pass a result's
press_id back as the press_id parameter to search that outlet only.
Sort and Time Period
https://www.searchapi.io/api/v1/search?engine=naver_news&q=%EA%B8%88%EB%A6%AC&sort_by=most_recent&time_period=last_day
- 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_news",
"q": "금리",
"sort_by": "most_recent",
"time_period": "last_day"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_mCDBudqZFLCk94py7koLiToa",
"status": "Success",
"created_at": "2026-11-12T14:45:47Z",
"request_time_taken": 1.69,
"parsing_time_taken": 0.02,
"total_time_taken": 1.71,
"request_url": "https://search.naver.com/search.naver?where=news&ssc=tab.news.all&query=%EA%B8%88%EB%A6%AC&sort=1&pd...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_mCDBudqZFLCk94py7koLiToa.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_mCDBudqZFLCk94py7koLiToa"
},
"search_parameters": {
"engine": "naver_news",
"q": "금리",
"sort_by": "most_recent",
"time_period": "last_day"
},
"organic_results": [
{
"position": 1,
"title": "“AI 버블 언젠가는 꺼져… 한국 고통스러울 것”",
"link": "https://www.kmib.co.kr/article/20261112502108",
"source": "국민일보",
"source_link": "https://media.naver.com/press/005",
"press_id": "1005",
"favicon": "https://search.pstatic.net/common/?src=https%3A%2F%2Fmimgnews.pstatic.net%2Fimage%2Fupload%2Foffice_...",
"date": "9분 전",
"newspaper_page": "27면 1단",
"snippet": "로고프 교수는 저성장·저금리가 장기간 지속될 것이라는 이른바 ‘장기침체론’에 반대해온 경제학자다. 그는 AI가 풍요로운 세상을 만들어내고, 물가를 끌어내려 중앙은행이 금리를 올릴 필요가 없다고 한 일론 머스크 테슬라 최고경영자(CEO)의 주장을 거론하며 “인플레이션과 거시경제에 관한 그의 발언은... ",
"thumbnail": "https://search.pstatic.net/common/?src=https%3A%2F%2Fimgnews.pstatic.net%2Fimage%2Forigin%2F005%2F20...",
"naver_news_link": "https://n.news.naver.com/mnews/article/005/0001884842?sid=101"
},
"..."
]
}
Custom Date Range
https://www.searchapi.io/api/v1/search?engine=naver_news&q=%EC%9B%94%EB%93%9C%EC%BB%B5&time_period_max=06%2F30%2F2002&time_period_min=06%2F01%2F2002
- 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_news",
"q": "월드컵",
"time_period_min": "06/01/2002",
"time_period_max": "06/30/2002"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_VBoxg639zWroSvZvaoV9Jj0r",
"status": "Success",
"created_at": "2026-11-12T14:45:51Z",
"request_time_taken": 1.5,
"parsing_time_taken": 0.02,
"total_time_taken": 1.52,
"request_url": "https://search.naver.com/search.naver?where=news&ssc=tab.news.all&query=%EC%9B%94%EB%93%9C%EC%BB%B5&...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_VBoxg639zWroSvZvaoV9Jj0r.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_VBoxg639zWroSvZvaoV9Jj0r"
},
"search_parameters": {
"engine": "naver_news",
"q": "월드컵",
"time_period_min": "06/01/2002",
"time_period_max": "06/30/2002"
},
"organic_results": [
{
"position": 1,
"title": "<김대통령 `월드컵 폐막' 외교>",
"link": "https://n.news.naver.com/mnews/article/001/0000198733?sid=100",
"source": "연합뉴스",
"source_link": "https://media.naver.com/press/001",
"press_id": "1001",
"favicon": "https://search.pstatic.net/common/?src=https%3A%2F%2Fmimgnews.pstatic.net%2Fimage%2Fupload%2Foffice_...",
"date": "2002.06.30.",
"snippet": "김대중(金大中) 대통령이 30일 오후 일본 에 도착, 2박 3일간의 `월드컵 정상외교'에 나섰다. 김 대통령이 북한 경비정의 북방한계선(NLL) 침범 및 무력도발 사태에도 불구, 일본 방문을 예정대로 강행한 것은 성공적인 월드컵 공동개최를 국운융성의 계기로 삼겠다는 의지를 보여주기 위한 것으로 풀이된다. 또... ",
"naver_news_link": "https://n.news.naver.com/mnews/article/001/0000198733?sid=100",
"related_news": [
{
"title": "월드컵 외교 시작",
"link": "https://n.news.naver.com/mnews/article/009/0000227966?sid=101",
"source": "매일경제",
"press_id": "1009",
"date": "2002.06.30.",
"naver_news_link": "https://n.news.naver.com/mnews/article/009/0000227966?sid=101"
},
"..."
]
},
"..."
]
}
Press Filter
https://www.searchapi.io/api/v1/search?engine=naver_news&press_id=1032&q=%EB%B6%80%EB%8F%99%EC%82%B0
- 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_news",
"q": "부동산",
"press_id": "1032"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_voMXVEmBfBvRVllfVeWadnWe",
"status": "Success",
"created_at": "2026-11-12T14:45:55Z",
"request_time_taken": 2.88,
"parsing_time_taken": 0.04,
"total_time_taken": 2.91,
"request_url": "https://search.naver.com/search.naver?where=news&ssc=tab.news.all&query=%EB%B6%80%EB%8F%99%EC%82%B0&...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_voMXVEmBfBvRVllfVeWadnWe.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_voMXVEmBfBvRVllfVeWadnWe"
},
"search_parameters": {
"engine": "naver_news",
"q": "부동산",
"press_id": "1032"
},
"organic_results": [
{
"position": 1,
"title": "김민석 “부동산 정책의 기본은 일관되게 지켜가는 게 좋아”…물밑 갑...",
"link": "https://www.khan.co.kr/article/202611121708001",
"source": "경향신문",
"source_link": "https://media.naver.com/press/032",
"press_id": "1032",
"favicon": "https://search.pstatic.net/common/?src=https%3A%2F%2Fmimgnews.pstatic.net%2Fimage%2Fupload%2Foffice_...",
"date": "6시간 전",
"snippet": "김민석 더불어민주당 대표가 12일 “당정이 추진하는 부동산 정책의 기본은 일관되게 지켜가는 게 좋다”고 말했다. 비거주 종합부동산세 기본공제액 기준을 둘러싼 당내 갑론을박이 이어지는 가운데 거주·비거주를 구분한 정부안에 무게를 실은 발언으로 풀이된다. 다만 당내에선 여전히 서울·수도권 일부... ",
"thumbnail": "https://search.pstatic.net/common/?src=https%3A%2F%2Fimgnews.pstatic.net%2Fimage%2Forigin%2F032%2F20...",
"naver_news_link": "https://n.news.naver.com/mnews/article/032/0003482343?sid=100"
},
"..."
]
}
Print Edition Articles
https://www.searchapi.io/api/v1/search?article_type=print&engine=naver_news&q=%EB%B0%98%EB%8F%84%EC%B2%B4
- 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_news",
"q": "반도체",
"article_type": "print"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_WO7KZN0gXTgiEF6l4KAjGa6h",
"status": "Success",
"created_at": "2026-11-12T14:46:00Z",
"request_time_taken": 1.96,
"parsing_time_taken": 0.02,
"total_time_taken": 1.98,
"request_url": "https://search.naver.com/search.naver?where=news&ssc=tab.news.all&query=%EB%B0%98%EB%8F%84%EC%B2%B4&...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_WO7KZN0gXTgiEF6l4KAjGa6h.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_WO7KZN0gXTgiEF6l4KAjGa6h"
},
"search_parameters": {
"engine": "naver_news",
"q": "반도체",
"article_type": "print"
},
"organic_results": [
{
"position": 1,
"title": "“반도체 호황, 효과는 내년부터” KDI 전망",
"link": "https://www.kmib.co.kr/article/20261112501977",
"source": "국민일보",
"source_link": "https://media.naver.com/press/005",
"press_id": "1005",
"favicon": "https://search.pstatic.net/common/?src=https%3A%2F%2Fmimgnews.pstatic.net%2Fimage%2Fupload%2Foffice_...",
"date": "36분 전",
"newspaper_page": "5면 1단",
"snippet": "반도체 초호황이 민간소비 증가에 본격적으로 기여하려면 내년은 돼야 한다는 전망이 나왔다. 간판 수출품목인 반도체 가격의 상승이 소비 증가로 이어지기까지는 평균적으로 1년가량 걸리는 것으로 분석된다. 반면 중동전쟁으로 치솟은 유가는 소비 위축에 직격타가 됐다. 반도체발 온기가 빠르게 퍼지지... ",
"thumbnail": "https://search.pstatic.net/common/?src=https%3A%2F%2Fimgnews.pstatic.net%2Fimage%2Forigin%2F005%2F20...",
"naver_news_link": "https://n.news.naver.com/mnews/article/005/0001884838?sid=101"
},
"..."
]
}
Pagination
https://www.searchapi.io/api/v1/search?engine=naver_news&page=2&q=%EC%9D%B8%EA%B3%B5%EC%A7%80%EB%8A%A5
- 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_news",
"q": "인공지능",
"page": 2
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_3Sv7cLhNe9xijTSqiFp5fhI9",
"status": "Success",
"created_at": "2026-11-12T14:46:04Z",
"request_time_taken": 2.15,
"parsing_time_taken": 0.01,
"total_time_taken": 2.16,
"request_url": "https://search.naver.com/search.naver?where=news&ssc=tab.news.all&query=%EC%9D%B8%EA%B3%B5%EC%A7%80%...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_3Sv7cLhNe9xijTSqiFp5fhI9.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_3Sv7cLhNe9xijTSqiFp5fhI9"
},
"search_parameters": {
"engine": "naver_news",
"q": "인공지능",
"page": 2
},
"organic_results": [
{
"position": 11,
"title": "동서발전, '배우고 만들고 적용하는' 인공지능 인재 키운다",
"link": "https://www.yna.co.kr/view/AKR20261112056700057?input=1195m",
"source": "연합뉴스",
"source_link": "https://media.naver.com/press/001",
"press_id": "1001",
"favicon": "https://search.pstatic.net/common/?src=https%3A%2F%2Fmimgnews.pstatic.net%2Fimage%2Fupload%2Foffice_...",
"date": "13시간 전",
"snippet": "제1회 인공지능 활용대회서 우수 과제 5건 시상…\"업무 개선 방법 발견\" 한국동서발전은 '제1회 인공지능 활용대회'를 열어 직원들이 직접 개발한 인공지능 활용 우수 과제 5건을 시상했다고 12일 밝혔다. 동서발전은 인공지능을 발전산업의 일하는 방식을 바꿀 핵심 역량으로 보고, 인재개발부서 주관으로... ",
"thumbnail": "https://search.pstatic.net/common/?src=https%3A%2F%2Fimgnews.pstatic.net%2Fimage%2Forigin%2F001%2F20...",
"naver_news_link": "https://n.news.naver.com/mnews/article/001/0016437740?sid=105"
},
"..."
],
"pagination": {
"current_page": 2,
"next_page": 3
}
}
pagination.next_page is present while Naver News has more results, up to page 200. Request
it with the page parameter, and positions continue from the previous page. A query with no results, or a
page past the last result, returns HTTP 200 with
error: "Naver News didn't return any results."