# Coupang Korea Product Scraper (`parsebird/coupang-scraper`) Actor Scrape Coupang.com Korea product listings: price, discount, rating, review count, Rocket delivery, images, brand, category, and description. Search by keyword or walk category/product URLs. Export JSON, CSV, Excel. - **URL**: https://apify.com/parsebird/coupang-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.29 / 1,000 product listings 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? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 ### Coupang Korea Product Scraper Extract structured product data from [Coupang.com](https://www.coupang.com/), Korea's largest online marketplace. Search by Korean or English keyword, walk category and search-result pages, or scrape individual product pages — and get **title, sale price, original price, discount, rating, review count, Rocket delivery flags, images, brand, seller, and category breadcrumb** as clean JSON.
Search Coupang by keyword or paste any category / search / product URL — filter by price, rating, and Rocket delivery, optionally enrich with product-page details, and track price and stock changes across scheduled runs.

ParseBird Coupang Suite   •  Korea's largest marketplace
Coupang Korea Product Scraper
You are here 		Coupang Search Scraper
Keyword search + optional detail 		Coupang Product Detail Scraper
Full pages by URL/ID: option matrix, specs
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ``` parsebird/coupang-scraper on Apify. Scrapes Coupang.com (Korea) product listings. Call: ApifyClient("TOKEN").actor("parsebird/coupang-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Inputs: mode ("search" | "url"), queries (array of Korean/English terms, search mode), categoryId (int, optional), urls (array of coupang.com /np/search, /np/categories/, or /vp/products/ URLs, url mode), minPrice/maxPrice (KRW), rocketOnly (bool), minRating (1-5), sortBy ("scoreDesc"|"salePriceAsc"|"salePriceDesc"|"latestAsc"|"saleCountDesc"), maxPages (default 3, ~60 items/page), maxListings (0=unlimited), fetchDetails (bool — visit each product page for brand, seller, category breadcrumb, image gallery), incrementalMode (bool — adds changeType NEW/UPDATED/UNCHANGED/REAPPEARED/EXPIRED + changedFields), stateKey, emitUnchanged, emitExpired, resumeFromRunId (continue an interrupted run). Output per product: productId, itemId, vendorItemId, title, brand, url, image, images, price, originalPrice, discountPercent, isOnSpecial, savingsAmount, unitPrice, currency, rating, reviewCount, rocketDelivery, rocketFresh, rocketGlobal, tomorrowDelivery, freeShipping, availability, deliveryInfo, isAd, categoryId, categoryPath, description, sellerName, query, scrapedAt. Requires Apify Proxy "Unblocker" group (default). Full spec: GET https://api.apify.com/v2/acts/parsebird~coupang-scraper (Bearer TOKEN). Token: https://console.apify.com/account/integrations ``` ### What is Coupang Korea Product Scraper? **Coupang Korea Product Scraper** turns [Coupang.com](https://www.coupang.com/) search results, category pages, and product pages into structured data. Coupang has no public product API, so this Actor is the practical **Coupang API alternative** for pulling catalog data, prices, and ratings into JSON, CSV, or Excel. Give it a Korean or English **search term** (`노트북`, `wireless mouse`), a **category** to browse, or a list of **Coupang URLs**. It walks the result pages, reads every product card, and — when you turn on **Fetch product details** — opens each product page for the brand, seller, full category breadcrumb, and image gallery. No coding required, or drive it through the [Apify API](https://docs.apify.com/api/v2) for scheduled price and stock monitoring. ### What can Coupang Korea Product Scraper do? - 🔎 **Keyword search** — scrape Coupang search results for any Korean or English term, with Coupang's own sort orders (ranking, price, newest, best-selling) - 🧭 **Category & URL walking** — paste `coupang.com/np/categories/...`, `coupang.com/np/search?q=...`, or `coupang.com/vp/products/...` URLs and let the Actor paginate - 💰 **Price intelligence** — sale price, original (list) price, discount percentage, per-unit price, and savings amount for every product - 🚀 **Rocket delivery flags** — `rocketDelivery`, `rocketFresh`, `rocketGlobal`, plus next-day delivery and free-shipping flags - ⭐ **Ratings** — average star rating and review count from the listing, refined from the product page when details are on - 🏷️ **Detail enrichment** — brand, seller name, full category breadcrumb (`가전디지털 > 컴퓨터 > 노트북`), and the product image gallery - 🎯 **Filters** — minimum price, maximum price, minimum rating, and Rocket-delivery-only - 🔁 **Change tracking** — incremental mode tags every row `NEW`, `UPDATED`, `UNCHANGED`, `REAPPEARED`, or `EXPIRED`, with a `changedFields` list, for scheduled monitoring - ⏯️ **Resume** — continue an interrupted run without re-scraping (and re-billing) what you already have - 🔄 **Scheduling & integrations** — run on a schedule and push to Google Sheets, Zapier, Make, or webhooks ### What data can you extract from Coupang? | Field | Description | |-------|-------------| | `productId` / `itemId` / `vendorItemId` | Coupang's product, item, and vendor-item identifiers | | `title` | Product name | | `brand` | Brand name (with `fetchDetails`) | | `sellerName` | Seller / vendor name (with `fetchDetails`) | | `url` | Direct product URL | | `image` / `images` | Primary thumbnail and full image gallery | | `price` | Current sale price in KRW | | `originalPrice` | Original / list price in KRW | | `discountPercent` / `savingsAmount` | Discount percentage and won saved | | `isOnSpecial` | Whether the product is discounted | | `unitPrice` | Per-unit price string, e.g. `(1개당 1,745원)` | | `rating` / `reviewCount` | Average star rating (0–5) and number of reviews | | `rocketDelivery` / `rocketFresh` / `rocketGlobal` | Rocket service eligibility flags | | `tomorrowDelivery` / `freeShipping` | Delivery speed and free-shipping flags | | `deliveryInfo` | Delivery text as shown, e.g. `내일(수) 도착 보장` | | `availability` | `InStock` or `OutOfStock` | | `isAd` | Whether the card is a sponsored placement | | `categoryId` / `categoryPath` | Category id and breadcrumb (category / product URLs, or any product with `fetchDetails`) | | `description` | Product description text (with `fetchDetails`) | | `query` | The search term that produced the row | | `changeType` / `changedFields` / `firstSeenAt` / `lastSeenAt` | Incremental-mode change tracking | | `scrapedAt` | ISO timestamp of the scrape | ### How to scrape Coupang 1. On [Coupang.com](https://www.coupang.com/), run the search or open the category you want and copy the URL — or just note the keyword 2. Open the [Coupang Korea Product Scraper](https://apify.com/parsebird/coupang-scraper) on Apify and click **Try for free** 3. Pick **Search by keyword** and add your terms to **Search terms**, or pick **Walk URLs** and paste Coupang URLs 4. Set **Max pages**, **Max listings**, and any price / rating / Rocket filters; turn on **Fetch product details** for brand, seller, and category 5. Click **Start**, then download the data as **JSON, CSV, Excel**, or read it via the **Apify API** #### Python API example ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("parsebird/coupang-scraper").call(run_input={ "mode": "search", "queries": ["노트북", "wireless mouse"], "minPrice": 10000, "maxPrice": 500000, "rocketOnly": True, "minRating": 4, "sortBy": "salePriceAsc", "maxPages": 5, "maxListings": 100, "fetchDetails": True, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f'{item["price"]} KRW | ★{item.get("rating")} | {item["title"]}') ``` #### JavaScript API example ```javascript import { ApifyClient } from "apify-client"; const client = new ApifyClient({ token: "YOUR_API_TOKEN" }); const run = await client.actor("parsebird/coupang-scraper").call({ mode: "url", urls: ["https://www.coupang.com/np/categories/178255"], rocketOnly: true, maxPages: 3, maxListings: 120, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((i) => console.log(`${i.price} — ${i.title}`)); ``` ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `mode` | string | No | `search` | `search` for keyword + filters, `url` for direct URL walking | | `queries` | array | Yes (search) | `["노트북"]` | Korean or English search terms; one search per term | | `categoryId` | integer | No | — | Narrow a keyword search to a Coupang category id | | `urls` | array | Yes (url) | — | Coupang search, category, or product URLs | | `minPrice` / `maxPrice` | integer | No | — | Price range in KRW | | `rocketOnly` | boolean | No | `false` | Keep only Rocket-delivery-eligible items | | `minRating` | integer | No | — | Minimum average rating, 1–5 | | `sortBy` | string | No | `scoreDesc` | `scoreDesc`, `salePriceAsc`, `salePriceDesc`, `latestAsc`, `saleCountDesc` | | `maxPages` | integer | No | `3` | Result pages to walk per query / URL (~60 items per page) | | `maxListings` | integer | No | `0` | Stop after this many items (0 = unlimited) | | `fetchDetails` | boolean | No | `false` | Fetch each product page for brand, seller, category, images | | `incrementalMode` | boolean | No | `false` | Cross-run change detection with `changeType` | | `stateKey` | string | No | auto | Name a monitoring campaign | | `emitUnchanged` / `emitExpired` | boolean | No | `false` | Also return unchanged / expired rows in incremental mode | | `resumeFromRunId` | string | No | — | Continue an interrupted run by run or dataset ID | | `proxy` | object | No | Unblocker | Proxy configuration — the Apify Proxy "Unblocker" group is required | ### Output example ```json { "productId": "8036829511", "itemId": "22489515360", "vendorItemId": "89564765549", "title": "삼성전자 갤럭시북4 NT750XGK-KC51S", "brand": "삼성전자", "sellerName": "쿠팡", "url": "https://www.coupang.com/vp/products/8036829511?itemId=22489515360&vendorItemId=89564765549", "image": "https://thumbnail.coupangcdn.com/thumbnails/remote/492x492ex/image/vendor_inventory/xxxx.jpg", "images": ["https://thumbnail.coupangcdn.com/thumbnails/remote/492x492ex/image/vendor_inventory/xxxx.jpg"], "price": 549000, "originalPrice": 599000, "discountPercent": 8, "isOnSpecial": true, "savingsAmount": 50000, "unitPrice": null, "currency": "KRW", "rating": 4.7, "reviewCount": 1864, "rocketDelivery": true, "rocketFresh": false, "rocketGlobal": false, "tomorrowDelivery": true, "freeShipping": true, "availability": "InStock", "deliveryInfo": "내일(수) 도착 보장", "isAd": false, "categoryId": "497135", "categoryPath": "가전디지털 > 노트북", "query": "노트북", "scrapedAt": "2026-09-10T09:12:44.101Z" } ``` Download results in JSON, HTML, CSV, or Excel. ### Use cases - 💹 **Price and discount monitoring** — schedule a saved search and track sale price, list price, and discount moves with `changeType` / `changedFields` - 📊 **Market and assortment research** — pull a whole category to analyse price distribution, Rocket coverage, brand share, and rating spread - 🏷️ **Brand and MAP compliance** — watch how resellers price your products on Coupang - 🔁 **Stock and availability alerts** — detect `OutOfStock` and `EXPIRED` products across runs - 🧾 **Catalog building** — seed a product database with titles, images, categories, and identifiers - 🔗 **BI and CRM pipelines** — feed structured Coupang data into your analytics stack ### How it works 1. Builds a Coupang search URL per keyword (or takes your pasted URLs) and requests each result page through the Apify Unblocker 2. Reads every product card — identifiers, price block, rating, Rocket badges, delivery text — and auto-paginates up to `maxPages` / `maxListings` 3. Applies your price, rating, and Rocket filters 4. When **Fetch product details** is on, opens each product page and merges in brand, seller, category breadcrumb, and the image gallery 5. In incremental mode, compares against the saved state for your `stateKey` and tags each row `NEW` / `UPDATED` / `UNCHANGED` / `REAPPEARED` / `EXPIRED` 6. Emits one clean record per product and charges a `listing` event, plus an `enrichment` event when a detail page was parsed ### How much does it cost to scrape Coupang? | Event | Free | Bronze | Silver | Gold | |-------|------|--------|--------|------| | `listing` (per 1,000) | **$2.59** | $1.99 | $1.49 | $1.29 | | `enrichment` (per 1,000) | **$0.89** | $0.79 | $0.69 | $0.59 | A `listing` event is charged for every product returned. An `enrichment` event is charged only when a product's detail page is successfully parsed (with `fetchDetails` on) — so a fully enriched run of 1,000 products costs about **$3.48** on the Free plan. Leave `fetchDetails` off for listing-level data at the lower price. Your Apify plan's free monthly usage covers the platform compute and proxy. ### FAQ **Which URLs can I paste in URL mode?** Coupang search URLs (`/np/search?q=...`), leaf category URLs (`/np/categories/{id}`), and product URLs (`/vp/products/{id}`). Pagination is automatic — you do not need to add page numbers. A **top-level** category URL shows subcategory tiles rather than a product grid and will return nothing — for a whole department use search mode with `categoryId`, or paste the department's `/np/search` URL. **Why does it need the Unblocker proxy?** Coupang serves Korean shoppers and its Akamai edge refuses almost all datacenter and non-Korean residential traffic with an "Access Denied" page. The Apify Proxy "Unblocker" group is the transport that gets through and is the default. **What does "Fetch product details" add?** Without it you get everything on the search / category card: title, price, discount, rating, review count, Rocket flags, image, delivery text. With it, the Actor opens each product page for the brand, seller name, full category breadcrumb, list/sale price confirmation, and the image gallery. **How is the category breadcrumb populated?** On a category-browse or product URL it is read from the page itself. On a keyword search left at the default it is `null`, because Coupang's search-results page carries no breadcrumb — turn on **Fetch product details** to add it to every row. **How does incremental mode work?** Turn on **Incremental mode** and run the same search on a schedule. The Actor stores a fingerprint of every product under your `stateKey` (auto-derived from your inputs if you leave it blank). Later runs return only `NEW`, `UPDATED`, and `REAPPEARED` rows by default; `changedFields` lists exactly which fields moved. Turn on **Emit unchanged** or **Emit expired** to also get those rows. **A run returned few or no products — why?** The Unblocker occasionally returns a partial page or a block for a batch of requests; the Actor already retries each page several times. Re-run it, or lower `maxPages`. Very narrow price / rating filters combined with a broad keyword can also thin the results — the Actor over-fetches to compensate but is bounded by `maxPages`. **Can I scrape customer reviews?** This Actor covers product listings and details. Coupang's review endpoint is not reachable through the proxy tooling available here, so individual review text is not included; the listing `rating` and `reviewCount` are. **Can I schedule it?** Yes. Use [Apify scheduling](https://docs.apify.com/platform/schedules) to re-run the same search on any interval and connect the output to Google Sheets, Zapier, Make, or webhooks. Found a bug? Open an issue on the **Issues** tab. ### Is it legal to scrape Coupang? This Actor extracts publicly available data from Coupang.com. Scraping public data is generally considered legal based on recent court rulings, including the US Ninth Circuit's decision in *hiQ Labs v. LinkedIn*. Users are responsible for ensuring their use of the scraped data complies with applicable laws, Coupang's Terms of Service, and data-protection regulations. For more, read Apify's post on [web scraping legality](https://blog.apify.com/is-web-scraping-legal/). ### Other ParseBird scrapers | Actor | Target site | Data | |-------|------------|------| | [Coupang Korea Product Scraper](https://apify.com/parsebird/coupang-scraper) | Coupang.com | Korean marketplace products | | [Coupang Search Scraper](https://apify.com/parsebird/coupang-search-scraper) | Coupang.com | Keyword search results + detail | | [Coupang Product Detail Scraper](https://apify.com/parsebird/coupang-detail-scraper) | Coupang.com | Full product pages: option matrix, prices, specs | | [Naver Map Scraper](https://apify.com/parsebird/naver-map-scraper) | Naver Map | Korean business listings | | [Naver Place Review Scraper](https://apify.com/parsebird/naver-place-review-scraper) | Naver Place | Korean business reviews | | [Naver Blog & Cafe Scraper](https://apify.com/parsebird/naver-blog-cafe-scraper) | Naver | Korean blog & cafe posts | Browse all ParseBird actors on the [Apify Store](https://apify.com/parsebird). # Actor input Schema ## `mode` (type: `string`): `search` = keyword + filters, `url` = walk pasted search / category / product URLs. ## `queries` (type: `array`): Search mode. One or more Korean or English search terms, e.g. `노트북` or `wireless mouse`. One search is run per term. ## `categoryId` (type: `integer`): Search mode (optional). Narrow the keyword search to a Coupang category id. In URL mode the category comes from the pasted URL. ## `urls` (type: `array`): URL mode. Coupang search (`/np/search?q=...`), category (`/np/categories/...`), or product (`/vp/products/...`) URLs. Pagination is automatic. ## `minPrice` (type: `integer`): Minimum item price in Korean won. Sent to Coupang in search mode and re-checked in the actor; applied in the actor in URL mode. ## `maxPrice` (type: `integer`): Maximum item price in Korean won. ## `rocketOnly` (type: `boolean`): Keep only items eligible for Coupang's Rocket Delivery service. ## `minRating` (type: `integer`): Minimum average star rating, 1 to 5. ## `sortBy` (type: `string`): Search mode. A pasted URL keeps its own sort order. ## `maxPages` (type: `integer`): Result pages to walk per query or URL (about 60 items per page). ## `maxListings` (type: `integer`): Stop after this many items in total. 0 = unlimited. ## `fetchDetails` (type: `boolean`): Visit each product page for brand, seller, category breadcrumb, full image gallery, and list/sale price. Adds the enrichment charge per product. ## `incrementalMode` (type: `boolean`): Track changes across scheduled runs with the same state key. Adds a `changeType` (NEW / UPDATED / UNCHANGED / REAPPEARED / EXPIRED) and `changedFields` to every row. The first run records a baseline. ## `stateKey` (type: `string`): Name a monitoring campaign, or leave empty to derive one automatically from mode + queries / category / URLs / filters. ## `emitUnchanged` (type: `boolean`): Incremental mode. Also return (and bill) rows identical to the last run. ## `emitExpired` (type: `boolean`): Incremental mode. Also return (and bill) products tracked before but not found this run. Only after a complete, uncapped, non-resumed scan. ## `resumeFromRunId` (type: `string`): Continue ONE interrupted run. Paste a previous run ID or dataset ID; products already collected there are skipped and only new ones are appended. ## `proxy` (type: `object`): Coupang's edge blocks datacenter and non-Korean residential IPs, so the Apify Proxy "Unblocker" group is required and is the default. ## Actor input object example ```json { "mode": "search", "queries": [ "노트북" ], "urls": [], "rocketOnly": false, "sortBy": "scoreDesc", "maxPages": 2, "maxListings": 40, "fetchDetails": false, "incrementalMode": false, "emitUnchanged": false, "emitExpired": false, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } ``` # Actor output Schema ## `dataset` (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 = { "queries": [ "노트북" ], "urls": [], "maxPages": 2, "maxListings": 40, "stateKey": "", "resumeFromRunId": "", "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/coupang-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 = { "queries": ["노트북"], "urls": [], "maxPages": 2, "maxListings": 40, "stateKey": "", "resumeFromRunId": "", "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["UNBLOCKER"], }, } # Run the Actor and wait for it to finish run = client.actor("parsebird/coupang-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": [ "노트북" ], "urls": [], "maxPages": 2, "maxListings": 40, "stateKey": "", "resumeFromRunId": "", "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } }' | apify call parsebird/coupang-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/coupang-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 ` 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/bezzLABNdKzulsrBz/builds/Ni2RdCegxOqhe5urt/openapi.json