# Gmarket Korea Scraper: Products in KRW & USD (`getascraper/gmarket-scraper`) Actor Scrape product listings from Gmarket South Korea. Get titles, prices in KRW and USD, original and coupon prices, free shipping and international delivery flags, seller IDs, and image links. Filter by price, sort order, and BigSmile deals. Export to Excel, Sheets, CSV, or JSON. - **URL**: https://apify.com/getascraper/gmarket-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.74 / 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 ## Gmarket Korea Scraper Get live Gmarket South Korea listings, prices in KRW and USD, shipping flags, and product links, ready for your spreadsheet in under 60 seconds. Gmarket is one of South Korea's largest online marketplaces. This scraper pulls product listings from the mobile global storefront and hands you clean, flat rows. Search by keyword or paste Gmarket 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 Gmarket pages. It returns every product listing it finds, fully structured. Each row carries the product title, the price in Korean Won, a pre-calculated price in US Dollars, the original list price, the coupon price, seller details, category codes, and direct links to the product and its images. You also get useful flags. You can see which items ship internationally outside Korea and which items belong to Gmarket's BigSmile promotion. Filter by price range, sort by best selling or lowest price, and limit how many products come back. It runs fast and reliably without needing any login. Datacenter connections work well here, so your runs stay cheap and quick. ### Who uses this * **I am a cross-border ecommerce seller** sourcing Korean beauty and fashion products, and I pull Gmarket prices in USD 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 coupons move across electronics and home goods, 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 Gmarket, and I alert my team the moment a BigSmile promotion drops a price below our floor. * **I am a dropshipper** building a catalog of Korea-sourced products that ship internationally, filtering for overseas delivery only so every item I list can actually reach my buyers. ### Output data Every product becomes one flat row. Below is a sample of what you get back. ```json [ { "product_id": "3784512906", "title": "Samsung Galaxy Buds3 Pro Wireless Bluetooth Earbuds Silver", "price_krw": 189000, "original_price_krw": "279,000", "coupon_price_krw": 175000, "price_usd": 137.21, "is_free_shipping": true, "is_sponsored": false, "is_oversea_delivery": true, "is_big_smile": true, "is_adult": false, "seller_id": "samsungstore", "shop_handle": "samsung_official", "category_code_l": "100000020", "category_code_m": "200001512", "category_code_s": "300012044", "images_count": 5, "images": "https://gdimg.gmarket.co.kr/3784512906/still/600?1, https://gdimg.gmarket.co.kr/3784512906/still/600?2", "image_url": "https://gdimg.gmarket.co.kr/3784512906/still/280", "product_url": "https://item.gmarket.co.kr/Item?goodscode=3784512906", "scraped_at": "2026-06-25T09:14:03.000Z" }, { "product_id": "2910477melissa", "title": "Innisfree Green Tea Seed Hyaluronic Serum 80ml Hydrating Set", "price_krw": 24500, "original_price_krw": "32,000", "coupon_price_krw": 22050, "price_usd": 17.79, "is_free_shipping": false, "is_sponsored": true, "is_oversea_delivery": false, "is_big_smile": false, "is_adult": false, "seller_id": "innisfreeshop", "shop_handle": "innisfree_kr", "category_code_l": "100000035", "category_code_m": "200002841", "category_code_s": "300019677", "images_count": 3, "images": "https://gdimg.gmarket.co.kr/2910477/still/600?1, https://gdimg.gmarket.co.kr/2910477/still/600?2", "image_url": "https://gdimg.gmarket.co.kr/2910477/still/280", "product_url": "https://item.gmarket.co.kr/Item?goodscode=2910477", "scraped_at": "2026-06-25T09:14:03.000Z" } ] ```` #### Data fields | Field | Type | Description | | --- | --- | --- | | `product_id` | string | The unique Gmarket product code. | | `title` | string | The full untruncated product title. | | `price_krw` | number | The current selling price in Korean Won. | | `original_price_krw` | string | The original list price in Korean Won before any discount. | | `coupon_price_krw` | number | The price in Korean Won after an available coupon is applied. | | `price_usd` | number | The selling price pre-converted to US Dollars for fast comparison. | | `is_free_shipping` | boolean | True when the item ships with no delivery fee. | | `is_sponsored` | boolean | True when the listing is a paid sponsored ad placement. | | `is_oversea_delivery` | boolean | True when the item ships internationally outside Korea. | | `is_big_smile` | boolean | True when the item is part of the BigSmile promotion. | | `is_adult` | boolean | True when the listing is flagged as an adult product. | | `seller_id` | string | The identifier of the seller behind the listing. | | `shop_handle` | string | The seller's shop handle on Gmarket. | | `category_code_l` | string | The large, top-level category code. | | `category_code_m` | string | The medium, mid-level category code. | | `category_code_s` | string | The small, lowest-level category code. | | `images_count` | number | The number of images attached to the product. | | `images` | string | All product image links for the listing. | | `image_url` | string | A direct link to the main product image. | | `product_url` | string | A direct link to the product page on Gmarket. | | `scraped_at` | string | The time the record was collected, as an ISO timestamp. | ### Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `query` | string | Yes | The keyword to search for on Gmarket, for example laptop, beauty, or clothing. | | `startUrls` | array of URLs | No | Paste Gmarket category, brand, or search result pages to scrape directly instead of using a keyword. | | `sortBy` | enum | No | The order products come back in: Relevance, Best Selling, Price low to high, Price high to low, or New arrivals. | | `minPrice` | integer | No | Only return products at or above this price in Korean Won. Set to 0 for no lower limit. | | `maxPrice` | integer | No | Only return products at or below this price in Korean Won. Set to 0 for no upper limit. | | `overseaDeliveryOnly` | boolean | No | Return only items that ship internationally outside Korea. Defaults to off. | | `bigSmileOnly` | boolean | No | Return only items in Gmarket's BigSmile promotion. Defaults to off. | | `maxItems` | integer | No | The most products to return in one run. | | `proxyConfiguration` | object | No | Connection settings. Datacenter proxies are fast, cheap, and reliable for Gmarket, and the defaults work for most runs. | ### Pricing Pricing is pay per result. You are billed per product record saved to your dataset, and the event is named "Product record" (one product with its prices, flags, and image links). Empty runs cost nothing. - **Rate:** about **$0.99 per 1,000 results** on the free tier. - **100 products** cost about **$0.10**. - **1,000 products** cost about **$0.99**. - On the Business (GOLD) plan, the rate drops to about **$0.74 per 1,000 results**. - No fixed monthly subscriptions and no hidden maintenance fees. ### Frequently asked questions ##### Does the Gmarket scraper get blocked? No. Gmarket's mobile global storefront serves its catalog reliably, and standard datacenter connections pass without trouble. Your runs stay fast and cheap, with no login required. ##### Are prices returned in both Korean Won and US Dollars? Yes. Every record carries the price in Korean Won and a pre-calculated price in US Dollars. You also get the original list price and any coupon price, so you can compare deals without manual conversion. ##### Can I scrape only items that ship outside Korea? Yes. Turn on the international shipping only toggle and the scraper returns just the products that deliver overseas. This is useful for cross-border sellers and dropshippers who need items that can reach buyers abroad. ##### How do I scrape a specific Gmarket 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 category, brand, and search result pages in one run. # Actor input Schema ## `query` (type: `string`): What to search for on Gmarket, for example laptop, beauty, or clothing. ## `startUrls` (type: `array`): Optional. Paste Gmarket category, brand, or search result URLs to scrape directly instead of a keyword. ## `sortBy` (type: `string`): The order products are returned in. ## `minPrice` (type: `integer`): Only return products priced at or above this amount in Korean Won. Set to 0 for no lower limit. ## `maxPrice` (type: `integer`): Only return products priced at or below this amount in Korean Won. Set to 0 for no upper limit. ## `overseaDeliveryOnly` (type: `boolean`): Only show items that ship internationally outside Korea. ## `bigSmileOnly` (type: `boolean`): Only show items in Gmarket's BigSmile sitewide promotion. ## `maxItems` (type: `integer`): The most products to return in one run. ## `proxyConfiguration` (type: `object`): Datacenter proxies are fast, cheap, and work reliably for Gmarket. ## Actor input object example ```json { "query": "laptop", "startUrls": [], "sortBy": "GLOBAL_RANKPOINT", "minPrice": 0, "maxPrice": 0, "overseaDeliveryOnly": false, "bigSmileOnly": false, "maxItems": 120, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] } } ``` # 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": "laptop", "startUrls": [], "sortBy": "GLOBAL_RANKPOINT", "minPrice": 0, "maxPrice": 0, "overseaDeliveryOnly": false, "bigSmileOnly": false, "maxItems": 120, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/gmarket-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": "laptop", "startUrls": [], "sortBy": "GLOBAL_RANKPOINT", "minPrice": 0, "maxPrice": 0, "overseaDeliveryOnly": False, "bigSmileOnly": False, "maxItems": 120, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": [], }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/gmarket-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": "laptop", "startUrls": [], "sortBy": "GLOBAL_RANKPOINT", "minPrice": 0, "maxPrice": 0, "overseaDeliveryOnly": false, "bigSmileOnly": false, "maxItems": 120, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [] } }' | apify call getascraper/gmarket-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/gmarket-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Gmarket Korea Scraper: Products in KRW & USD", "description": "Scrape product listings from Gmarket South Korea. Get titles, prices in KRW and USD, original and coupon prices, free shipping and international delivery flags, seller IDs, and image links. Filter by price, sort order, and BigSmile deals. Export to Excel, Sheets, CSV, or JSON.", "version": "0.1", "x-build-id": "xcXDRvXITAGY8Tkt8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~gmarket-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-gmarket-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~gmarket-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-gmarket-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~gmarket-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-gmarket-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": "What to search for on Gmarket, for example laptop, beauty, or clothing.", "default": "laptop" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional. Paste Gmarket category, brand, or search result URLs to scrape directly instead of a keyword.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sortBy": { "title": "Sort Order", "enum": [ "GLOBAL_RANKPOINT", "GLOBAL_SELL_QTY", "GLOBAL_LOW_PRICE", "GLOBAL_HIGH_PRICE", "GLOBAL_RECENT" ], "type": "string", "description": "The order products are returned in.", "default": "GLOBAL_RANKPOINT" }, "minPrice": { "title": "Minimum Price (KRW)", "minimum": 0, "type": "integer", "description": "Only return products priced at or above this amount in Korean Won. Set to 0 for no lower limit.", "default": 0 }, "maxPrice": { "title": "Maximum Price (KRW)", "minimum": 0, "type": "integer", "description": "Only return products priced at or below this amount in Korean Won. Set to 0 for no upper limit.", "default": 0 }, "overseaDeliveryOnly": { "title": "International Shipping Only", "type": "boolean", "description": "Only show items that ship internationally outside Korea.", "default": false }, "bigSmileOnly": { "title": "BigSmile Deals Only", "type": "boolean", "description": "Only show items in Gmarket's BigSmile sitewide promotion.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "The most products to return in one run.", "default": 120 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Datacenter proxies are fast, cheap, and work reliably for Gmarket.", "default": { "useApifyProxy": true, "apifyProxyGroups": [] } } } }, "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 } } } } } } } } } } ```