한국어 안내 (Korean)

소개

한국 최대 검색 엔진 네이버를 검색하고, 웹·뉴스·이미지·동영상·쇼핑 등 다섯 가지 결과 유형을 깔끔한 JSON으로 받을 수 있습니다. 여러 검색어를 한 번에 실행하고, 검색 영역을 선택하고, 페이지네이션과 내보내기까지 지원합니다. 한국 시장 조사, K-콘텐츠 인텔리전스, 이커머스 가격 분석, SEO, AI 에이전트 연동에 적합합니다. 결과 건당 과금이며 월 최소 요금은 없습니다.

네이버는 한국 검색 시장을 지배하며, Google과는 전혀 다른 결과 구조를 가집니다. 이 API는 HTML 파싱 대신 정형화된 행(row) 데이터로 결과를 제공하므로, 한국 웹·뉴스 흐름·상품 시장·동영상 생태계를 바로 분석할 수 있습니다.

제공 기능

where 입력값으로 검색 영역을 선택합니다. 통합 검색(nexearch)은 한 번의 호출로 여러 결과 블록을 반환하고, 단일 영역 검색은 해당 유형에 집중해 페이지네이션합니다.

where 값	반환 내용	주요 필드
nexearch (기본값)	통합 검색: 광고 + 웹 + 쇼핑 + 뉴스 블록	혼합, result_type으로 구분
web	웹 자연 검색 결과	title, link, snippet, source, displayed_link
news	뉴스 결과	title, link, snippet, news_info (언론사, 날짜)
image	이미지 결과	title, link, original, width, height, thumbnail
video	동영상 결과	title, link, channel, duration, views, publish_date

모든 행에는 result_type (web_organic, ad, shopping, news, image, video), 원본 query, where 영역, position(순위)이 포함됩니다.

활용 사례

• 브랜드·인물·주제에 대한 한국 뉴스 흐름을 여러 검색어로 추적
• 네이버 쇼핑 가격·평점·리뷰 수를 수집해 경쟁 가격 분석
• K-뷰티, K-pop, K-콘텐츠 키워드를 웹·뉴스·동영상에서 모니터링
• 검색·NLP·AI 학습용 한국어 데이터셋 구축
• MCP 한 번의 호출로 AI 에이전트에 실시간 네이버 검색 결과 제공

입력

필드	타입	설명
query	string	단일 검색어. 한국어 또는 다른 언어 가능 (예: 서울 맛집). query, queries 중 하나 또는 둘 다 입력
queries	string 배열	여러 검색어를 한 번에 실행. query와 병합 후 중복 제거
where	string	검색 영역: nexearch(통합, 기본값), web, news, image, video
maxResultsPerQuery	integer	검색어당 결과 행 수. 기본 30, 최대 300

입력 예시

{
  "queries": ["서울 맛집", "부산 여행"],
  "where": "web",
  "maxResultsPerQuery": 30
}

출력 예시

{
  "result_type": "web_organic",
  "query": "서울 맛집",
  "where": "web",
  "position": 1,
  "title": "서울 맛집 베스트 30",
  "link": "https://example.co.kr/seoul-restaurants",
  "snippet": "서울에서 꼭 가봐야 할 맛집을 정리했습니다 ...",
  "source": "example.co.kr",
  "displayed_link": "example.co.kr"
}

쇼핑 행에는 price, rating, reviews, stores가 추가됩니다. 동영상 행에는 channel, duration, views가, 이미지 행에는 original, width, height가 포함됩니다.

---

Naver Search API | Web, News, Image, Video, Shopping (Korea)

Search Naver, South Korea's largest search engine, and get clean structured JSON across five result types: web organic, news, images, video, and shopping. Run many queries at once, pick the vertical, paginate, and export. Built for Korean market research, K-content intelligence, e-commerce pricing, SEO, and AI agents. Pay per result, with no monthly minimum.

Naver dominates search in Korea, and its results look nothing like Google's. This API gives you that data as structured rows instead of brittle HTML, so you can analyze the Korean web, news cycle, product market, and video landscape directly.

What you get

Pick a vertical with the where input. The integrated view returns several result blocks in one call; the single-vertical views drill in and paginate.

