# Naver Shopping Scraper – Products, Prices & Reviews (`abotapi/naver-brand-store-scraper`) Actor Scrape Naver Shopping products by Korean or English keyword, or by URL. Returns 190+ fields per product, including prices, discounts, seller, ratings, reviews, category path, brand, shipping, and cross-mall price comparison. - **URL**: https://apify.com/abotapi/naver-brand-store-scraper.md - **Developed by:** [AbotAPI](https://apify.com/abotapi) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 product results 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/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 Brand Store Scraper Scrape the full product catalog of any Naver Brand Store (brand.naver.com). Give it one or more store slugs or URLs and get clean, structured product data: price, discount, stock, rating, reviews, brand, maker, seller, full category path, delivery, and images, with the complete raw object kept on every record. Optional per-product review detail. ### Why this scraper? - **36+ structured fields per product**, plus the full raw object so nothing is dropped. - **Whole-catalog coverage.** Paginates each store and pulls every listed product. - **Real discount prices**, not just the list price (the actual member/immediate discounted price). - **Rich detail:** rating and review counts, stock, brand and maker, seller, full category path, delivery type, arrival guarantee, today-delivery flags. - **Multiple stores per run**, with sort by popular, newest, price, reviews, or best-selling. - **Optional app export:** pipe results into Notion, Linear, Airtable, or Apify via MCP connectors. ### Data you get > Sample shape: values are illustrative placeholders, not from a live listing. | Field | Example | |---|---| | productName | Sample Product Title | | productNo | 00000000000 | | salePrice | 23800 | | discountedPrice | 21420 | | stockQuantity | 1900 | | averageRating | 4.9 | | totalReviews | 1144 | | brand | Sample Brand | | maker | Sample Maker | | sellerName | Sample Official Store | | sellerId | samplestore | | categoryName | Chocolate | | categoryPath | ["Food", "Candy", "Chocolate"] | | freeDelivery | true | | arrivalGuarantee | true | | productUrl | https://brand.naver.com/samplestore/products/00000000000 | | imageUrl | https://shop-phinf.pstatic.net/00000000/000000000.jpg | | crawledAt | 2026-01-01T00:00:00.000Z | Each product also carries a `raw` object with the complete upstream item, and (when `fetchReviews` is on) a `reviewDetail` object. ### How to use **One store:** ```json { "brandStores": ["marschoco"], "maxItems": 100 } ```` **Several stores, cheapest first:** ```json { "brandStores": ["marschoco", "nike"], "sort": "price_asc", "maxItems": 200 } ``` **Store URL form, with review detail:** ```json { "brandStores": ["https://brand.naver.com/marschoco"], "fetchReviews": true, "maxItems": 50 } ``` ### Input parameters Two ways to choose stores: **Search mode** (default) takes brand store names (slugs), **URL mode** takes full brand.naver.com store links. Either way, each store's catalog is scraped. | Parameter | Type | Default | Description | |---|---|---|---| | mode | string | search | `search` = brand store names; `url` = brand store links | | brandStores | array | \["marschoco"] | Brand store slugs or brand.naver.com URLs (Search mode) | | startUrls | array | (none) | Full brand.naver.com store URLs (URL mode) | | sort | string | popular | popular, recent, price\_asc, price\_desc, review, sales | | fetchReviews | boolean | false | Also fetch per-product review detail | | maxItems | integer | 20 | The single result cap (split across stores); 0 = unlimited | | proxy | object | RESIDENTIAL, KR | Connection configuration (see below) | | mcpConnectors | array | (none) | Optional MCP connectors to export into | | notionParentPageUrl | string | (none) | Parent page for the Notion export | | maxNotifyListings | integer | 50 | Cap on items exported per connector | ### Output example > Sample shape: values are illustrative placeholders, not from a live listing. ```json { "productNo": "00000000000", "channelProductId": "00000000000", "productName": "Sample Product Title", "productUrl": "https://brand.naver.com/samplestore/products/00000000000", "imageUrl": "https://shop-phinf.pstatic.net/00000000/000000000.jpg", "salePrice": 23800, "discountedPrice": 21420, "stockQuantity": 1900, "averageRating": 4.9, "totalReviews": 1144, "brand": "Sample Brand", "maker": "Sample Maker", "sellerName": "Sample Official Store", "sellerId": "samplestore", "categoryName": "Chocolate", "categoryPath": ["Food", "Candy", "Chocolate"], "freeDelivery": true, "arrivalGuarantee": true, "brandSlug": "samplestore", "crawledAt": "2026-01-01T00:00:00.000Z", "raw": { "...": "complete upstream item" } } ``` ### Send results into your apps (MCP connectors) Optionally pipe results into the tools you already use. Authorize a connector under Apify, Settings, Integrations, then select it in the `mcpConnectors` input. For Notion, also set `notionParentPageUrl` and a page is created per product. The connector receives a condensed summary per product; the complete record always stays in the Apify dataset. Leaving `mcpConnectors` empty skips this entirely. ### Plan requirement Naver brand stores only accept Korea residential connections, so the default proxy is RESIDENTIAL with country KR, which requires an Apify Starter plan or higher. Datacenter connections and non-Korea exits are rejected by the source. If you run on a plan without residential proxy, the run finishes with a single record explaining the requirement. # Actor input Schema ## `mode` (type: `string`): How you provide the stores. "Search" = enter brand store names (slugs). "URL" = paste full brand.naver.com store links. ## `brandStores` (type: `array`): Naver brand store names (slugs), e.g. "marschoco". A full brand.naver.com URL works here too. Multiple supported. ## `startUrls` (type: `array`): Full Naver brand store URLs, e.g. "https://brand.naver.com/marschoco". Each store's catalog is scraped. Multiple supported. ## `sort` (type: `string`): Catalog ordering. ## `fetchReviews` (type: `boolean`): Also fetch per-product review detail (extra requests per product). ## `maxItems` (type: `integer`): The single result cap (split across stores). Set 0 for unlimited. ## `proxy` (type: `object`): Proxy configuration. RESIDENTIAL + country KR is required for results. ## `mcpConnectors` (type: `array`): Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify → Settings → Integrations, then select it here. Notion gets a page-per-product; other connectors get a best-effort write. Leave empty to skip; never changes the dataset. ## `notionParentPageUrl` (type: `string`): URL or id of the Notion page under which product pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "brandStores": [ "marschoco" ], "startUrls": [ "https://brand.naver.com/marschoco" ], "sort": "popular", "fetchReviews": false, "maxItems": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "KR" }, "maxNotifyListings": 50 } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "brandStores": [ "marschoco" ], "startUrls": [ "https://brand.naver.com/marschoco" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "KR" } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/naver-brand-store-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 = { "brandStores": ["marschoco"], "startUrls": ["https://brand.naver.com/marschoco"], "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "KR", }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/naver-brand-store-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 '{ "brandStores": [ "marschoco" ], "startUrls": [ "https://brand.naver.com/marschoco" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "KR" } }' | apify call abotapi/naver-brand-store-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/naver-brand-store-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Naver Shopping Scraper – Products, Prices & Reviews", "description": "Scrape Naver Shopping products by Korean or English keyword, or by URL. Returns 190+ fields per product, including prices, discounts, seller, ratings, reviews, category path, brand, shipping, and cross-mall price comparison.", "version": "3.0", "x-build-id": "AdjwyCmTZTCrZamDr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~naver-brand-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-naver-brand-store-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/abotapi~naver-brand-store-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-naver-brand-store-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/abotapi~naver-brand-store-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-naver-brand-store-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": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "How you provide the stores. \"Search\" = enter brand store names (slugs). \"URL\" = paste full brand.naver.com store links.", "default": "search" }, "brandStores": { "title": "Brand stores", "type": "array", "description": "Naver brand store names (slugs), e.g. \"marschoco\". A full brand.naver.com URL works here too. Multiple supported.", "items": { "type": "string" } }, "startUrls": { "title": "Brand store URLs", "type": "array", "description": "Full Naver brand store URLs, e.g. \"https://brand.naver.com/marschoco\". Each store's catalog is scraped. Multiple supported.", "items": { "type": "string" } }, "sort": { "title": "Sort by", "enum": [ "popular", "recent", "price_asc", "price_desc", "review", "sales" ], "type": "string", "description": "Catalog ordering.", "default": "popular" }, "fetchReviews": { "title": "Fetch review detail", "type": "boolean", "description": "Also fetch per-product review detail (extra requests per product).", "default": false }, "maxItems": { "title": "Max products", "minimum": 0, "type": "integer", "description": "The single result cap (split across stores). Set 0 for unlimited.", "default": 20 }, "proxy": { "title": "Proxy", "type": "object", "description": "Proxy configuration. RESIDENTIAL + country KR is required for results." }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify → Settings → Integrations, then select it here. Notion gets a page-per-product; other connectors get a best-effort write. Leave empty to skip; never changes the dataset." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which product pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } } ```