Naver AI Overview API

Naver AI Overview API

Naver AI Overview API fetches Naver's AI 브리핑 (AI Overview/Briefing) — the AI-generated answer box that now appears above organic results on search.naver.com — for any Korean (or other-language) search query, returned as clean structured JSON.

한국어: 네이버 AI 브리핑 API는 네이버 통합검색 상단에 표시되는 AI 생성 답변("AI 브리핑")을 검색어별로 가져와 정형화된 JSON으로 제공합니다.

Submit one query or a batch of queries and get the AI Overview's markdown answer, structured content blocks, cited sources, related media, and follow-up questions — or a clear "not shown" note when Naver has no AI Overview for that query.

Copy to your AI assistant

Use the Apify actor "parsebird/naver-ai-overview-api" (call it via ApifyClient) to fetch Naver's AI Overview (AI 브리핑) for one or more search queries. Example run input: {"queries": ["당뇨병 증상", "전기차 보조금"]}. Key inputs: query (string, a single search query), queries (array of strings, batched and merged with query, de-duplicated), proxyConfiguration (object, default Residential/KR — keep it for reliable results), maxConcurrency (integer, default 5, advanced). Output: one JSON object per resolved query with result_type ("ai_overview" or "error"), query, ai_overview_present (boolean), markdown (the full AI Overview answer as markdown), text_blocks (ordered paragraph/list blocks with reference_indexes), references (cited sources: index, title, link, source), media (related images/videos: title, platform, link, thumbnail), related_questions, note (explains why no overview was shown, when applicable), fetched_at, and error_message/error_type on error rows. Full API reference: https://apify.com/parsebird/naver-ai-overview-api/api. Get an API token at https://console.apify.com/account/integrations.

What does Naver AI Overview API do?

Naver — South Korea's dominant search engine — rolled out AI 브리핑, an AI-generated summary box shown above regular search results for many queries, similar in concept to Google's AI Overviews. Naver AI Overview API reads that box directly from Naver's own search-results payload and returns it as structured data, so you don't have to open a browser, parse HTML, or guess which queries trigger it.

• 🔎 Batch queries — submit a single query or a list of queries in one run, de-duplicated automatically
• 📝 Full markdown answer — the generated answer text, with headings and lists preserved
• 🧩 Structured content blocks — the answer broken into paragraph/list segments, each tagged with which sources back it
• 🔗 Cited sources — every reference Naver's AI cited, with title, link, and publisher
• 🖼️ Related media — images and videos Naver surfaces alongside the answer
• ❓ Related/follow-up questions — the topics and queries Naver links from the AI Overview, when present
• 🚫 Graceful "not shown" handling — queries with no AI Overview return ai_overview_present: false with a explanatory note instead of an error

한국어: 네이버는 일부 검색어에 대해 통합검색 결과 상단에 "AI 브리핑"이라는 AI 생성 요약을 보여줍니다. 이 액터는 해당 브리핑 데이터를 직접 읽어 답변 텍스트, 출처, 관련 이미지·동영상, 연관 질문까지 구조화된 JSON으로 반환합니다.

Results are ready to export as JSON, CSV, or Excel, available through the Apify API, and can run on a schedule or be wired into Make, Zapier, and other integrations.

Input parameters

Parameter	Type	Required	Default	Description
query	string	No*	—	A single query, in Korean or any language, e.g. 당뇨병 증상.
queries	array of strings	No*	[]	A batch of queries to check in one run. Merged with query and de-duplicated.
proxyConfiguration	object	No	Residential (KR)	Keep the default — Naver's AI Overview renders most reliably to South Korean IPs.
maxConcurrency	integer	No	5	Maximum number of queries resolved in parallel (advanced).

* Provide query, queries, or both — at least one non-empty query is required.

한국어: query(단일 검색어) 또는 queries(검색어 배열) 중 하나 이상을 입력해야 합니다. 두 값 모두 입력하면 병합 후 중복이 제거됩니다. proxyConfiguration은 기본값(레지덴셜, 대한민국)을 유지하는 것을 권장합니다.

Single query:

{ "query": "당뇨병 증상" }

Batch of queries:

{ "queries": ["당뇨병 증상", "전기차 보조금", "아이폰16 스펙"] }

What data can you extract from Naver's AI Overview?

Field	Description
result_type	ai_overview for a resolved query row, or error for a validation/fetch error row
query	The search query this row corresponds to
ai_overview_present	true if Naver returned an AI Overview for this query, false if none was shown
markdown	The full AI Overview answer, rendered as markdown (headings, lists)
text_blocks	Ordered content blocks (paragraphs, lists), each with type, snippet, and reference_indexes
references	Cited sources, each with index, title, link, and source (publisher name)
media	Related images/videos, each with title, platform, link, and thumbnail
related_questions	Follow-up topics/questions Naver links from the AI Overview, when present
note	Why no overview was returned, when ai_overview_present is false
fetched_at	ISO 8601 timestamp of when the row was produced

한국어: 각 필드의 의미는 위 표를 참고하세요. markdown에는 전체 답변이, references에는 출처가, media에는 관련 이미지·동영상이 담깁니다. AI 브리핑이 없으면 ai_overview_present는 false가 되고 note에 이유가 설명됩니다.

Output example