where value	Returns	Typical fields
nexearch (default)	Integrated page: ads + web + shopping + news blocks	mixed, tagged by result_type
web	Web organic results	title, link, snippet, source, displayed_link
news	News results	title, link, snippet, news_info (press, date)
image	Image results	title, link, original, width, height, thumbnail
video	Video results	title, link, channel, duration, views, publish_date

Every row carries a result_type (web_organic, ad, shopping, news, image, video), the query it came from, the where vertical, and a position.

Use cases

• Track the Korean news cycle for a brand, person, or topic across many queries
• Pull Naver shopping prices, ratings, and review counts for competitive pricing
• Monitor K-beauty, K-pop, and K-content terms across web, news, and video
• Build Korean-language datasets for search, NLP, or AI training pipelines
• Give an AI agent live Naver results for the Korean market in one MCP call

🔌 Integrations: Automate Naver API Monitoring

A single run answers one question: what is on Naver for this query right now. The real value of the Naver API shows up when you run it on a schedule and let the results pile up, so you can watch the Korean news cycle, shopping prices, and keyword rankings shift over time. This section wires the Actor into a recurring pipeline. See Apify platform integrations for the full catalog.

Tasks and schedules (Naver tracking on autopilot)

Save one task per thing you track: a task for 삼성전자 in news, another for a K-beauty brand in shopping, another for a keyword in web. Then attach a schedule from the Actor's Actions, then Schedule menu. One schedule can fire many tasks at once, so a whole watchlist runs from a single trigger.

Common cron strings:

0 7 * * *      daily at 7 AM
0 */6 * * *    every six hours
0 9 * * 1      every Monday morning

The Monitor Samsung coverage with Naver news search task is a ready-made example of this monitoring pattern.

n8n

This Actor ships as an n8n community node, n8n-nodes-naver-search-api (install steps are in the n8n section further down). A typical workflow is four nodes: a Schedule Trigger, the Naver Search node, a Filter (for example, keep only new links), then a Slack or email node for the alert. For the generic path, see the Apify n8n integration.

Make and Zapier

The same recipe runs no-code in Make and Zapier: trigger on a schedule, run the Actor, then push each result row to a sheet, a database, or a chat channel.

Supabase and storage (build Naver data history)

To keep a queryable history, run the Actor and bulk-insert the flat result rows into a table. This Python snippet uses apify-client and supabase:

from apify_client import ApifyClient
from supabase import create_client

apify = ApifyClient("YOUR_APIFY_TOKEN")
supabase = create_client("https://YOUR_PROJECT.supabase.co", "YOUR_SERVICE_KEY")

run = apify.actor("johnvc/naver-search-api").call(run_input={
    "query": "서울 맛집",
    "where": "web",
    "maxResultsPerQuery": 30,
})

rows = []
for item in apify.dataset(run["defaultDatasetId"]).iterate_items():
    rows.append({
        "result_type": item.get("result_type"),
        "query": item.get("query"),
        "where": item.get("where"),
        "position": item.get("position"),
        "title": item.get("title"),
        "link": item.get("link"),
        "source": item.get("source"),
    })

supabase.table("naver_results").insert(rows).execute()

Run it on the same schedule and each pass appends a new snapshot, so you can chart ranking or price movement over time. The no-code equivalent is an n8n Actor node followed by a Supabase node.

MCP and AI agents

Point an AI agent at the hosted Apify MCP server and it can call this Naver API directly, for example: "search Naver news for 삼성전자 and summarize the top 10 headlines." Full per-client setup for Claude, Cursor, ChatGPT, and others is in the Use this API from AI agents (MCP) section further down. With Claude Code (free trial) or any MCP client, you can turn a Naver search into a report in a single prompt.

Webhooks

For anything custom, attach an Apify webhook on the ACTOR.RUN.SUCCEEDED event to POST the dataset to your own endpoint the moment a run finishes.

Input

Field	Type	Description
query	string	A single search query, in Korean or any language, e.g. 서울 맛집. Provide this, queries, or both.
queries	array of strings	A batch of queries to run in one go. Merged with query and de-duplicated.
where	string	Vertical to search: nexearch (integrated, default), web, news, image, or video.
maxResultsPerQuery	integer	Result rows per query. Default 30, maximum 300.

