# SSG.com Scraper: Shinsegae & Emart Korea Prices (`getascraper/ssg-products-scraper`) Actor Scrape product listings from SSG.com, Korea's Shinsegae, Emart, and Traders malls. Get titles, brands, prices in KRW, original prices, discount percent, review scores, and image links. Filter by keyword, brand, price range, mall, and sort order, then export to Excel, Google Sheets, CSV, or JSON. - **URL**: https://apify.com/getascraper/ssg-products-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (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 $0.67 / 1,000 product records 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 ## SSG.com Products Scraper Get live SSG.com product listings, prices in Korean Won, discounts, ratings, and product links, ready for your spreadsheet in under 60 seconds. SSG.com is the online mall group for Shinsegae, one of Korea's largest retail groups. It covers the Shinsegae department store, Emart, and the Traders warehouse mall. This scraper pulls product listings from SSG.com and hands you clean, flat rows. Search by keyword or paste SSG.com URLs, then export to Excel, Google Sheets, or your own price database. ### What this scraper does Point it at a search keyword or a list of SSG.com pages. It returns every product listing it finds, fully structured. Each row carries the product title, the price in Korean Won, the original price and discount on sale items, the brand, the rating, the review count, the stock status, the delivery fee, and direct links to the product and its image. You also get useful flags. You can see which listings are sponsored ads, which items are sold out, and which are free giveaways. Filter by price range, brand, or mall, sort by price or rating, drop sponsored listings, and limit how many products come back. It runs fast and reliably without needing any login. SSG.com serves shoppers inside Korea, so Korean proxies are recommended for clean results. ### Who uses this * **I am a cross-border ecommerce seller** sourcing Korean beauty and home goods, and I pull SSG.com prices in Korean Won every morning to spot items I can resell at a margin in my own store. * **I am a Korean-market researcher** tracking how prices and discounts move across Emart, Shinsegae, and Traders, so I can hand my clients a weekly view of the local market without reading Korean by hand. * **I am a price-monitoring analyst** watching a basket of competitor products on SSG.com, and I alert my team the moment a discount drops a price below our floor. * **I am a dropshipper** building a catalog of Korea-sourced products, filtering by brand and price so every item I list fits my niche and stays in stock. ### Output data Every product becomes one flat row. Below is a sample of what you get back. ```json [ { "product_id": "1000567890123", "title": "MSI Katana 15 Gaming Laptop Core i7 RTX 4060 16GB 512GB", "brand": "MSI", "price_krw": 1499000, "original_price_krw": 1799000, "discount_percent": 17, "currency": "KRW", "rating": 4.8, "review_count": 326, "is_sold_out": false, "stock_status": "In Stock", "delivery_fee": "Free shipping", "is_sponsored": false, "is_freebie": false, "image_url": "https://sui.ssgcdn.com/ui/ssg/item/1000567890123_i1.jpg", "product_url": "https://www.ssg.com/item/itemView.ssg?itemId=1000567890123", "scraped_at": "2026-06-25T09:14:03.000Z" }, { "product_id": "1000334411902", "title": "Innisfree Green Tea Seed Hyaluronic Serum 80ml Hydrating Set", "brand": "Innisfree", "price_krw": 24500, "currency": "KRW", "rating": 4.6, "review_count": 1842, "is_sold_out": false, "stock_status": "In Stock", "delivery_fee": "2,500 KRW", "is_sponsored": true, "is_freebie": false, "image_url": "https://sui.ssgcdn.com/ui/ssg/item/1000334411902_i1.jpg", "product_url": "https://www.ssg.com/item/itemView.ssg?itemId=1000334411902", "scraped_at": "2026-06-25T09:14:03.000Z" } ] ```` #### Data fields | Field | Type | Description | | --- | --- | --- | | `product_id` | string | The unique SSG.com product code. | | `title` | string | The full untruncated product title. | | `brand` | string | The brand name of the product, when available. | | `price_krw` | number | The current selling price in Korean Won. | | `original_price_krw` | number | The list price in Korean Won before the discount, present only on discounted items. | | `discount_percent` | number | The discount applied as a percentage, present only on discounted items. | | `currency` | string | The currency code for the price, always KRW. | | `rating` | number | The average customer rating for the product, when available. | | `review_count` | number | The number of customer reviews on the listing, when available. | | `is_sold_out` | boolean | True when the product is sold out. | | `stock_status` | string | The stock state of the product, for example In Stock. | | `delivery_fee` | string | The delivery cost shown on the listing, for example Free shipping. | | `is_sponsored` | boolean | True when the listing is a paid sponsored ad placement. | | `is_freebie` | boolean | True when the listing is a free giveaway item. | | `image_url` | string | A direct link to the main product image. | | `product_url` | string | A direct link to the product page on SSG.com. | | `scraped_at` | string | The time the record was collected, as an ISO timestamp. | ### Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `query` | string | No | The keyword to search for on SSG.com, for example laptop, beauty, or kitchen. | | `startUrls` | array of URLs | No | Paste SSG.com search or category pages to scrape directly instead of using a keyword. | | `sort` | enum | No | The order products come back in: Best match, Most reviewed, Price low to high, Price high to low, Newest, Discount, or Rating. | | `minPrice` | integer | No | Only return products at or above this price in Korean Won. | | `maxPrice` | integer | No | Only return products at or below this price in Korean Won. | | `brand` | string | No | Return only products from this brand name. | | `mall` | enum | No | Which mall to search: All, Emart, Shinsegae, or Traders. | | `excludeAds` | boolean | No | Drop sponsored listings from the results. Defaults to off. | | `maxItems` | integer | No | The most products to return in one run. | | `proxyConfiguration` | object | No | Connection settings. Korean proxies are recommended because SSG.com serves shoppers inside Korea. | ### Pricing Pricing is pay per result. You are billed per product record saved to your dataset, where one record is a single product with its prices, flags, and image link. Empty runs cost nothing. - You only pay for products successfully saved to your dataset. - Failed or empty runs cost absolutely nothing. - No fixed monthly subscriptions and no hidden maintenance fees. ### Frequently asked questions ##### Does the SSG.com scraper get blocked? No. The scraper reads SSG.com listings reliably and needs no login. SSG.com serves shoppers inside Korea, so we recommend routing your run through Korean proxies for clean, complete results. ##### Are prices returned in Korean Won? Yes. Every record carries the selling price in Korean Won. On discounted items you also get the original price and the discount percentage, so you can spot real deals without manual math. ##### Can I scrape products from only one mall like Emart or Traders? Yes. Set the mall field to Emart, Shinsegae, or Traders and the scraper returns listings from just that mall. Leave it on All to pull results across the whole SSG.com group. ##### How do I scrape a specific SSG.com category or search page? Paste the page links into the start URLs field. The scraper reads them directly instead of running a keyword search. You can mix search and category pages in one run. # Actor input Schema ## `query` (type: `string`): Keyword to search on SSG.com in Korean or English. ## `startUrls` (type: `array`): Direct search, category, or filter result URLs (optional). ## `sort` (type: `string`): Sorting criteria for search results. ## `minPrice` (type: `integer`): Filter results to only include products with a price greater than or equal to this value in Korean Won. ## `maxPrice` (type: `integer`): Filter results to only include products with a price less than or equal to this value in Korean Won. ## `brand` (type: `string`): SSG brand ID to restrict search results to a specific vendor. ## `mall` (type: `string`): Filter results to products offered by a specific Shinsegae mall vendor. ## `excludeAds` (type: `boolean`): When enabled, drops sponsored or advertised product placements from the results so you only keep organic listings. ## `maxItems` (type: `integer`): Maximum total product records to extract. ## `proxyConfiguration` (type: `object`): Rotating proxies settings to bypass anti-scraping and geo-blocking restrictions. South Korean residential proxies are highly recommended. ## Actor input object example ```json { "query": "노트북", "startUrls": [], "sort": "best", "brand": "", "mall": "all", "excludeAds": false, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "KR" } } ``` # Actor output Schema ## `results` (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 = { "query": "노트북", "startUrls": [], "sort": "best", "brand": "", "mall": "all", "excludeAds": false, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "KR" } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/ssg-products-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 = { "query": "노트북", "startUrls": [], "sort": "best", "brand": "", "mall": "all", "excludeAds": False, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "KR", }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/ssg-products-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 '{ "query": "노트북", "startUrls": [], "sort": "best", "brand": "", "mall": "all", "excludeAds": false, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "KR" } }' | apify call getascraper/ssg-products-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/ssg-products-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SSG.com Scraper: Shinsegae & Emart Korea Prices", "description": "Scrape product listings from SSG.com, Korea's Shinsegae, Emart, and Traders malls. Get titles, brands, prices in KRW, original prices, discount percent, review scores, and image links. Filter by keyword, brand, price range, mall, and sort order, then export to Excel, Google Sheets, CSV, or JSON.", "version": "0.1", "x-build-id": "CiV15xKM6zTXtYVN3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~ssg-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-ssg-products-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/getascraper~ssg-products-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-ssg-products-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/getascraper~ssg-products-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-ssg-products-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", "required": [ "query", "proxyConfiguration" ], "properties": { "query": { "title": "Search query", "type": "string", "description": "Keyword to search on SSG.com in Korean or English.", "default": "노트북" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct search, category, or filter result URLs (optional).", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sort": { "title": "Sort order", "enum": [ "best", "cnt", "prcAsc", "prcDesc", "regDt", "asct", "high" ], "type": "string", "description": "Sorting criteria for search results.", "default": "best" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Filter results to only include products with a price greater than or equal to this value in Korean Won." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Filter results to only include products with a price less than or equal to this value in Korean Won." }, "brand": { "title": "Brand identifier", "type": "string", "description": "SSG brand ID to restrict search results to a specific vendor.", "default": "" }, "mall": { "title": "Mall restriction", "enum": [ "all", "emart", "shinsegae", "traders" ], "type": "string", "description": "Filter results to products offered by a specific Shinsegae mall vendor.", "default": "all" }, "excludeAds": { "title": "Exclude sponsored ads", "type": "boolean", "description": "When enabled, drops sponsored or advertised product placements from the results so you only keep organic listings.", "default": false }, "maxItems": { "title": "Maximum products limit", "minimum": 1, "type": "integer", "description": "Maximum total product records to extract.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Rotating proxies settings to bypass anti-scraping and geo-blocking restrictions. South Korean residential proxies are highly recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "KR" } } } }, "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 } } } } } } } } } } ```