# Naver Shopping Scraper | Product Prices by Keyword (`genial_candlestand/naver-shopping-product-search-scraper`) Actor

Get Naver Shopping (네이버쇼핑) products by keyword: title, price, discount, coupon price, delivery fee, rating, reviews, purchases, store and ad flag. Many keywords per run, optional product ID filter, no login, Korean residential proxy by default.

- **URL**: https://apify.com/genial_candlestand/naver-shopping-product-search-scraper.md
- **Developed by:** [Flowo](https://apify.com/genial_candlestand) (community)
- **Categories:** E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 | Product Prices by Keyword

![Naver Shopping Scraper | Product Prices by Keyword](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/shopping-naver-com-product-details-banner-5102cf17.png)

Get Naver Shopping (네이버쇼핑) products by keyword. Each result has the product title, price, original price, discount rate, coupon price, delivery fee, rating, review count, purchase count, store name and an ad flag. Catalog (price-comparison) products also show the number of sellers. No login and no API key are needed.

### What does Naver Shopping Scraper do?

You give the actor one or more search terms (Korean or English). For each term it returns the product cards that Naver Shopping shows for that keyword, up to about 90 per term, in Naver's own order (the position field). Every card becomes one flat dataset row with prices in KRW, delivery data, rating, reviews, store and category ids.

It suits price monitoring, rank tracking of your own products or competitors, and market research on Korean e-commerce.

### How to scrape Naver Shopping products

![How Naver Shopping Scraper works: Requests the Naver mobile search page for each keyword; Reads the product cards embedded in the page, in Naver order; Retries a blocked page with a new Korean residen](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/shopping-naver-com-product-details-how-b84ddc15.png)

1. Open the actor in Apify Console and enter your **Search terms**, one per line.
2. Optionally pick **Result types** (organic, catalog, ad), enter **Product IDs to track** and set the result limits.
3. Click **Start** and download the dataset as JSON, CSV or Excel.

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

Price per event by Apify plan:

| Event | Free | Bronze | Silver | Gold and above |
|---|---|---|---|---|
| Product | $3.00 per 1,000 | $2.70 per 1,000 | $2.40 per 1,000 | $2.10 per 1,000 |
| Run start | $0.00005 | $0.00005 | $0.00005 | $0.00005 |

A test run with the API example input below returned 157 rows in 16 s.

The actor uses pay-per-event pricing. One paid event is one product card in the dataset ($0.003 on the Free plan) plus a small run start fee ($0.00005). Duplicate cards and search terms without results are free.

| Scenario | Products | Cost on the Free plan |
|---|---|---|
| One keyword, top 10 rank check | 10 | about $0.03 |
| One keyword, all cards | about 90 | about $0.27 |
| 10 keywords, all cards | about 900 | about $2.70 |
| Default total cap of 1,000 results | 1,000 | about $3.00 |

Higher Apify plans have lower per-product prices (see the table above).

### Input

![Naver Shopping Scraper input example: Search terms, Result types, Max results per search term, Max results in total](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/shopping-naver-com-product-details-input-562332b5.png)

| Field | Meaning |
|---|---|
| `queries` | Search terms (required), e.g. 노트북, 생수, Nike running shoes |
| `resultTypes` | `organic`, `catalog`, `ad`. All three by default |
| `productIds` | Keep only these products (nvMid, store product number or product link). Needs search terms that find them |
| `maxItemsPerQuery` | 1–100, default 100 |
| `maxItems` | Total cap across all terms, default 1000 |
| `proxyConfiguration` | Default: Apify Residential proxy, country KR |

```json
{
  "queries": ["노트북", "생수"],
  "resultTypes": ["organic", "catalog"],
  "maxItemsPerQuery": 20,
  "maxItems": 100
}
```

### What data can you extract from Naver Shopping?

![Naver Shopping Scraper output example: Image, Product, Price (KRW), Coupon price, Discount %, Rating](https://api.apify.com/v2/key-value-stores/Ll7RrWtDkZYOrBvfE/records/shopping-naver-com-product-details-output-aaedcd94.png)

| Field | Description |
|---|---|
| `title`, `url`, `id` | Product name, link, Naver product ID (nvMid) |
| `resultType`, `isAd`, `isCatalog` | organic / catalog / ad |
| `price`, `originalPrice`, `discountRate`, `couponPrice` | KRW prices and discount |
| `deliveryFee`, `arrivalAt`, `orderDeadline` | Delivery data |
| `rating`, `reviewsCount`, `purchaseCount`, `keepCount` | Social proof (keepCount = wishlist count) |
| `sellerCount` | Number of sellers for catalog products |
| `author`, `storeSlug`, `storeId`, `isBrandStore`, `isOverseas` | Store data |
| `categoryId`, `categoryIds`, `imageUrl` | Category ids and image |
| `unitPrice`, `unitCapacity`, `pointsEarned` | Unit price and points |
| `query`, `position`, `scrapedAt` | Search term, rank, time of scraping |

Example item (shortened):

```json
{
  "url": "https://smartstore.naver.com/main/products/13279525663",
  "id": "90824035995",
  "title": "[115만+Win11] LG그램북 16 16U55U-GS5CK AMD 라이젠 최신 AI 4세대 노트북",
  "resultType": "ad",
  "isAd": true,
  "price": 1621000,
  "originalPrice": 1950000,
  "discountRate": 16,
  "currency": "KRW",
  "deliveryFee": 0,
  "rating": 4.9,
  "reviewsCount": 143,
  "purchaseCount": 421,
  "keepCount": 1434,
  "author": "LG전자인증점 베스트CNF",
  "query": "노트북",
  "position": 1
}
```

### Use cases

- Monitor prices, discounts and coupon prices of products on Naver Shopping.
- Track the rank of your products or brand for a keyword (`position`, with `productIds`).
- Compare the number of sellers of catalog products.
- See which sponsored ads appear for a keyword (`isAd`).
- Collect Korean market data for research or dropshipping.

### Limitations

- About 60–90 cards per search term at most; Naver gives no paging.
- Sorting and price filters are not supported by the source; results come in Naver's order.
- Products cannot be looked up by ID or link; use the product name as the search term and the ID in `productIds`.
- Only fields on the search card are returned: no specification tables, seller lists, price history or review texts.
- Category names are not available, only ids. Some fields (`couponPrice`, `rating`, `unitPrice`) can be empty.
- Naver blocks datacenter IPs more often; the default Korean residential proxy is recommended.

### Tips and troubleshooting

- For more results, add more search terms; one term gives at most about 90 cards, so `maxItemsPerQuery` above 100 has no effect.
- For a top-10 rank check, set `maxItemsPerQuery` to 10 and compare `position` between runs.
- `productIds` only filters cards found by your search terms. If you get 0 rows, search with the product name.
- To see only ads or only price-comparison products, set `resultTypes` to `ad` or `catalog`.
- If runs are blocked or return fewer rows than expected, keep the default Apify Residential proxy with country KR; datacenter or no proxy makes the run log a warning and Naver blocks it more often.
- Set `maxItems` to cap the total number of results, and with it the cost, across all search terms.

### API, MCP and integrations

Run the actor from your code with the same JSON input as in Console. Your API token is in [Console → Settings → API & Integrations](https://console.apify.com/settings/integrations).

**Python** (`pip install apify-client`):

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("genial_candlestand/naver-shopping-product-search-scraper").call(run_input={"queries": ["노트북", "생수"], "maxItems": 200})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

**Node.js** (`npm install apify-client`):

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

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('genial_candlestand/naver-shopping-product-search-scraper').call({"queries": ["노트북", "생수"], "maxItems": 200});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

**HTTP** — one request runs the actor and returns the results (runs up to 5 minutes; longer ones: [run asynchronously](https://docs.apify.com/api/v2/act-runs-post)):

```bash
curl -X POST "https://api.apify.com/v2/acts/genial_candlestand~naver-shopping-product-search-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["노트북","생수"],"maxItems":200}'
```

**AI agents (MCP).** Add the actor as a tool of the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Claude Code:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=genial_candlestand/naver-shopping-product-search-scraper"
```

Claude Desktop, Cursor or VS Code: `{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=genial_candlestand/naver-shopping-product-search-scraper"}}}`. Then ask, for example:

- "Get the top 10 Naver Shopping results for 노트북 with price and rating"
- "List sponsored ads on Naver Shopping for the keyword 갤럭시 버즈"
- "Find catalog products for 나이키 운동화 on Naver Shopping with seller counts"

**Integrations.** Run it on a schedule with [Apify Schedules](https://docs.apify.com/platform/schedules) and send the results to Google Sheets, Slack, Zapier, Make, n8n or your webhook — see [Apify integrations](https://docs.apify.com/platform/integrations).

### FAQ

**Is it legal to scrape Naver Shopping?**<br>
The actor reads publicly visible product listings and returns no personal data beyond the store names the site shows. You are responsible for using the data in line with Naver's terms and the laws that apply to you.

**Do I need a Naver account or API key?**<br>
No.

**How is it different from other Naver Shopping scrapers?**<br>
It returns sponsored ads (flagged with isAd), coupon price, guaranteed arrival time and order deadline in one flat row. It has two billing events only, the product and the run start, at $0.003 per product on the Free plan. It does not return specification tables, seller lists or price history.

**Can I search in English?**<br>
Yes, but Korean keywords usually give more results.

### Also useful

- [Amazon Best Sellers Scraper](https://apify.com/genial_candlestand/amazon-best-sellers-scraper) — compare top-ranked products and prices on Amazon stores, including Japan
- [Google Trends Scraper](https://apify.com/genial_candlestand/google-trends-scraper) — check search interest for the products and keywords you track
- [Coles Product Scraper](https://apify.com/genial_candlestand/coles-product-scraper) — monitor retail prices, was-prices and specials at Coles Australia

# Actor input Schema

## `queries` (type: `array`):

Keywords to search on Naver Shopping, one per line, in Korean or English (e.g. 노트북, 생수). Each keyword returns up to about 90 product cards. Use search words, not URLs.

## `resultTypes` (type: `array`):

Which cards to keep: organic store listings, price-comparison catalog products (with the number of sellers), and sponsored ads. All three by default. Leaving the list empty keeps all three.

## `productIds` (type: `array`):

Keep only these products: Naver product IDs (nvMid), store product numbers or product links. Needs search terms that find them; the product name works best.

## `maxItemsPerQuery` (type: `integer`):

Keep at most this many cards per search term, in Naver's order (e.g. 10 for a top-10 rank check). Naver shows about 60–90 cards per keyword, so values above 100 have no effect.

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

Stop the run after this many results across all search terms.

## `proxyConfiguration` (type: `object`):

Apify Residential proxy in South Korea (KR) by default: the setting that passed every test. Datacenter proxy, or no proxy (on Apify that is the server's datacenter IP), uses less traffic but Naver blocks it more often; the run logs a warning for both.

## Actor input object example

```json
{
  "queries": [
    "노트북",
    "생수"
  ],
  "resultTypes": [
    "organic",
    "catalog",
    "ad"
  ],
  "maxItemsPerQuery": 100,
  "maxItems": 1000,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "KR"
  }
}
```

# Actor output Schema

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

Dataset with all product cards

## `overview` (type: `string`):

Table view of the main product fields

# 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 = {
    "queries": [
        "노트북",
        "생수"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "KR"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("genial_candlestand/naver-shopping-product-search-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 = {
    "queries": [
        "노트북",
        "생수",
    ],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "KR",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("genial_candlestand/naver-shopping-product-search-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 '{
  "queries": [
    "노트북",
    "생수"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "KR"
  }
}' |
apify call genial_candlestand/naver-shopping-product-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,genial_candlestand/naver-shopping-product-search-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/MPkIV78p37vWPu8e4/builds/vfoMQ5nL3lp4UvyuB/openapi.json
