Naver Search API & Scraper
The Naver Search API returns Naver (네이버, search.naver.com) — Korea's largest search engine — as JSON.
11 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
search gives the integrated results page: organic results in Naver's order (web pages, blog and cafe posts, videos, 지식iN answers), power-link ads, news, images, Naver Clip videos, AI related questions with sources, Naver's AI briefing, shopping cards, local places and related searches. web, news, blog, cafe, kin, images and videos cover each Naver tab with its sort, period and paging; ads lists every advertiser on a keyword; autocomplete returns the search-box suggestions. Built for Korean SEO rank tracking, brand and market monitoring and AI pipelines that need a Korean search source. One ReefAPI key, no Naver account, no Korean proxy.
Reference
What each action returns
Measured on 2026-11-06 with live calls. Every action returns the standard envelope; rows below are inside data.
| Action | Rows | Filters and paging |
|---|---|---|
| search | organic_results[], ads[], news[], images[], clips[], related_questions[], ai_overview, shopping_results[], local_results[], related_searches[], sections[], spelling_correction | sort, period or date_from/date_to, spell_check, include_related_searches |
| web | results[] with title, url, displayed_url, snippet, site name, favicon, thumbnail | page (20 per page, up to 20), sort, period or date range, spell_check |
| news | news[] with title, url, naver_news_url, source, date, date_iso, snippet, thumbnail, related_articles[] | page (10 per page, up to 40), sort relevance/date/oldest, period or date range |
| blog | posts[] with title, url, snippet, author, author_url, date, thumbnail, image_count, is_ad | page (up to 10), sort, period or date range |
| cafe | posts[] with title, url, snippet, cafe_name, cafe_id, article_id, date, thumbnail, is_ad | page (up to 5), sort, period, article_type, trade_method, trade_status |
| kin | questions[] with title, url, question_id, question, answer excerpt, answerer, badge, date | page (10 per page, up to 30) |
| images | images[] with image_url (original), thumbnail, source_page, source, width, height, date | page (50 per page, up to 20), sort, period |
| videos | videos[] with url, platform, channel, duration_seconds, views, date, thumbnail, is_short (shorts_only rows carry no duration or views: Naver does not print them on short-form cards) | page (up to 10), sort relevance/date/views, period, duration, shorts_only |
| shopping | products[] with price, original_price, discount_percent, mall, mall_count, rating, reviews, delivery_fee, is_ad | spell_check |
| ads | ads[] with advertiser, displayed_url, title, description, sitelinks[], extensions[], ad_period; total_ads. url and sitelink URLs are Naver's ad click links (ader.naver.com): opening one counts as a paid click; displayed_url is the advertiser's site | page (25 per page, up to 5) |
| autocomplete | suggestions[] in Naver's order | — |
Titles and snippets come back as plain text: Naver's highlight tags and HTML entities are removed. A query Naver answers with no results returns NOT_FOUND; a layout change on Naver's side returns SCHEMA_DRIFT rather than an empty success.
Live example
Real request and response JSON
Captured from the indexed primary action, search, on .
Captured request
{
"method": "POST",
"url": "https://api.reefapi.com/naver-search/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "아이폰"
}
}Captured response
{
"ok": true,
"meta": {
"api": "naver-search",
"endpoint": "search",
"mode": "live",
"latency_ms": 4617.9,
"record_count": 20,
"bytes": 1926474,
"cache_hit": false,
"upstream_requests": 2,
"charged_credits": 3,
"version": "0.1.1",
"request_id": "d08293be9c6941e3",
"fetched_at": "2026-11-06T16:39:43.796Z"
},
"data": {
"query": "아이폰",
"spelling_correction": null,
"sort": "relevance",
"period": "all",
"organic_results": [
{
"type": "web",
"title": "Apple (대한민국)",
"url": "https://www.apple.com/kr/",
"displayed_url": "www.apple.com",
"domain": "www.apple.com",
"snippet": "Apple이 제시하는 혁신적인 세상을 만나고, iPhone, iPad, Apple Watch, Mac, Apple TV 등을 구입하는 것은 물론, 액세서리, 엔터테인먼트, 전문가 기기 지원에 대해서도 살펴볼 수 있습니다.",
"source": "Apple",
"source_url": "https://www.apple.com/",
"favicon": "https://search.pstatic.net/sunny?src=https%3A%2F%2Fwww.apple.com%2Ffavicon.ico&type=f30_30_png_expire24",
"thumbnail": "https://search.pstatic.net/sunny?src=https%3A%2F%2Fwww.apple.com%2Fv%2Fhomepage%2Fimages%2Fmacbook-pro-m6%2Fa%2Fhero_macbook_pro_m6__ejfu9vvdq3ee_mediumtall_2x.jpg&type=fff208_208_ar",
"date": null,
"date_iso": null,
"is_ad": false,
"position": 1
},
{
"type": "web",
"title": "아이폰 - 위키백과 한국어",
"url": "https://ko.wikipedia.org/wiki/%EC%95%84%EC%9D%B4%ED%8F%B0",
"displayed_url": "ko.wikipedia.org › 아이폰",
"domain": "ko.wikipedia.org",
"snippet": "아이폰 ( 영어: iPhone )은 애플에서 개발 및 판매하고 자사의 모바일 운영체제인 iOS를 실행하는 스마트폰 라인이다. 1세대 아이폰은 당시 애플 CEO이자 공동 창립자인 스티브 잡스가 2007년 1월 9일 맥월드 2007에서 발표했으며, 같은 해 말에 출시되었다. 그 이후 애플은 매년 새로운 아이폰 모델과 iOS 버전을 출시했으며, 가장 최근 모델은 아이폰 16과 16 플러스, 그리고 더 고급 사양......",
"source": "위키백과 한국어",
"source_url": "https://ko.wikipedia.org/wiki/%EC%9C%84%ED%82%A4%EB%B0%B1%EA%B3%BC:%EB%8C%80%EB%AC%B8",
"favicon": "https://search.pstatic.net/sunny?src=https%3A%2F%2Fko.wikipedia.org%2Ffavicon.ico&type=f30_30_png_expire24",
"thumbnail": "https://search.pstatic.net/sunny?src=https%3A%2F%2Fthumb.wikimedia.org%2Fwikipedia%2Fcommons%2Fthumb%2Ff%2Ff5%2FIPhone_17_Pro_Vector.svg%2F250px-IPhone_17_Pro_Vector.svg.png&type=fff208_208_ar",
"date": null,
"date_iso": null,
"is_ad": false,
"position": 2
},
{
"type": "web",
"title": "iPhone - 나무위키",
"url": "https://namu.wiki/w/iPhone",
"displayed_url": "namu.wiki › iPhone",
"domain": "namu.wiki",
"snippet": "Apple이 MacWorld 2007에서 최초로 공개한 iOS 운영체제로 구동되는 스마트폰 시리즈. 2027년 1월 9일 공개 20주년을 맞고, 6월 29일 발매 20주년을 맞는다.",
"source": "나무위키",
"source_url": "https://namu.wiki/w/%EB%82%98%EB%AC%B4%EC%9C%84%ED%82%A4:%EB%8C%80%EB%AC%B8",
"favicon": "https://search.pstatic.net/sunny?src=https%3A%2F%2Fnamu.wiki%2Ffavicon.svg&type=f30_30_png_expire24",
"thumbnail": "https://search.pstatic.net/sunny?src=https%3A%2F%2Fi.namu.wiki%2Fi%2Fnt4z3SWBCT_9yXmJAKaLXRHT5RgCC0yoQ5s_Vseoc3PVOT50hR-VNIjW4v5f6H4GZD0U5Ih9GNPCkiUbuAQrbQ.webp&type=fff208_208_ar",
"date": null,
"date_iso": null,
"is_ad": false,
"position": 3
}
],
"ads": [
{
"position": 1,
"advertiser": null,
"displayed_url": "blog.naver.com/jinhwanss",
"title": "전국 휴대폰성지 시세표 모음",
"title_parts": [
"전국 휴대폰성지 시세표 모음"
],
"description": "아직도 비싸게 사세요? 성지 시세표 보고 가세요",
"url": "https://ader.naver.com/v1/GDYXZ-Z0K6czLEDzRN8sLCuHS59fxlYBEO-DoelBBK68DejuM6t7ha2yXPSaqR9LEJszcrYLaBixmLwUlocJJ13b5GYu5BuSCuCHCYURKJgx9rjtcXB4kNfFkVIuf_ZoIyoMTds-Ge1-ZBHJNoLbyFoAmk09Ck7Ogc-DDNXOA87adrfZ5oODuKTGpGGV7y3HHBfF8YJR-TUSm1bEghvb9DdQlBu4tkMAa4J81uJ7MJ9FjnMh-2arxe9ZzE2H56mKWXgOPwvGj6YXS3oPhxSP6PA7Czq23I12xbhdXjoRk65oNys1aEbL1qpQgEXq78O-zhdjVw1JyZuv8P-7uvf3dcYSB-WwUxoEzYQ_Kn0c65a7ExtEnGT--zfLzbtOhWK_IbnaPOQM_VrSioZ4m6XCwet6mM8Aozim_DODKisff0M=?c=naver.search.pc.plsearch&t=0",
"sitelinks": [
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]"
},
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]"
},
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]"
}
],
"extensions": [],
"ad_period": null,
"ad_id": "nad-a001-01-000000456717269",
"naver_pay": false,
"naver_login": false
},
{
"position": 2,
"advertiser": "성지폰",
"displayed_url": "phonemecca.com",
"title": "아이폰 싸게사고 싶을때는? | 기기반납, 부가서비스 NO | 할인에 할인, 추가할인 제공",
"title_parts": [
"아이폰 싸게사고 싶을때는?",
"기기반납, 부가서비스 NO",
"할인에 할인, 추가할인 제공"
],
"description": "누적판매 10만대, 손품 한번으로 타사대비 2배 저렴하게 GET! 성지폰특가 제공 부가서비스, 요금제 강요 일절없음. 상술성 호갱성 판매 ZERO!",
"url": "https://ader.naver.com/v1/KHT1nSg4PnL4nWKXQf5dV3AOpWyxJWt8iH0KJludATvxareg_F3Yv6DBjoxP40ta3lTicFUHNMXyrjtY1qyF6tnWQfAyJiS3Spgt7pRuRyJyoCl1m3lOOFwHnswoaEb2pH7Vn6lnhf8GLnES2UGufcFtChusTUhewsBVvCISV3cqifkAe5Wr10RgK_9tdF3zl-mPmVB5eZhfVZZRbZhAAraOltxhfDtWNvSipksefjs=?c=naver.search.pc.plsearch&t=0",
"sitelinks": [
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]"
},
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]"
},
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]"
}
],
"extensions": [
"타사비교 환영, 성지폰특가"
],
"ad_period": null,
"ad_id": "nad-a001-01-000000568678044",
"naver_pay": false,
"naver_login": false
},
{
"position": 3,
"advertiser": "FIXI",
"displayed_url": "fixi.im",
"title": "써보고 결정하는 FIXI | 아이폰15 프로 S급 중고 | 7일간 써보고 결정하세요",
"title_parts": [
"써보고 결정하는 FIXI",
"아이폰15 프로 S급 중고",
"7일간 써보고 결정하세요"
],
"description": "중고폰 구매 고민은 이제 그만! 마음에 안 들면 무료 반품되는 픽시에서!",
"url": "https://ader.naver.com/v1/KHT1nSg4PnL4nWKXQf5dV3AOpWyxJWt8iH0KJludATvWYABuNNXlsq_7wZ5R1hizy2oEz2654n_dXDm7dqQV_klLzK7I3fqYdtqRBLvp3aL14_GFnKN-wd7K_fkszspW8HCrtbu9VHi7DAJXJuSotqpllmmIdhkwIGRv8nJ_AGqznh8yETN2VRXblrLVQw64DayOdC5Mskhv0LnAKhTKglbrE-usBLZU1lj0ih2ygKtOtHW84p8WoChuuv4XoxmvHqVbQK69cfdeCCGVNwR8rusYICVmm9sJnlsiCk345MY=?c=naver.search.pc.plsearch&t=0",
"sitelinks": [
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]"
},
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]"
},
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]"
}
],
"extensions": [],
"ad_period": null,
"ad_id": "nad-a001-01-000000604082595",
"naver_pay": true,
"naver_login": false
}
],
"news": [
{
"title": "화면 교체 하세월…아이폰 듀오 소비자 신뢰에도 금 가나",
"url": "https://www.newsis.com/view/NISX20261106_0003857318",
"snippet": "애플의 첫 폴더블 스마트폰 '아이폰 듀오'가 출시 초기 디스플레이 균열과 힌지 이상 논란에 이어 사후서비스(AS) 문제까지 불거졌다. 화면 이상으로... 수리 요청 몰리자 '선교체' 차질…애플케어+ 가입자도 불편 6일 폰아레나 등 외신에 따르면 아이폰 듀오의 수리 요청이 늘어나면서 일부 고객이 기기 교체에...",
"source": "뉴시스",
"source_url": "https://media.naver.com/press/003",
"naver_news_url": "https://n.news.naver.com/mnews/article/003/0014305393?sid=105",
"date": "16시간 전",
"date_iso": "2026-11-06",
"print_position": null,
"thumbnail": "https://search.pstatic.net/common/?src=https%3A%2F%2Fimgnews.pstatic.net%2Fimage%2Forigin%2F003%2F2026%2F11%2F06%2F14305393.jpg&type=fface200_200&expire=2&refresh=true",
"related_articles": [
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]",
"source": "[trimmed-depth]",
"naver_news_url": "[trimmed-depth]",
"date": "[trimmed-depth]",
"date_iso": "[trimmed-depth]"
},
{
"title": "[trimmed-depth]",
"url": "[trimmed-depth]",
"source": "[trimmed-depth]",
"naver_news_url": "[trimmed-depth]",
"date": "[trimmed-depth]",
"date_iso": "[trimmed-depth]"
}
],
"related_articles_total": 22,
"position": 1
},
{
"title": "꺼지지 않는 아이폰 듀오 품질 논란…10명 중 4명 \"살 생각 접었다\"[1일...",
"url": "https://www.fnnews.com/news/202611060945238661",
"snippet": "애플의 첫 폴더블 스마트폰 '아이폰 듀오'가 출시 초기 화면 파손 논란에 휩싸인 가운데, 내구성에 대한 우려가 구매 심리에도 영향을 미친 것으로... 아이폰 듀오는 출시 직후 온라인 커뮤니티와 SNS에서 내부 화면에 균열이 생기거나 검은 선·색상 띠가 나타났다는 이용자 경험담이 올라왔다. 제품을 받은 지...",
"source": "파이낸셜뉴스",
"source_url": "https://media.naver.com/press/014",
"naver_news_url": "https://n.news.naver.com/mnews/article/014/0005600466?sid=105",
"date": "14시간 전",
"date_iso": "2026-11-06",
"print_position": null,
"thumbnail": "https://search.pstatic.net/common/?src=https%3A%2F%2Fimgnews.pstatic.net%2Fimage%2Forigin%2F014%2F2026%2F11%2F06%2F5600466.jpg&type=fface200_200&expire=2&refresh=true",
"related_articles": [],
"related_articles_total": null,
"position": 2
},
{
"title": "329만원 아이폰 듀오, 인기앱 3개 중 2개는 화면 반쪽만 나와",
"url": "https://www.mk.co.kr/article/12198862",
"snippet": "앱 60개 직접 설치해보니 배민·쿠팡·네이버페이 등 40개 앱 대화면 최적화 안돼 품질 논란에 ‘구매철회’ 40% 애플의 첫 폴더블폰 ‘아이폰 듀오’가... 5일 매일경제가 국내 앱스토어 무료 다운로드 상위권 50개와 한국인이 많이 사용하는 10개를 포함해 총 60개 앱을 아이폰 듀오에 직접 설치해 확인한 결과...",
"source": "매일경제",
"source_url": "https://media.naver.com/press/009",
"naver_news_url": "https://n.news.naver.com/mnews/article/009/0005759800?sid=105",
"date": "2일 전",
"date_iso": "2026-11-05",
"print_position": null,
"thumbnail": "https://search.pstatic.net/common/?src=https%3A%2F%2Fimgnews.pstatic.net%2Fimage%2Forigin%2F009%2F2026%2F11%2F05%2F5759800.jpg&type=fface200_200&expire=2&refresh=true",
"related_articles": [],
"related_articles_total": null,
"position": 3
}
],
"images": [
{
"title": "\"사지 말고 기다리세요\" 아이폰18 프로 초기 구매자가 후회하는 이유",
"image_url": "http://blogfiles.naver.net/MjAyNjEwMDZfMjI2/MDAxNzkxMjY5NzQzNTM1.e6_AMNT6ScRsrV25pEm_F_6gBqr9kifVlcO-uJrCzBQg.N5u4-eW57E8PmxTEZ1x7IGCWqsEkLEFTJgWGdj2HQFsg.JPEG/img_95bd48d5d5e6.jpg",
"thumbnail": "https://search.pstatic.net/common/?src=http%3A%2F%2Fblogfiles.naver.net%2FMjAyNjEwMDZfMjI2%2FMDAxNzkxMjY5NzQzNTM1.e6_AMNT6ScRsrV25pEm_F_6gBqr9kifVlcO-uJrCzBQg.N5u4-eW57E8PmxTEZ1x7IGCWqsEkLEFTJgWGdj2HQFsg.JPEG%2Fimg_95bd48d5d5e6.jpg&type=sc960_832",
"source_page": "https://blog.naver.com/apsdkf/224433071038",
"source": "네이버 블로그",
"source_domain": "blog.naver.com",
"author": "모빌리티랩",
"width": 1280,
"height": 1280,
"date": "4주 전",
"date_iso": null,
"image_id": "image_sas:blog_77bb6a6eaa776f60ecab2ba2a4542ced",
"price": null,
"position": 1,
"date_window": {
"from": "2026-10-10",
"to": "2026-10-16"
}
},
{
"title": "아이폰18 프로 출시 아이폰17 프로 사용자가 정리한 달라진 점",
"image_url": "http://blogfiles.naver.net/MjAyNjA5MTdfMTY4/MDAxNzg5NjA4NDUyMzk1.fR9VjfglkxMw9zvY0XUU4Z_eJ3bSha1oXeej9E-72ncg.MpNx9vX6Sn-PByo1KF0UAzytgu89CBOyxYbcfZuW2LQg.PNG/%C0%CC%B9%CC%C1%F6_2026._9._17._%BF%C0%C0%FC_10.27.png",
"thumbnail": "https://search.pstatic.net/common/?src=http%3A%2F%2Fblogfiles.naver.net%2FMjAyNjA5MTdfMTY4%2FMDAxNzg5NjA4NDUyMzk1.fR9VjfglkxMw9zvY0XUU4Z_eJ3bSha1oXeej9E-72ncg.MpNx9vX6Sn-PByo1KF0UAzytgu89CBOyxYbcfZuW2LQg.PNG%2F%25C0%25CC%25B9%25CC%25C1%25F6_2026._9._17._%25BF%25C0%25C0%25FC_10.27.png&type=sc960_832",
"source_page": "https://blog.naver.com/gumdi_blog/224414711949",
"source": "네이버 블로그",
"source_domain": "blog.naver.com",
"author": "Gemma's day",
"width": 634,
"height": 634,
"date": "2026.09.17.",
"date_iso": "2026-09-17",
"image_id": "image_sas:blog_21b8ec72e741f43f99681ead6b70a121",
"price": null,
"position": 2
},
{
"title": "스마트폰 카메라의 한계를 깨다! 아이폰 18 프로 맥스 유출 정보 총정리",
"image_url": "http://blogfiles.naver.net/MjAyNjA2MTdfMTk4/MDAxNzgxNjg5MjE0OTYz.8kJkfzR1Y251uy9707l1Ctirt4wrZWin3ZOA9xSsaEIg.8AXM-9QHeI6e0ijX7mUfxVN9T2yNo4RSx09vM5wxAAAg.PNG/%BE%D6%C7%C3%BE%C6%C0%CC%C6%F918%C7%C1%B7%CE%B8%C6%BD%BA_4.png",
"thumbnail": "https://search.pstatic.net/common/?src=http%3A%2F%2Fblogfiles.naver.net%2FMjAyNjA2MTdfMTk4%2FMDAxNzgxNjg5MjE0OTYz.8kJkfzR1Y251uy9707l1Ctirt4wrZWin3ZOA9xSsaEIg.8AXM-9QHeI6e0ijX7mUfxVN9T2yNo4RSx09vM5wxAAAg.PNG%2F%25BE%25D6%25C7%25C3%25BE%25C6%25C0%25CC%25C6%25F918%25C7%25C1%25B7%25CE%25B8%25C6%25BD%25BA_4.png&type=sc960_832",
"source_page": "https://blog.naver.com/sfortyfive/224319020565",
"source": "네이버 블로그",
"source_domain": "blog.naver.com",
"author": "스포티5 Car&IT Life",
"width": 1848,
"height": 964,
"date": "2026.06.17.",
"date_iso": "2026-06-17",
"image_id": "image_sas:blog_25de6ea46902101b8e967fa65f39eaab",
"price": null,
"position": 3
}
],
"clips": [
{
"title": "일본인들이 아이폰 때문에 화가 난 이유?",
"url": "https://m.naver.com/shorts/?mediaType=VOD&recId=%7B%22query%22%3A%22%EC%95%84%EC%9D%B4%ED%8F%B0%22%2C%22seedIndex%22%3A%221%22%2C%22type%22%3A%22ALL%22%2C%22order%22%3A%22RELATED%22%2C%22filter%22%3A%22LOW_QUALITY_LEVEL_3%22%2C%22theme%22%3A%22shopping%22%2C%22now%22%3A%220%22%7D&recType=CLIP_SEARCH&seedMediaId=4BE574108713015DBFDC3D757945D8FFA9A5&serviceType=CLIP",
"platform": "Naver Clip",
"channel": "어썸코리아",
"channel_url": "https://clip.naver.com/@awesomewhy",
"duration_seconds": null,
"views": 54000,
"views_display": "조회 5.4만",
"date": "4일 전",
"date_iso": "2026-11-03",
"thumbnail": "https://search.pstatic.net/common/?src=https%3A%2F%2Fclip-service-phinf.pstatic.net%2FMjAyNjExMDJfNyAg%2FMDAxNzkzNTg4NDY5OTQ5.QYDxWPL_39qRWrZvZGHJY2D8JlxT4hrrnUx68rvZpMcg.yLvLazkE56Pu1zJuPKPeVnJravs_pajrDfBknPGqN8cg.JPEG%2F5AVnBBHGMo_02.jpg&type=f292_487_clip_lb",
"is_certified": true,
"is_short": true,
"position": 1
}
],
"__trimmed": "response capped for page display"
},
"__trimmed": "response capped for page display"
}Actions
What the Naver Search API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Naver's integrated results page (통합검색) for a query, every block it shows: organic results in Naver's own order (web pages, blog and cafe posts, videos, 지식iN answers), power-link ads, the news block, the image block, Naver Clip short videos, AI-generated related questions with their source documents, Naver's AI briefing when it shows one, shopping product cards, local places (Naver Place block, with the place_id the `naver` engine takes), related searches and the spelling correction Naver applied. | SEO teams call search to get naver's integrated results page (통합검색) for a query, every block it shows. | query, sort, period, date_from, date_to, ... |
| web | Web documents (웹문서) — Naver's organic list on its own: 20 results per page with title, URL, displayed URL, snippet, site name, favicon and thumbnail. Paginate with `page`. | Content strategists call web to get web documents (웹문서). | query, page, sort, period, date_from, ... |
| news | Naver News search: 10 articles per page with title, publisher, article URL, Naver News URL, date, snippet, thumbnail and the cluster of related articles. Sort by relevance, newest or oldest; filter by period or a custom date range. | Rank trackers call news to get naver News search. | query, page, sort, period, date_from, ... |
| blog | Naver Blog search: 30-40 posts per page with title, URL, snippet, blogger, blog URL, date, thumbnail and image count. Power-content ads in the list are flagged is_ad. Naver repeats part of a page on the next one; those repeats are removed, so a deeper page can hold fewer new posts (repeated_from_previous_page_removed says how many). | AI answer-monitoring tools call blog to get naver Blog search. | query, page, sort, period, date_from, ... |
| cafe | Naver Cafe search: about 30 posts per page with title, URL, snippet, cafe name, cafe URL, date and thumbnail. Sort, period, article type (all / trade / general / cafe names), trade method and trade status filters. Pages beyond 1 follow Naver's own continuation link, so page N costs N requests (max 5). | SEO teams call cafe to get naver Cafe search. | query, page, sort, period, article_type, ... |
| kin | Naver 지식iN (Knowledge iN) Q&A search: 10 questions per page with question title and text, the shown answer excerpt, answerer nickname and badge, expert flag and date. | Content strategists call kin to get naver 지식iN (Knowledge iN) Q&A search. | query, page |
| images | Naver Image search: 50 images per page with the original image URL, a thumbnail, the page it is on, source name and domain, size and date. | Rank trackers call images to get naver Image search. | query, page, sort, period |
| videos | Naver Video search: up to 48 videos per page (YouTube, Naver TV, Chzzk and others) with title, URL, platform, channel, duration, views and date. Sort by relevance, date or views; filter by period, duration or short-form only (shorts carry no duration or view count: Naver does not print them on short-form cards). Naver repeats part of a page on the next one; repeats are removed (repeated_from_previous_page_removed). | AI answer-monitoring tools call videos to get naver Video search. | query, page, sort, period, duration, ... |
| shopping | The shopping product cards Naver shows on its integrated results page for a query: price-comparison catalogue cards (lowest price across N malls) and Naver Plus Store cards, with price, original price, discount, mall, mall count, rating, review count, delivery fee and ad flag. Naver shows about 8-12 cards per query; Naver Shopping's own search site is not part of this action. | SEO teams call shopping to get the shopping product cards Naver shows on its integrated results page for a query. | query, spell_check |
| ads | Naver power-link search ads for a keyword (Naver's full ad list, 25 per page, with the total number of advertisers): advertiser, displayed URL, ad title, description, sitelinks, extensions and the advertiser's running-time band. `url` and sitelink URLs are Naver's ad click links (ader.naver.com), the only link the page carries: opening one counts as a paid click for the advertiser; `displayed_url` is the advertiser's site. | Content strategists call ads to get naver power-link search ads for a keyword (Naver's full ad list, 25 per page, with the total…. | query, page |
| autocomplete | Naver search-box suggestions for a partial query (keyword research). | Rank trackers call autocomplete to get naver search-box suggestions for a partial query (keyword research).. | query |
Code samples
Call search from your stack
curl -X POST https://api.reefapi.com/naver-search/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"아이폰"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/naver-search/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "아이폰"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/naver-search/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "아이폰"
}),
});
const { ok, data, meta, error } = await res.json();MCP one-liner
Ask your MCP-connected assistant: call reefapi.naver-search.search with {"query":"아이폰"}.Use cases
Who uses this API and why
- SEO teams track where a site, a blog post or a cafe post ranks on Naver for Korean keywords, tab by tab.
- Brand and market researchers follow what Korean blogs, cafes, 지식iN and news say about a product, newest first.
- Performance marketers see every advertiser bidding on a Naver keyword, with ad copy, sitelinks and how long they have run ads.
- Keyword tools collect Naver autocomplete, related searches and AI related questions to learn how Koreans phrase a topic.
- AI and RAG pipelines use news, blog and web as a Korean-language retrieval source with real URLs and ISO dates.
FAQ
Questions developers ask before integrating
Is this an official Naver API?
No. Naver's own Search API for developers needs an application key and returns only part of what the results page shows. ReefAPI is an independent service that returns what Naver's public results pages show, as JSON, with no Naver account.
Is this the same as the Naver Place API?
No. The Naver Place engine covers businesses, reviews and the map. This engine is search.naver.com. Its search action does return the place block's place_id, which you can pass to the Naver Place engine for the full profile and reviews.
Do I need a Korean IP?
No. You call reefapi.com from anywhere and get the Korean results page, ads and shopping cards included.
Are ads separated from organic results?
Yes. Power links are only in ads[]. Paid posts inside the blog and cafe tabs are kept in the list where Naver shows them but carry is_ad: true and no position number. The ads action lists every advertiser on a keyword with Naver's total.
Does it work for English queries?
Yes. python tutorial returned 20 organic results, mostly English pages, and Naver's AI briefing with its sources. News, blogs, cafes and 지식iN are Korean services, so English queries return fewer Korean posts there.
How fast is it?
Median per call over 422 live calls: autocomplete 1.5 s, 지식iN 1.5 s, news 1.6 s, images 1.7 s, blog 1.7 s, cafe 2.1 s, shopping 2.1 s, web 2.3 s, ads 2.5 s, videos 2.8 s, and 3.8 s for search, which reads the whole integrated page plus related searches. Deeper cafe pages take longer: page N follows Naver's own next-page link N times.
Are the dates exact?
date is what Naver prints. date_iso is filled when that is a day: an absolute date, or minutes, hours or days ago. Naver prints older posts as 1주 전 or 2주 전, which is not a day (2주 전 was 9-10 days on the posts' own pages), so those rows carry date_window with the first and last possible day instead. Checked against the posts' own pages: 18 of 18 blog dates and 12 of 12 news dates agreed.
What is the Naver Search API?
Naver Search API is a ReefAPI endpoint group for naver (네이버) search results as json: the integrated results page with ads, news, images, ai related questions, shopping cards and places, plus naver web, news, blog, cafe, 지식in, image and video search, the full ad list and autocomplete. It returns live JSON through POST requests under /naver-search/v1.
Is the Naver Search API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Naver Search calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Naver Search login or account?
No login to Naver Search is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Naver Search data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Naver Search API use?
Naver Search actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Naver Search from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call naver-search actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Naver Search API a Naver Search scraper?
It is the managed alternative to a DIY Naver Search scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same naver (네이버) search results as json: the integrated results page with ads, news, images, ai related questions, shopping cards and places, plus naver web, news, blog, cafe, 지식in, image and video search, the full ad list and autocomplete back as clean JSON.