# Naver Shopping Best Scraper β€” Korea Best-Seller Rankings (`kdatafactory/naver-shopping-best-scraper`) Actor Scrape Naver Shopping BEST, Korea's daily best-seller rankings: many-bought (~100) and many-viewed (~95) products, plus trending keywords, with rank, title, mall, KRW price, review count and image as clean JSON. Category filters, daily refresh, no PII. Powers Korean e-commerce trend dashboards. - **URL**: https://apify.com/kdatafactory/naver-shopping-best-scraper.md - **Developed by:** [Seok June Park](https://apify.com/kdatafactory) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Naver Shopping Best Scraper β€” Korea Best-Seller Rankings πŸ›οΈ Scrape **Naver Shopping BEST** β€” Korea's **daily best-seller rankings** β€” as clean, structured JSON. Get the **many-bought** list (the true best-sellers, ~100 products), the **many-viewed** list (~95 most-clicked products), and the **trending search keywords** (20, with UP / DOWN / SOAR status). Every product record carries rank, title, seller (mall), KRW price, review count and image. Built for **daily Korean e-commerce trend dashboards**: Naver Shopping is the front door to online shopping in Korea, and its BEST board is the single best pulse of what the country is actually buying today. Run it on a schedule and you have a live best-seller feed you can chart, diff day-over-day, and pipe into your own tools. > **Try it free.** Apify's free plan includes $5 of monthly platform credit β€” at **$2.00 / 1,000 results** that's roughly **2,500 records** from this actor, no credit card required. Set your input, click Start, and export JSON/CSV/Excel. --- ### What it does This actor reads ranking data straight from Naver Shopping's dedicated BEST host (`snxbest.naver.com`) β€” the same feed the BEST pages render β€” so results are fast and complete, with no headless browser. You can scrape: - **Many-bought best-sellers** (`mode: buy`) β€” the ~100 products Koreans are buying the most right now, ranked 1–100. - **Many-viewed products** (`mode: click`) β€” the ~95 most-clicked products, a leading indicator of what's about to sell. - **Trending keywords** (`mode: keyword`) β€” the 20 fastest-rising Naver Shopping searches, each tagged UP, DOWN, SOAR or NEW with its rank change. Product modes can be scoped to a **category** (all, fashion-clothing, fashion-accessory, cosmetics/beauty, digital/appliance, furniture/interior, baby, food). The ranking is Naver's **daily** best-seller board β€” schedule a run each morning for a fresh snapshot. > **Why Naver Shopping BEST?** Naver is Korea's dominant portal and shopping gateway, and the BEST board aggregates real purchase and click volume across thousands of Smartstore sellers into one national best-seller ranking. For an e-commerce trend dashboard it's the highest-signal, lowest-noise source of "what's hot in Korea today." --- ### Input | Field | Type | Description | |-------|------|-------------| | `mode` | string | `buy` (many-bought best-sellers, ~100), `click` (many-viewed, ~95), or `keyword` (trending keywords, 20). Default `buy`. | | `categoryId` | string | Category to rank within, for product modes: `A` (all), `50000000` fashion-clothing, `50000001` fashion-accessory, `50000002` cosmetics/beauty, `50000003` digital/appliance, `50000004` furniture/interior, `50000005` baby, `50000006` food. Ignored for `keyword` (always global). Default `A`. | | `maxItems` | integer | Max ranking records to collect. Default `100`, max `100` (a single BEST list). | | `proxyConfiguration` | object | Proxy settings (see below). Defaults to a direct connection. | #### Input example ```json { "mode": "buy", "categoryId": "50000002", "maxItems": 100 } ```` ```json { "mode": "keyword" } ``` *** ### Output Each ranking record is one dataset item. For **product modes** (`buy` / `click`), `price_krw` is the listed price in Korean won, `mall` is the Smartstore seller name, and `url` points to the product on `smartstore.naver.com`. For **keyword mode**, the keyword text is in `title`, `keyword_status` holds `UP` / `DOWN` / `SOAR` / `NEW`, `rank_change` is the day-over-day movement, and `url` is a Naver Shopping search link for the keyword. ```json { "source": "naver_shopping", "mode": "buy", "rank": 1, "product_id": "5656333779", "title": "일본 이심 eSIM 도쿄 ν›„μΏ μ˜€μΉ΄ μ†Œν”„νŠΈλ±…ν¬ 맀일 500MB λ¬΄μ œν•œ 1일 μœ μ‹¬μ‚¬ μ•Œλ¦Όν†‘", "mall": "μœ μ‹¬μ‚¬μŠ€ν† μ–΄", "price_krw": 300, "review_count": 99456, "category_id": "A", "url": "https://smartstore.naver.com/main/products/5656333779", "image_url": "https://shopping-phinf.pstatic.net/main_8320083/83200831085.7.jpg?type=f450", "is_ad": false, "keyword_status": null, "rank_change": null, "scraped_at": "2026-07-15T09:56:16+09:00" } ``` A trending-keyword record: ```json { "source": "naver_shopping", "mode": "keyword", "rank": 1, "title": "자라", "category_id": "50000167", "url": "https://search.shopping.naver.com/search/all?query=%EC%9E%90%EB%9D%BC", "keyword_status": "UP", "rank_change": 1, "scraped_at": "2026-07-15T09:55:44+09:00" } ``` A full 40-item sample from a real run is in [`samples/sample-output.json`](samples/sample-output.json). | Field | Meaning | |-------|---------| | `source` | Always `"naver_shopping"`. | | `mode` | `buy`, `click`, or `keyword` β€” which BEST ranking this record came from. | | `rank` | Position in the BEST list (1 = top). | | `product_id` | Naver `chnlProductId` (product modes), else `null`. | | `title` | Product name (product modes) or the trending keyword (keyword mode). | | `mall` | Smartstore seller name (product modes), else `null`. | | `price_krw` | Listed price in KRW (product modes), else `null`. | | `review_count` | Number of product reviews (product modes), else `null`. | | `category_id` | Category the ranking was scoped to (product modes) / the keyword's own category (keyword mode). | | `url` | Smartstore product URL (product modes) or a Naver Shopping search link for the keyword. | | `image_url` | Product image URL (product modes), else `null`. | | `is_ad` | `true` if Naver flagged the entry as an ad (product modes), else `null`. | | `keyword_status` | Trend status `UP` / `DOWN` / `SOAR` / `NEW` (keyword mode), else `null`. | | `rank_change` | Day-over-day rank movement (keyword mode), else `null`. | | `scraped_at` | ISO-8601 timestamp (KST, UTC+9). | The core fields β€” `rank`, `title`, and (for product modes) `price_krw` β€” are populated on **every** record in the live test (40/40 in the lite run; 100/100 on a full `buy` pull), along with `product_id`, `mall`, `review_count`, `url` and `image_url`. *** ### Use cases - **Daily e-commerce trend dashboards** β€” pull the best-seller board each morning, diff it against yesterday, and surface risers, fallers and new entrants. Combine `buy` (bought) with `click` (viewed) to see demand vs. attention. - **Product & pricing research** β€” track which products and price points dominate a category (cosmetics, digital, food…) over time. - **Trend & demand signals** β€” the `keyword` mode's SOAR/NEW tags are an early-warning feed for spiking consumer interest across Korea. - **AI agents & datasets** β€” feed structured best-seller data into forecasting models, merchandising tools, or LLM agents. *** ### ❓ FAQ **Is it legal to scrape this data?** This actor collects only public, non-personal ranking data β€” the same best-seller lists any visitor sees on Naver Shopping BEST without logging in. No personal data is collected. You are responsible for how you use the data; see the legality note below. **What does it cost in practice?** $2.00 per 1,000 results (launch pricing) + a few cents of platform usage. A daily 100-record best-seller pull costs about **$0.20/day**; adding the click and keyword lists is a few cents more. Apify's free $5 monthly credit covers **~2,500 records** (5 Γ· 2 Γ— 1,000). **Do I need to configure proxies?** No β€” the default settings work out of the box. The `snxbest.naver.com` BEST host serves its ranking feed without a bot wall, so the actor runs fine on a **direct connection**. For very heavy scheduling you can optionally enable Apify Proxy β€” see the proxy note below. **How fresh is the data?** The BEST board is Naver's **daily** ranking, and every run scrapes it live. Schedule the actor once a day for a clean day-over-day time series. **What is NOT included?** Per-product detail-page data (options, full description, per-review text) and anything behind login. Product modes return the BEST-list fields only. `keyword` mode returns keywords and their rank status, not products. *** ### πŸ€– Use with AI agents (MCP) Call this Actor as a tool from Claude or any MCP-compatible AI agent β€” no glue code. Point your MCP client at Apify's server, scoped to this Actor: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=kdatafactory/naver-shopping-best-scraper", "headers": { "Authorization": "Bearer " } } } } ``` Your agent can then pull Korea's daily best-seller rankings and trending keywords on demand β€” no scraping code in your app. Grab a free token from [Apify β†’ Integrations](https://console.apify.com/settings/integrations). ### πŸ‡°πŸ‡· More Korean data actors This actor is part of a suite of Korean-platform scrapers by the same maintainer: - **[danawa-scraper](https://apify.com/kdatafactory/danawa-scraper) β€” price-comparison rankings from Danawa, Korea's top shopping price-comparison site.** Pair it with this actor to cross-check best-seller demand against price data. - [oliveyoung-scraper](https://apify.com/kdatafactory/oliveyoung-scraper) β€” beauty best-sellers and product data from Olive Young, Korea's #1 health & beauty retailer. - [musinsa-scraper](https://apify.com/kdatafactory/musinsa-scraper) β€” fashion rankings and product listings from Musinsa, Korea's largest fashion platform. - [kurly-scraper](https://apify.com/kdatafactory/kurly-scraper) β€” grocery & lifestyle product data from Market Kurly. Browse all: [apify.com/kdatafactory](https://apify.com/kdatafactory) *** ### Rate limiting & legality - The actor collects **only public, non-authenticated data**. It never logs in and never touches private endpoints. - **No personal data** is collected β€” only best-seller rankings (product title, seller name, price, review count, image) or trending keywords. - Requests are rate-limited: a single BEST list per run with a β‰₯ 500 ms delay before any fallback request, to stay gentle on Naver's servers. - You are responsible for using the data in line with Naver Shopping's terms of service and applicable law. #### Known limitations (honesty note) - **One BEST list per run.** Each run returns a single ranking (up to ~100 products or 20 keywords) for the chosen `mode` and `categoryId`. To collect several categories or modes, schedule multiple runs. - **`keyword` mode has no product fields.** Trending-keyword records carry the keyword, its rank and status only β€” `price_krw`, `mall`, `product_id` and `image_url` are `null` by design. For `NEW` keywords, `rank_change` is `null` (no previous position). - **Titles / mall names are Korean strings** β€” as Naver labels them; they are not translated. - **`is_ad`** reflects Naver's own ad flag on each entry and is passed through so you can filter or exclude sponsored items; the ranking `rank` value is always Naver's. *** *If this actor saves you time, a rating on the [Store page](https://apify.com/kdatafactory/naver-shopping-best-scraper) helps a solo maintainer a lot. Found an issue? Open it in the Issues tab β€” I respond fast.* # Actor input Schema ## `mode` (type: `string`): Which BEST ranking to scrape. 'buy' = many-bought products (the true best-seller list, ~100 items). 'click' = many-viewed products (~95 items). 'keyword' = trending search keywords (20, with UP/DOWN/SOAR status). ## `categoryId` (type: `string`): Naver Shopping category to rank within (applies to 'buy' and 'click' product modes; ignored for 'keyword', which is always global). 'A' = all categories. ## `maxItems` (type: `integer`): Maximum number of ranking records to collect. A single BEST list holds up to ~100 products (or 20 trending keywords), so values above that just return the whole list. ## `proxyConfiguration` (type: `object`): Proxy settings. Naver Shopping BEST serves its ranking feed without a bot wall on the snxbest.naver.com host, so the actor runs fine on a direct connection (default). If you ever see blocks at high volume, enable Apify Proxy here. ## Actor input object example ```json { "mode": "buy", "categoryId": "A", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("kdatafactory/naver-shopping-best-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("kdatafactory/naver-shopping-best-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call kdatafactory/naver-shopping-best-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kdatafactory/naver-shopping-best-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Naver Shopping Best Scraper β€” Korea Best-Seller Rankings", "description": "Scrape Naver Shopping BEST, Korea's daily best-seller rankings: many-bought (~100) and many-viewed (~95) products, plus trending keywords, with rank, title, mall, KRW price, review count and image as clean JSON. Category filters, daily refresh, no PII. Powers Korean e-commerce trend dashboards.", "version": "0.1", "x-build-id": "GYSiGvtOsM7TC6bjb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kdatafactory~naver-shopping-best-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kdatafactory-naver-shopping-best-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/kdatafactory~naver-shopping-best-scraper/runs": { "post": { "operationId": "runs-sync-kdatafactory-naver-shopping-best-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/kdatafactory~naver-shopping-best-scraper/run-sync": { "post": { "operationId": "run-sync-kdatafactory-naver-shopping-best-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Ranking mode", "enum": [ "buy", "click", "keyword" ], "type": "string", "description": "Which BEST ranking to scrape. 'buy' = many-bought products (the true best-seller list, ~100 items). 'click' = many-viewed products (~95 items). 'keyword' = trending search keywords (20, with UP/DOWN/SOAR status).", "default": "buy" }, "categoryId": { "title": "Category", "enum": [ "A", "50000000", "50000001", "50000002", "50000003", "50000004", "50000005", "50000006" ], "type": "string", "description": "Naver Shopping category to rank within (applies to 'buy' and 'click' product modes; ignored for 'keyword', which is always global). 'A' = all categories.", "default": "A" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of ranking records to collect. A single BEST list holds up to ~100 products (or 20 trending keywords), so values above that just return the whole list.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Naver Shopping BEST serves its ranking feed without a bot wall on the snxbest.naver.com host, so the actor runs fine on a direct connection (default). If you ever see blocks at high volume, enable Apify Proxy here.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```