Example input

{
  "queries": ["서울 맛집", "부산 여행"],
  "where": "web",
  "maxResultsPerQuery": 30
}

Sample output

{
  "result_type": "web_organic",
  "query": "서울 맛집",
  "where": "web",
  "position": 1,
  "title": "서울 맛집 베스트 30",
  "link": "https://example.co.kr/seoul-restaurants",
  "snippet": "서울에서 꼭 가봐야 할 맛집을 정리했습니다 ...",
  "source": "example.co.kr",
  "displayed_link": "example.co.kr"
}

A shopping row adds price, rating, reviews, and stores; a video row adds channel, duration, and views; an image row adds original, width, and height.

Pricing

Pay-per-result: a small actor_start fee plus a per-result charge. The per-result price scales down with your Apify plan.

Plan	Per result	Start fee
Free	$0.005	$0.00005
Bronze	$0.004	$0.00005
Silver	$0.0035	$0.00005
Gold	$0.003	$0.00005

Beyond a negligible per-run start fee, you only pay for the result rows you receive. No monthly minimum.

How to get started

1. Open Naver Search API on the Apify Store.
2. Enter a query (or a queries list) and pick a where vertical.
3. Set maxResultsPerQuery, then run the Actor.
4. Export the dataset as JSON, CSV, or Excel, or pull it from the API.

Prefer code? See the Naver Search API example repo for a Python quick-start and MCP setup guides.

Run from the API

curl -X POST "https://api.apify.com/v2/acts/johnvc~naver-search-api/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"서울 맛집","where":"web","maxResultsPerQuery":20}'

🔌 Use this API from AI agents (MCP)

This Actor works with the Model Context Protocol (MCP), an open standard that lets AI assistants call external tools. Instead of copying curl commands or pasting JSON into a chat, your agent can search Naver directly: pick a vertical (web, news, image, video, or integrated nexearch), run batch queries, and read structured rows back into the conversation.

Why connect via MCP?

• Live Korean search data - Agents get current Naver results (news, shopping prices, video metadata) without you writing API glue code.
• Structured output - Each row includes result_type, query, position, and vertical-specific fields, so the model can summarize, compare, or export without parsing HTML.
• Pay per result - Runs use your Apify account; you only pay for rows returned, same as running the Actor in the Console.
• Works across clients - One hosted Apify MCP server connects to Cursor, Claude, ChatGPT, and other MCP-capable tools.

Prerequisites

Before you connect any client:

1. Apify account - Sign up if you do not have one.
2. Apify API token - From Settings → API & Integrations in Apify Console. The hosted MCP server uses OAuth on first connect, or you can pass the token in an Authorization header (see Apify MCP docs).
3. An MCP-capable client - Cursor, Claude Desktop, Claude on the web, Claude Code, Claude Cowork (free trial), or ChatGPT (Developer Mode; plan details below).

Actor-specific MCP URL

Use this URL so the Apify MCP server loads Actor discovery, Apify docs search, and this Naver Search API as callable tools:

https://mcp.apify.com/?tools=actors,docs,johnvc/naver-search-api

You can also build the same URL in the Apify MCP configurator (select tools visually, then copy the config or one-click install for supported clients).

Example prompt after setup: "Search Naver news for 삼성전자 and return the top 20 results with title, link, and press name."

Video walkthrough: Integrate Apify Actors with Claude via MCP

Full reference: Apify MCP server documentation

MCP setup by client

The hosted server URL is the same everywhere: paste https://mcp.apify.com/?tools=actors,docs,johnvc/naver-search-api (or use OAuth with https://mcp.apify.com and add this Actor via tool selection). On first connect, your browser opens to sign in to Apify and authorize the connection.

Visual setup guides for each client (source and more assets: ApifyPublicData on GitHub):

Claude Cowork Desktop

Cowork runs multi-step agent tasks on your machine (free trial). Remote MCP connectors are tied to your Claude account; traffic to Apify goes through Anthropic’s infrastructure, not a local stdio process.

