Naver News API Documentation

GET   /api/v1/search?engine=naver_news

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 삼성전자 or hyundai 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:

    • relevance Default
    • most_recent Newest articles first.
    • oldest Oldest articles first.

Filters

  • Name
    time_period
    Required
    Optional
    Description

    Restricts results to articles published within a recent time window. Available values are:

    • last_hour
    • last_2_hours
    • last_3_hours
    • last_4_hours
    • last_5_hours
    • last_6_hours
    • last_day
    • last_week
    • last_month
    • last_3_months
    • last_6_months
    • last_year

  • Name
    time_period_min
    Required
    Optional
    Description

    Start date of a custom date range, in MM/DD/YYYY format, such as 06/01/2002, between 01/01/1990 and today in Korea. Without time_period_max, the range ends today. A custom range takes precedence over time_period.

  • Name
    time_period_max
    Required
    Optional
    Description

    End date of a custom date range, in MM/DD/YYYY format, such as 06/30/2002, between 01/01/1990 and today in Korea. Without time_period_min, the range starts on 01/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 1032 for 경향신문 or 1001 for 연합뉴스. A result's press_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:

    • video Video clips.
    • print Articles from a newspaper's print edition, with their newspaper_page.
    • press_release Press releases.
    • auto_generated Articles Naver News labels as automatically generated.

Pagination

  • Name
    page
    Required
    Optional
    Description

    Page of results to return, from 1 (default) to 200. 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_key authenticates 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 true to 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

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=naver_news&q=%EC%82%BC%EC%84%B1%EC%A0%84%EC%9E%90
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "naver_news",
  "q": "삼성전자"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "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

Sort and Time Period
GET
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
Request
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)
Response
{
  "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

Custom Date Range
GET
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
Request
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)
Response
{
  "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

Press Filter
GET
https://www.searchapi.io/api/v1/search?engine=naver_news&press_id=1032&q=%EB%B6%80%EB%8F%99%EC%82%B0
Request
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)
Response
{
  "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

Print Edition Articles
GET
https://www.searchapi.io/api/v1/search?article_type=print&engine=naver_news&q=%EB%B0%98%EB%8F%84%EC%B2%B4
Request
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)
Response
{
  "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

Pagination
GET
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
Request
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)
Response
{
  "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."