{
  "result_type": "ai_overview",
  "query": "당뇨병 증상",
  "ai_overview_present": true,
  "markdown": "당뇨병은 혈당이 높은 상태가 지속되는 만성질환으로... \n\n### 당뇨병의 증상\n- **삼다(三多) 증상**: 다음, 다뇨, 다식 현상이 나타납니다.",
  "text_blocks": [
    { "type": "paragraph", "snippet": "당뇨병은 혈당이 높은 상태가 지속되는 만성질환으로...", "reference_indexes": [0, 1, 2] }
  ],
  "references": [
    { "index": 0, "title": "당뇨병의 증상 - 삼성서울병원", "link": "http://www.samsunghospital.com/...", "source": "삼성서울병원" }
  ],
  "media": [
    { "title": "당뇨병 - 인하대병원", "platform": "image", "link": "https://www.inha.com/...", "thumbnail": "https://www.inha.com/..." }
  ],
  "related_questions": [
    { "question": "고혈압", "query": "고혈압" }
  ],
  "fetched_at": "2026-09-20T01:42:56.492Z"
}

Full field-by-field description is in the table above. Download results in JSON, HTML, CSV, or Excel from the Dataset tab, or via the Input/Output tab.

Use cases

• Monitor whether your brand, product, or medical/legal topic is cited as a source in Naver's AI Overview
• Track how Naver's AI answers a set of customer-support or FAQ-style queries over time
• Feed AI Overview text and citations into a Korean SEO or content-gap analysis tool
• Compare AI-generated answers against your own published content for accuracy checks
• Build a monitoring dashboard for AI-answer visibility across a list of target keywords

한국어: 브랜드·제품·의료/법률 주제가 AI 브리핑의 출처로 인용되는지 모니터링하거나, 다수의 검색어에 대한 AI 답변 변화를 추적하는 데 활용할 수 있습니다.

How to use Naver AI Overview API

1. Click Try for free (no code needed) or grab the Actor ID for the API/SDK.
2. Enter one query in query, or list several in queries.
3. Keep the default proxyConfiguration (Residential, South Korea) for reliable results.
4. Click Start and watch resolved rows land in the dataset in real time.
5. Export the results as JSON, CSV, or Excel, or pull them via the Apify API into your own pipeline.

한국어: 검색어를 하나 또는 여러 개 입력하고 실행(Start)하면 결과가 실시간으로 데이터셋에 저장됩니다. JSON, CSV, Excel로 내보내거나 API로 바로 가져올 수 있습니다.

Python

from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("parsebird/naver-ai-overview-api").call(run_input={
    "queries": ["당뇨병 증상", "전기차 보조금"],
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["query"], item["ai_overview_present"])

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('parsebird/naver-ai-overview-api').call({
    queries: ['당뇨병 증상', '전기차 보조금'],
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

How much does it cost to use Naver AI Overview API?

Naver AI Overview API uses pay-per-event pricing — you're charged once per query resolved (whether or not Naver showed an AI Overview for it), never for compute time, and never for a failed request.

Event	Price per event	Price per 1,000
Query resolved (Free plan)	$0.01699	$16.99
Query resolved (Bronze plan)	$0.01649	$16.49
Query resolved (Silver plan)	$0.01599	$15.99
Query resolved (Gold plan)	$0.01549	$15.49

Resolving 1,000 queries costs $16.99 on the Free plan, down to $15.49 on the Gold plan — see the Pricing tab for details. Failed requests are never charged.

한국어: 검색어 1건이 해결(resolve)될 때마다 한 번 과금되며, AI 브리핑이 없더라도(=ai_overview_present: false) 결과가 반환되면 과금됩니다. 요청이 실패한 경우는 과금되지 않습니다.

Is it legal to use Naver AI Overview API?

Naver AI Overview API only collects the AI Overview content that Naver publicly displays on search.naver.com for a given query, without logging in or bypassing any access control. Scraping publicly available data is generally legal, but you're responsible for how you use the data — always review Naver's Terms of Service and consult Apify's guide on the legality of web scraping before reusing content commercially, especially medical or legal information, which is provided by Naver's AI "for reference only."

한국어: 이 액터는 로그인 없이 search.naver.com에서 공개적으로 표시되는 AI 브리핑 콘텐츠만 수집합니다. 공개 데이터 수집은 일반적으로 합법이지만, 특히 의료·법률 정보는 참고용으로만 사용하고 활용 방식에 대한 책임은 사용자에게 있습니다.

Related Actors

• Naver Shopping Scraper — product listings from Naver Brand Store
• Naver Map Scraper — places, ratings, and business info from Naver Map
• Naver Blog & Cafe Scraper — posts and comments from Naver Blog and Cafe
• Naver Place Review Scraper — reviews from Naver Place listings

FAQ

What is Naver's AI Overview (AI 브리핑)? It's an AI-generated answer box Naver shows above organic results for many search queries — summarizing several web sources into one answer, with citations, similar to Google's AI Overviews.

Does every query return an AI Overview? No. Many queries — obscure, ambiguous, or navigational ones — show no AI Overview at all, or Naver may generate one live in the browser instead of pre-rendering it. Both cases return ai_overview_present: false with a note explaining why, not an error.

Can I query in English or another language? Yes — query/queries accept any text Naver's search box accepts, including non-Korean queries, though the AI Overview itself (when shown) is generated in Korean.

Why does the Actor use a Residential (KR) proxy by default? Naver's AI Overview renders most consistently for South Korean IPs. Keep the default proxy setting for reliable results.

Can I schedule recurring runs? Yes. Use Apify's Scheduler to re-run a fixed list of queries daily or weekly and track how Naver's AI answers change over time.

Something looks wrong or a query won't resolve — what do I do? Open an issue on the Actor's Issues tab with the query and run URL. Naver updates its AI Overview format periodically; report it and it'll be investigated.

한국어: AI 브리핑은 검색어에 따라 표시되지 않을 수 있으며, 이 경우 오류가 아닌 ai_overview_present: false와 설명이 담긴 결과가 반환됩니다. 문제가 발견되면 Actor의 Issues 탭에 검색어와 실행 URL을 남겨주세요.