1. Open Settings → Connectors (or Customize → Connectors).
2. Click Add custom connector and paste the Actor-specific MCP URL above.
3. Complete OAuth when prompted (Apify sign-in).
4. In a Cowork task, ask for a Naver search; the agent can call the Naver Search API tool.

• Install guide: Get started with custom connectors (remote MCP)
• Connectors page: claude.ai/customize/connectors
• Try Cowork: Claude Cowork (free trial)

Claude Code

Claude Code is Anthropic’s terminal-based coding agent (free trial). Add the Apify MCP server with the CLI or a project config file so coding sessions can pull Naver data while building scripts or dashboards.

CLI (HTTP / recommended):

$claude mcp add --transport http apify "https://mcp.apify.com/?tools=actors,docs,johnvc/naver-search-api"

Then run /mcp inside a session to verify the server and list tools. Authenticate via OAuth when prompted.

Project file: Add the same URL under mcpServers in .mcp.json at your project root (share the server definition with your team; keep tokens in env or OAuth, not in git).

• Install guide: Connect Claude Code to tools via MCP
• Try Claude Code: Claude Code (free trial)

Claude (website - claude.ai)

On the web app, custom connectors use the same remote MCP flow as Cowork. Free plans can add one custom connector; Pro/Max/Team/Enterprise allow more (see Anthropic’s connector limits).

1. Go to Customize → Connectors.
2. Click + → Add custom connector.
3. Paste the Actor-specific MCP URL and finish OAuth with Apify.
4. Start a chat and enable the connector for that conversation.

• Install guide: Get started with custom connectors using remote MCP
• Local desktop alternative: Claude Desktop MCP / extensions (search the connector directory for “Apify” or add the same remote URL under Settings → Connectors)

Cursor

Cursor’s agent can call MCP tools from Composer and Chat. Apify’s configurator offers a one-click Add to Cursor button; you can also edit JSON manually.

1. Open Cursor Settings → MCP (or create .cursor/mcp.json in your project, or ~/.cursor/mcp.json globally).
2. Add the Apify server with the Actor-specific URL:

{
  "mcpServers": {
    "apify-naver": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/naver-search-api"
    }
  }
}

3. Restart Cursor or reload the window. On first use, complete Apify OAuth in the browser.
4. In Agent mode, ask for a Naver search; confirm apify-naver tools appear under available MCP tools.

• Install guide: Model Context Protocol (MCP) - Cursor Docs
• Apify + Cursor details: Apify MCP - Cursor section

ChatGPT

ChatGPT connects to remote HTTPS MCP servers through Developer Mode (Apps / Connectors). Availability depends on your plan: Pro users can add custom connectors with read-oriented tools; full write-capable MCP is primarily for Business, Enterprise, and Edu workspaces (OpenAI Help Center).

1. Settings → Apps & connectors → Advanced - turn on Developer Mode (workspace admins may need to enable this for Business/Enterprise).
2. Connectors → Create - name the app (e.g. “Apify Naver”), paste the Actor-specific MCP URL, choose auth (OAuth is recommended for Apify).
3. Authorize when ChatGPT lists the tools, then prompt in a new chat with the app enabled.

If your MCP server is only on a private network, OpenAI’s Secure MCP Tunnel can expose it without a public URL.

🔗 Related Tools

Building Korean or multi-market search intelligence? These related APIs from the same portfolio pair well with the Naver Search API:

• Naver AI Overview API (Korean AEO monitoring) - track Naver's AI-generated answer boxes so you can see how brands and topics surface in Korean answer engines, alongside the organic results this API returns.
• Baidu Search API - the equivalent structured search API for China's dominant engine, for teams covering more than one Asian market.
• Yandex Search API - structured Yandex results for Russia and the CIS, another market where Google is not the default engine.
• Google News API - pair Naver's Korean news vertical with global Google News coverage for cross-border media monitoring.

For contrast, single-vertical Naver scrapers exist, for example the Naver Blog Scraper, but it covers one surface only (blog posts), carries a much higher per-result price, and was last updated months ago. This Naver Search API returns web, news, image, video, and shopping results from one endpoint with clean, structured rows.

FAQ

What is nexearch?

