# Naver Shopping Scraper (`dami_studio/naver-shopping-scraper`) Actor

Naver Shopping scraper (네이버쇼핑) for products, prices and stores: type a keyword and get the products Naver shows, one row each with name, price and discount, store, delivery promise, rating, review count, purchase and wish counts and links. Sponsored products are flagged. $2.40 per 1,000 products.

- **URL**: https://apify.com/dami_studio/naver-shopping-scraper.md
- **Developed by:** [Dami's Studio](https://apify.com/dami_studio) (community)
- **Categories:** E-commerce
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.40 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

**Naver Shopping scraper: search by keyword and get one row per product**: name, price and discount, coupon price, store,
delivery promise, rating, review count, purchase and wish counts, category IDs and links, with sponsored products
flagged.

Each keyword returns the products Naver shows for it on its own results page, usually 50 to 100, in that page's order.
Korean keywords find the most, since that is what Korean shoppers type.

| | |
|---|---|
| **Input** | Keywords, in Korean or English: 노트북, 원피스, Galaxy S25 |
| **Output** | One row per product: name, price, discount, coupon price, store and its badge, delivery promise, rating, review count, purchases, wish-list saves, category IDs, product and store links |
| **Ceiling** | About 50 to 100 products per keyword, 200 keywords and 100,000 products per run |
| **Speed** | About a second a keyword in our runs, after a few seconds to start |
| **Account needed** | None from you |
| **Price** | $2.40 per 1,000 products, the same price on every plan. The free plan's $5 a month covers about 2,000 |

| Using an AI agent? | |
|---|---|
| Actor | `dami_studio/naver-shopping-scraper` |
| Set one field | `keywords`, labelled "Keywords" in the Console |
| Cap the bill | `maxTotalChargeUsd` on the run, for example `0.10`: it never charges past that |
| MCP, one link | `https://mcp.apify.com/?tools=fetch-actor-details,dami_studio/naver-shopping-scraper` |
| How often | Daily, to follow prices and best sellers for a set of keywords |

### 🔍 What Naver Shopping Scraper does

It searches each keyword and reads the products Naver puts on its results page: price-comparison catalogues (one
product many stores sell, with its lowest offer and how many stores), single-store products and sponsored placements,
in the order the page shows them. For fashion and other browse-style keywords the page shows Naver Shopping's
popular-products list instead, and that is what comes back, up to 96 products.

Sponsored products stay out unless you turn on **Include sponsored products**. Then they come flagged, with their place
among the other sponsored ones.

Your price band and categories are checked on every row, and a product they leave out is never charged. A product two
of your keywords both find is delivered once, under the first keyword.

### 📋 What data you get from each Naver Shopping product

| What you get | Field |
|---|---|
| The product's ids, name and links | `nvMid`, `catalogId`, `channelProductId`, `originalMallProductId`, `channelNo`, `productName`, `productUrl`, `mobileProductUrl` |
| A catalogue or a single store's product | `productType` (`CATALOG` or `STORE`) |
| Where it came up | `keyword`, `searchSource`, `searchRank`, `sponsoredRank`, `pagePosition`, `resultPage` |
| Sponsored or not | `isSponsored`, `sponsoredText` |
| Price | `currency`, `salePrice`, `discountedSalePrice`, `discountedRatio`, `couponPrice` |
| Catalogue prices | `lowestPrice`, `sellerCount`, `purchaseOptions` |
| Demand | `averageReviewScore`, `totalReviewCount`, `purchaseCount`, `keepCount` |
| The store | `mallName`, `mallId`, `mallSeq`, `mallBadge`, `storeUrl`, `isBrandStore`, `isSmartStoreProduct`, `isIndividualSeller` |
| Delivery | `deliveryFee`, `freeDelivery`, `deliveryFeeTypes`, `fastDeliveryType`, `arrivalGuarantee`, `deliveryPlan` |
| Points and promotions | `naverPayPoints`, `isMembershipFreeDelivery`, `promotionTypes`, `isHotDeal` |
| Flags | `isNewProduct`, `isOverseaProduct`, `isCustomsDutySeparate` |
| Category | `lCatId`, `mCatId`, `sCatId`, `ssCatId`, `leafCategoryId` |
| Pictures | `imageUrl`, `images` |
| When it was read | `scrapedAt` |

### ▶️ How to scrape Naver Shopping products

1. Open [Naver Shopping Scraper](https://apify.com/dami_studio/naver-shopping-scraper) and click **Try for free**.
2. Type your keywords into **Keywords**, one per line.
3. Set **Max products per keyword**, and a price band or **Categories** if you want them.
4. Click **Start**, then download the rows as JSON, CSV or Excel, or read them from the API.

Start it with no keyword and it returns one free sample row, so you can see the shape first.

### 💰 How much does it cost to scrape Naver Shopping products?

**$2.40 per 1,000 products**, the same price on every plan. On the free plan, the $5 Apify gives you each month covers
about 2,000 products.

You pay for product rows only. The sample row and note rows are free, and so is any product your filters leave out or
that an earlier keyword in the same run already delivered.

### 📥 What you give it

```json
{
  "keywords": ["노트북", "원피스"],
  "maxProductsPerKeyword": 50,
  "includeSponsored": false
}
```

| Field | If you leave it empty | What it is |
|---|---|---|
| `keywords` | one free sample row | Keywords, one per line, up to 200. Korean works best; brand and model names work in English too. |
| `searchSource` | `NAVER_SEARCH` | Where the results come from: the products Naver shows on its own results page for the keyword. |
| `maxProductsPerKeyword` | 100 | Products kept per keyword, from the top of Naver's order, 1 to 10,000. A keyword brings at most what the page shows. |
| `maxItems` | no cap | Products in the whole run, 1 to 100,000. Your cost ceiling. |
| `includeSponsored` | off | Keep the sponsored products Naver mixes in, flagged `isSponsored: true`. |
| `minPrice`, `maxPrice` | no limit | A price band in won, matched on `discountedSalePrice`. A minimum above the maximum is refused. |
| `categories` | every category | Naver category IDs, eight digits, such as 50000151 for laptops. A product matches when any of its category levels is one of them. |

A value the run can't use stops it before any search, with a free row that says what to change.

### 📤 What you get back

A real row from a run on 7 November 2026, trimmed:

```json
{
  "recordType": "product",
  "productType": "STORE",
  "nvMid": "88693886707",
  "productName": "베이직스 노트북 베이직북 16인치 사무용 업무용 대학생 인강용 가벼운 16GB 512GB",
  "productUrl": "https://smartstore.naver.com/main/products/11149376385",
  "keyword": "노트북",
  "searchRank": 2,
  "isSponsored": false,
  "currency": "KRW",
  "salePrice": 1077300,
  "discountedSalePrice": 798000,
  "discountedRatio": 25,
  "couponPrice": 793000,
  "averageReviewScore": 4.81,
  "totalReviewCount": 8451,
  "purchaseCount": 1003,
  "keepCount": 4768,
  "mallName": "베이직스 스토어",
  "mallBadge": "공식",
  "storeUrl": "https://smartstore.naver.com/basic-s",
  "freeDelivery": true,
  "fastDeliveryType": "ARRIVAL_GUARANTEE",
  "deliveryPlan": { "tagType": "TOMORROW", "orderDeadline": "2026-11-08T14:00:00.000Z", "guaranteedDay": 1 },
  "naverPayPoints": 7980,
  "lCatId": "50000003",
  "leafCategoryId": "50000151"
}
```

| Field | How to read it |
|---|---|
| `salePrice`, `discountedSalePrice` | The list price and the price after Naver's discount, in won. `salePrice` is null when the card shows one price only. |
| `couponPrice` | The price with the store coupon the card shows. |
| `lowestPrice`, `sellerCount` | On a catalogue, the lowest offer among its stores and how many stores sell it. Null on a single store's product. |
| `purchaseCount`, `keepCount` | Purchases and wish-list saves, as Naver counts them on the card. |
| `mallBadge` | The store's badge: 공식 for an official store, 인증 for a certified one. |
| `deliveryPlan` | The delivery promise: `TOMORROW` with the order cut-off and the arrival time, in UTC. |
| `searchRank`, `sponsoredRank` | The place among regular results, or among sponsored ones. `pagePosition` counts every card on the page. |
| `deliveryFee`, `freeDelivery` | Null on a catalogue, where each store sets its own. |

### 🧾 Reading the output

| Row | How to spot it | Charged |
|---|---|---|
| A product | `recordType: "product"` | Yes |
| The sample | `recordType: "sample"`, `_sample: true`, written only when no keyword was given | No |
| A note | `recordType: "note"`, `ok: false`, `_diagnostic: true`, with an `errorCode` | No |

The note codes: `BAD_INPUT` (a value the run can't use; nothing was searched), `NO_RESULTS` (Naver showed nothing for
the keyword, or nothing passed your filters), `NOT_SERVED` (that keyword wasn't served this run; run it again later),
`TIME_LIMIT` and `COST_LIMIT` (the run reached its time or spending limit; what came before is kept), `UNREADABLE`
(the page came back but its product list couldn't be read; please report it) and `UNEXPECTED_ERROR`. Filter on
`recordType = "product"` to keep only products.

### 💡 What people use it for

- You sell in Korea and want to know what a keyword's top products cost this week, and which stores sell them.
- You follow a category's best sellers: one keyword per product type, `purchaseCount` and `keepCount` read daily.
- You price a product before listing it on Smart Store, from a catalogue's `lowestPrice` and `sellerCount`.
- You check who buys the sponsored slots on your keywords: `includeSponsored` on, rows where `isSponsored` is true.

A recipe for a daily price sheet: schedule a run with your keywords, keep `recordType = "product"`, and match rows on
`nvMid` from one day to the next to see prices and purchase counts move.

### 🚧 What it does not do

- Prices are what Naver shows a signed-out visitor at that moment. Member prices and coupons you claim at checkout can make your own price lower.
- It doesn't sign in or act on a Naver account.
- It doesn't collect anyone's contact details.
- It is not an official Naver tool. Dami's Studio is independent and is not affiliated with or endorsed by Naver, or by any other company named on this page.

### 🧭 Which shopping scraper do you need?

| If you want | Use |
|---|---|
| Products, prices and stores for a keyword on Naver Shopping | This one |
| The same keyword search on Taobao and Tmall, for products sold in China | [Taobao Scraper](https://apify.com/dami_studio/taobao-scraper) |
| The same keyword search on Amazon | [Amazon Scraper](https://apify.com/dami_studio/amazon-scraper) |

### ❓ Questions people ask

#### Do I need a Naver account to scrape Naver Shopping?

No. You don't need a Naver account, and the run reads what a visitor who isn't signed in sees.

#### Why don't the prices match what I see on Naver?

Naver shows member prices, coupons and points differently depending on who is signed in, the time and the device, and
sponsored slots change by the minute. Open the same keyword in a private browser window, signed out, before comparing.

#### How do I keep only one kind of product?

Every row carries its category IDs, `lCatId` down to `leafCategoryId`. Run once, note the ID of the category you want,
then put it in **Categories** next time: products in other categories are left out and not charged.

#### Can I call it from code or an AI assistant?

Yes. The actor's API tab has ready calls, and its MCP address is
`https://mcp.apify.com/?tools=fetch-actor-details,dami_studio/naver-shopping-scraper`. In Python:

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("dami_studio/naver-shopping-scraper").call(
    run_input={"keywords": ["노트북"], "maxProductsPerKeyword": 50},
    max_total_charge_usd=0.10,
)
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    if row.get("ok") is False:
        continue
    print(row["productName"], row["discountedSalePrice"], row["mallName"])
```

#### Is scraping Naver Shopping legal?

The products are public listings, read the way a signed-out visitor sees them, with no account and nothing private. A
store name can be personal data where the seller is a person, so GDPR and similar laws apply, Korea's included: keep
what you need. Naver's own terms still apply to what you do with the data. Apify has a longer read on
[whether web scraping is legal](https://blog.apify.com/is-web-scraping-legal/). We are not lawyers.

### 🆘 If something breaks

Open an issue on the actor's Issues tab with the run's link and the keyword. A note row's `errorCode` and `message`
help most.

# Actor input Schema

## `keywords` (type: `array`):

What to search for, one per line. Korean works best (노트북 for laptops), English brand and model names work too. Each keyword is searched on its own.

## `searchSource` (type: `string`):

NAVER_SEARCH: the shopping products Naver shows on its own search results page for the keyword, in that page's order, usually 50 to 100 a keyword.

## `maxProductsPerKeyword` (type: `integer`):

How many products to keep for each keyword, from the top of Naver's order.

## `maxItems` (type: `integer`):

Optional. Stops the run once this many products are delivered, whatever the keywords. Leave empty for no run-wide cap.

## `includeSponsored` (type: `boolean`):

Keep the sponsored products Naver mixes into the results, flagged isSponsored: true, with their place on the page. Off keeps only the regular results.

## `minPrice` (type: `integer`):

Only products at or above this price in won, matched on the price after discount. Products left out are not charged.

## `maxPrice` (type: `integer`):

Only products at or below this price in won, matched on the price after discount. Products left out are not charged.

## `categories` (type: `array`):

Only products in these Naver categories, by ID (eight digits, such as 50000151 for laptops). Every row carries its own category IDs in lCatId to ssCatId, so one run tells you what to use next time.

## Actor input object example

```json
{
  "keywords": [
    "노트북"
  ],
  "searchSource": "NAVER_SEARCH",
  "maxProductsPerKeyword": 100,
  "includeSponsored": false
}
```

# Actor output Schema

## `results` (type: `string`):

Every row in the default dataset. Product rows have recordType "product": productType, nvMid, catalogId, channelProductId, productName, productUrl, keyword, searchRank, isSponsored, salePrice, discountedSalePrice, discountedRatio, couponPrice, lowestPrice, sellerCount, averageReviewScore, totalReviewCount, purchaseCount, keepCount, mallName, storeUrl, delivery fields, category IDs and images. Rows with recordType "note" are free and say what happened instead.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "노트북"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("dami_studio/naver-shopping-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": ["노트북"] }

# Run the Actor and wait for it to finish
run = client.actor("dami_studio/naver-shopping-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "노트북"
  ]
}' |
apify call dami_studio/naver-shopping-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dami_studio/naver-shopping-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/JAaiL1dNuD0y7aQyP/builds/agQcERypA2kfaaj9e/openapi.json