It is Naver's integrated results page. One call returns several blocks at once (ads, web, shopping, news), each row tagged with its result_type. Use it for a broad snapshot; use web, news, image, or video to go deep on one type.

Can I search in Korean?

Yes. Queries can be Korean or any language. Naver indexes the Korean web, so Korean queries return the richest results. Naver is South Korea's most-used search engine; there is background on Wikipedia, or you can visit naver.com directly.

How many results per query?

Set maxResultsPerQuery (default 30, maximum 300). The Actor paginates and stops early when a query runs out of results, so you only pay for what exists.

Does it return shopping prices?

Yes. Shopping rows include price, rating, reviews, and stores. Shopping blocks appear in the integrated nexearch view for product-intent queries.

Can I run many queries at once?

Yes. Pass a queries list; each is searched independently and tagged with its source query.

Can I schedule this Naver API for ongoing tracking?

Yes, and this is where most of the value is. Any run can be automated on a schedule: save a task with your query and where vertical, then attach a schedule from the Actor's Actions, then Schedule menu. Concrete cron strings: 0 7 * * * for daily at 7 AM, 0 */6 * * * for every six hours, 0 9 * * 1 for Monday mornings. One schedule can trigger many tasks at once, so an entire Naver watchlist runs from a single trigger. See the Integrations section above for the full monitoring recipe.

Should I use an API or a web scraper for Naver?

Both, and this Actor is both. An official API is usually rate limited, quota bound, and missing fields; a hand-built web scraper breaks whenever the HTML changes. This Actor gives you the same Naver data as a no-code scraper you run in the Console, or as a clean API endpoint you call yourself, returning structured rows instead of raw HTML and with no per-day quotas. New to the terms? Here is a neutral primer on web scraping.

Can I integrate this Naver Scraper with other apps?

Yes. The Actor connects to almost any cloud service through Apify integrations: Make, Zapier, Slack, n8n, and more, plus webhooks that fire on ACTOR.RUN.SUCCEEDED for custom actions. The Integrations section above has copy-paste recipes.

Can I use the Naver Search API with the Apify API?

Yes. The Apify API gives programmatic access to run the Actor, schedule it, and fetch datasets, and the apify-client package is available for both Node.js and Python. See this Actor's own API tab for ready-made snippets and endpoints.

Can I use this Naver API through an MCP server?

Yes. Add it as a tool to any MCP client (Claude, Cursor, and others) through the hosted Apify MCP server. Use the Actor-specific URL https://mcp.apify.com/?tools=actors,docs,johnvc/naver-search-api so the agent loads this Naver API as a callable tool. With Claude Code (free trial) or Claude Cowork you can search Naver from the terminal or a chat. Details are in the Apify MCP docs.

How can I track other search engines and Korean data sources?

For Naver's AI answer boxes, add the Naver AI Overview API. For other markets where Google is not the default engine, use the Baidu Search API for China and the Yandex Search API for Russia, and pair Korean coverage with the Google News API. Single-vertical alternatives such as the Naver Blog Scraper cover only one surface; this API returns five verticals from one endpoint.

n8n integration

Available as an n8n community node, n8n-nodes-naver-search-api. In n8n: Settings, Community Nodes, install n8n-nodes-naver-search-api, then use it in any workflow (it also works as an AI Agent tool).

Featured Tasks

Ready-to-run examples that show this API solving a specific problem. Each opens its own setup so you can run it on your account in one click.

• Search Naver Images by keyword - Search Naver Images for any keyword and get structured results.
• Search Naver News by keyword - Search Naver News for any keyword and track Korean coverage.
• Get Naver web search results by API - Get Naver web search results for any keyword by API.
• Search Naver Video results by keyword - Search Naver Video results for any keyword.
• Export Naver Search Results to CSV - Search Naver and download the results as a CSV: title, link, source, and position for each result.
• Monitor Samsung coverage with Naver news search - Search Naver News for Samsung coverage by API.
• Search Naver from Claude via MCP for Korean research - Give Claude live Naver search through MCP.
• Track Naver keyword rankings for K-beauty brands - Track how K-beauty brands rank on Naver search.

Last Updated: 2026.07.13