# Coupang Search Scraper (쿠팡) (`parsebird/coupang-search-scraper`) Actor Scrape Coupang.com Korea search results by keyword: product IDs, name, price, rating, review count, image, URL, and optional nested detail with live prices, coupons, delivery, stock, seller, and specs. - **URL**: https://apify.com/parsebird/coupang-search-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.39 / 1,000 products 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 Search Scraper (쿠팡) Scrape [Coupang.com](https://www.coupang.com/) Korea **search results** by Korean or English keyword. Every product row carries the three identifiers (`productId`, `itemId`, `vendorItemId`), **name, price, rating, review count, image, and URL** — one dataset section per keyword. Turn on **Include detail** and each row also gets a nested `detail` object with live prices and coupons, delivery, stock, seller, specifications, certifications, and return policy.
Search Coupang by keyword, set a target product count per keyword (or 0 for the full catalogue), filter by price, rating, condition and Rocket delivery, and optionally attach the full per-product pricing / coupon / delivery / spec detail.

ParseBird Coupang Suite   •  Korea's largest marketplace
Coupang Search Scraper
You are here 		Coupang Korea Product Scraper
Search + category + product URLs, incremental monitoring 		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-search-scraper on Apify. Scrapes Coupang.com (Korea) search results by keyword. Call: ApifyClient("TOKEN").actor("parsebird/coupang-search-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Inputs: keywords (array, required — Korean or English, one search per keyword), maxProductsPerKeyword (int, default 100, 0 = full catalogue, 1-9 treated as 10), includeDetail (bool default false — adds nested detail object), sortBy ("relevance"|"bestSelling"|"priceLow"|"priceHigh"), minPrice/maxPrice (KRW), minRating ("1".."4.5"), offerCondition ("NEW"|"USED"|"REFURBISHED"), rocketDeliveryOnly (bool), brandIds (array). Output per product: productId, itemId, vendorItemId, name, price, currency, ratingAverage, ratingCount, image, url, keyword, originalPrice, discountRate, rocketDelivery, rocketFresh, rocketGlobal, deliveryBadge, freeShipping, isAd, soldOut, scrapedAt. With includeDetail: detail.core (finalPrice, salePrice, couponPrice, originPrice, discountRate, wowMemberPrice, nonWowMemberPrice, sellerName, breadcrumbs, deliveryInfo, optionRows, shippingFee, cashBackSummary, couponList, soldOut, otherSellerCount, images, sellingInfo, ratingAverage, ratingCount), detail.specs [{title,description}], detail.certifications, detail.detailBlocks, detail.returnPolicy, detail.sellingPoints. Requires Apify Proxy "Unblocker" group (default). Full spec: GET https://api.apify.com/v2/acts/parsebird~coupang-search-scraper (Bearer TOKEN). Token: https://console.apify.com/account/integrations ``` ### What is Coupang Search Scraper? **Coupang Search Scraper** turns a list of keywords into structured [Coupang.com](https://www.coupang.com/) search data. Coupang has no public product API, so this Actor is the practical **Coupang API alternative** for pulling search results, prices, and per-product detail into JSON, CSV, or Excel. Give it one or more **search terms** (`laptop`, `노트북`, `기계식 키보드`), a target number of products per keyword, and optionally turn on **Include detail** for the nested `detail` object. No coding required, or drive it through the [Apify API](https://docs.apify.com/api/v2) for scheduled price monitoring. ### What can Coupang Search Scraper do? - 🔎 **Keyword search** — scrape Coupang search results for any Korean or English term, one dataset section per keyword - 🎯 **Target count** — `maxProductsPerKeyword` sets how many products to collect; set it to `0` for the full available catalogue for that keyword - 🧾 **Detail on demand** — `includeDetail` attaches a `detail` object per product: live prices and coupons per quantity step, delivery and shipping, stock and sold-out flags, seller and store rating, breadcrumbs, option rows, specifications, certifications, return policy, and description blocks - 💰 **Price & rating** — sale price, original price, discount rate, average rating, and review count on every row - 🚀 **Rocket flags** — `rocketDelivery`, `rocketFresh`, `rocketGlobal`, plus free-shipping and delivery-badge text - 🎛️ **Filters** — sort order, price range, minimum rating, product condition, Rocket-delivery-only, and brand IDs - 🔄 **Scheduling & integrations** — run on a schedule and push to Google Sheets, Zapier, Make, or webhooks ### What data can you extract from Coupang? **Every product row** | Field | Description | |-------|-------------| | `productId` / `itemId` / `vendorItemId` | Coupang's product, item, and vendor-item identifiers | | `name` | Product name | | `price` / `originalPrice` / `discountRate` | Current price, list price, and discount % in KRW | | `currency` | Always `KRW` | | `ratingAverage` / `ratingCount` | Average star rating (0–5) and number of reviews | | `image` / `url` | Primary thumbnail and product URL | | `rocketDelivery` / `rocketFresh` / `rocketGlobal` | Rocket service eligibility flags | | `deliveryBadge` / `freeShipping` | Delivery text (`내일(토) 도착 보장`) and free-shipping flag | | `isAd` / `soldOut` | Sponsored placement and sold-out flags | | `keyword` | The search term that produced the row | | `scrapedAt` | ISO timestamp of the scrape | **`detail` object (with `includeDetail`)** | Field | Description | |-------|-------------| | `detail.core` | `finalPrice`, `salePrice`, `couponPrice`, `originPrice`, `discountRate`, `wowMemberPrice`, `nonWowMemberPrice`, `sellerName`, `breadcrumbs`, `deliveryInfo`, `optionRows`, `shippingFee`, `cashBackSummary`, `couponList`, `soldOut`, `almostSoldOut`, `buyableQuantity`, `otherSellerCount`, `images`, `sellingInfo`, `ratingAverage`, `ratingCount` | | `detail.specs` | Spec rows as `{title, description}` — model name, KC certification, release date, country of origin, A/S contact, … *(when Coupang's page includes the below-the-fold section)* | | `detail.certifications` | Certification number, name, description, image and lookup URL *(when present)* | | `detail.detailBlocks` | The product's rich HTML / image description blocks *(when present)* | | `detail.returnPolicy` | Delivery notice, return notice, seller info, and the return policy text *(when present)* | | `detail.sellingPoints` | Seller-provided selling points *(when present)* | > `detail.core` (prices, coupons, delivery, breadcrumbs, options, stock, seller, other sellers, rating) is always populated when the detail is fetched. `specs`, `certifications`, `detailBlocks`, `returnPolicy`, and `sellingPoints` come from Coupang's below-the-fold render, which is not present on every page load — they are best-effort and default to `[]` / `{}` when absent. > The option matrix (all variants) and full category tree belong to the Coupang Product Detail Scraper's full-detail mode. ### How to scrape Coupang search results 1. On [Coupang.com](https://www.coupang.com/), find the keywords you want to track 2. Open the [Coupang Search Scraper](https://apify.com/parsebird/coupang-search-scraper) on Apify and click **Try for free** 3. Add your terms to **Keywords**, set **Max products per keyword**, and turn on **Include detail** if you need the nested detail object 4. Set any price / rating / condition / Rocket / brand filters 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-search-scraper").call(run_input={ "keywords": ["노트북", "wireless mouse"], "maxProductsPerKeyword": 100, "includeDetail": True, "sortBy": "priceLow", "minPrice": 10000, "rocketDeliveryOnly": True, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): core = (item.get("detail") or {}).get("core", {}) print(f'{item["price"]} KRW | ★{item.get("ratingAverage")} | {item["name"]} | coupon {core.get("couponPrice")}') ``` #### JavaScript API example ```javascript import { ApifyClient } from "apify-client"; const client = new ApifyClient({ token: "YOUR_API_TOKEN" }); const run = await client.actor("parsebird/coupang-search-scraper").call({ keywords: ["기계식 키보드"], maxProductsPerKeyword: 0, includeDetail: false, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((i) => console.log(`${i.price} — ${i.name}`)); ``` ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `keywords` | array | **Yes** | — | Search terms, Korean or English. One search per keyword | | `maxProductsPerKeyword` | integer | No | `100` | Target products per keyword. `0` = full catalogue. 1–9 are treated as 10 | | `includeDetail` | boolean | No | `false` | Attach the nested `detail` object per product | | `sortBy` | string | No | `relevance` | `relevance`, `bestSelling`, `priceLow`, `priceHigh` | | `minPrice` / `maxPrice` | integer | No | — | Price range in KRW | | `minRating` | string | No | — | Minimum average rating (`1`–`4.5`) | | `offerCondition` | string | No | — | `NEW`, `USED`, or `REFURBISHED` | | `rocketDeliveryOnly` | boolean | No | `false` | Keep only Rocket delivery products | | `brandIds` | array | No | — | Restrict to specific Coupang brand IDs | | `proxy` | object | No | Unblocker | Proxy configuration — the Apify Proxy "Unblocker" group is required | ### Output example ```json { "productId": "6126155781", "itemId": "11648349573", "vendorItemId": "78922805094", "name": "레이저 DeathAdder Essential 유선마우스, RZ01-0385, Black", "price": 23900, "currency": "KRW", "ratingAverage": 5, "ratingCount": 5509, "image": "https://thumbnail.coupangcdn.com/thumbnails/remote/492x492ex/image/…", "url": "https://www.coupang.com/vp/products/6126155781?itemId=11648349573&vendorItemId=78922805094", "rocketDelivery": true, "keyword": "mouse", "detail": { "core": { "finalPrice": "23,900", "salePrice": "23,900", "couponPrice": "23,900", "originPrice": null, "discountRate": null, "wowMemberPrice": { "price": 23900, "priceWithDeliveryFee": 23900 }, "nonWowMemberPrice": { "price": 23900, "priceWithDeliveryFee": 23900 }, "sellerName": null, "breadcrumbs": ["쿠팡수입", "가전디지털", "키보드/마우스", "마우스", "유선마우스"], "optionRows": [ { "name": "모델명/품번", "attributes": [{ "name": "RZ01-0385", "selected": true }] }, { "name": "색상", "attributes": [{ "name": "Black", "selected": true }, { "name": "화이트", "selected": false }] } ], "shippingFee": { "type": "FREE", "amount": 0, "message": "무료배송" }, "otherSellerCount": 26 }, "specs": [ { "title": "품명 및 모델명", "description": "레이저 DeathAdder Essential 유선마우스 RZ01-0385" }, { "title": "KC 인증정보", "description": "R-R-RAZ-RZ01-0385" } ], "certifications": [ { "certificationNo": "R-R-RAZ-RZ01-0385", "name": "방송통신기자재 적합성 평가 대상" } ], "detailBlocks": ["… 3 HTML / image description blocks"], "returnPolicy": { "deliveryNotice": "…", "returnNotice": "…", "sellerInfo": {} }, "sellingPoints": [] } } ``` Download results in JSON, HTML, CSV, or Excel. ### Use cases - 💹 **Price and coupon monitoring** — schedule a keyword and track `finalPrice`, `couponPrice`, and `discountRate` per quantity step - 📊 **Assortment and share-of-search research** — pull the full catalogue for a keyword and analyse price distribution, Rocket coverage, and rating spread - 🏷️ **Brand and MAP compliance** — watch how resellers price your products across keywords - 🔁 **Stock alerts** — `detail.core.soldOut` / `almostSoldOut` / `buyableQuantity` - 🧾 **Catalog building** — seed a product database with identifiers, images, specs, and certifications ### How it works 1. Builds a Coupang search URL per keyword with your sort and price / Rocket / brand filters 2. Requests each result page through the Apify Unblocker and reads every product card — identifiers, price, rating, Rocket flags — up to your target count (or until the catalogue ends when the target is `0`) 3. Applies your price, rating, condition, and Rocket filters 4. When **Include detail** is on, opens each product's SDP page and extracts the pricing / coupon matrix, delivery, stock, seller, options, specs, certifications, return policy, and description blocks 5. Emits one row per product and charges a `product` event, plus a `product-essentials` event when the detail was parsed ### How much does it cost to scrape Coupang search results? | Event | Free | Bronze | Silver | Gold | |-------|------|--------|--------|------| | `product` (per 1,000) | **$2.99** | $2.79 | $2.59 | $2.39 | | `product-essentials` (per 1,000) | **$1.99** | $1.89 | $1.79 | $1.69 | A `product` event is charged for every row returned. A `product-essentials` event is charged only when a product's `detail` object was successfully built (with `includeDetail` on) — so a detailed run of 1,000 products costs about **$4.98** on the Free plan. Leave `includeDetail` off for search-level data at the lower price. Your Apify plan's free monthly usage covers the platform compute and proxy. ### FAQ **What does `maxProductsPerKeyword: 0` do?** It collects the full available catalogue for that keyword — the Actor walks result pages until Coupang stops returning new products. Values 1–9 are treated as 10. **Why does it need the Unblocker proxy?** Coupang serves Korean shoppers and its Akamai edge refuses almost all datacenter and non-Korean residential traffic. The Apify Proxy "Unblocker" group is the transport that gets through and is the default. **What is the difference from the Coupang Korea Product Scraper?** This Actor is keyword-search-only with an optional per-product `detail` object and incremental-free monitoring by re-running a keyword. The [Coupang Korea Product Scraper](https://apify.com/parsebird/coupang-scraper) also walks category and product URLs and has cross-run change tracking (`changeType` / `changedFields`). **Can I get every product variant and the full category tree?** The `detail.core.optionRows` field lists the option matrix for the scraped item. Full variant expansion and the complete category path are planned for a Coupang Product Detail Scraper. **A run returned few products — why?** The Unblocker occasionally returns a partial page or a block for a batch of requests; the Actor retries each page several times. Re-run it, or lower `maxProductsPerKeyword`. Coupang also caps a single keyword search at roughly 4,000 results. **Can I schedule it?** Yes. Use [Apify scheduling](https://docs.apify.com/platform/schedules) to re-run the same keywords 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 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 | | [Coupang Korea Product Scraper](https://apify.com/parsebird/coupang-scraper) | Coupang.com | Search / category / product URLs, monitoring | | [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 | Browse all ParseBird actors on the [Apify Store](https://apify.com/parsebird). # Actor input Schema ## `keywords` (type: `array`): Search terms, Korean or English. One search is run per keyword. ## `maxProductsPerKeyword` (type: `integer`): Target number of products per keyword. 0 collects the full available catalogue. Values 1-9 are treated as 10. ## `includeDetail` (type: `boolean`): Add the nested `detail` object per product: live prices and coupons per quantity step, delivery and shipping, stock and sold-out flags, seller and store rating, breadcrumbs, option rows, specifications, certifications, return policy, and description blocks. Adds the `product-essentials` charge per product. ## `sortBy` (type: `string`): Result order. ## `minPrice` (type: `integer`): Minimum price in Korean won. ## `maxPrice` (type: `integer`): Maximum price in Korean won. ## `minRating` (type: `string`): Minimum average star rating. ## `offerCondition` (type: `string`): Product condition. ## `rocketDeliveryOnly` (type: `boolean`): Keep only Rocket delivery products. ## `brandIds` (type: `array`): Restrict to specific Coupang brand IDs (from a search-page brand filter URL). ## `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 { "keywords": [ "노트북" ], "maxProductsPerKeyword": 40, "includeDetail": false, "sortBy": "relevance", "minRating": "", "offerCondition": "", "rocketDeliveryOnly": false, "brandIds": [], "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 = { "keywords": [ "노트북" ], "maxProductsPerKeyword": 40, "brandIds": [], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/coupang-search-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 = { "keywords": ["노트북"], "maxProductsPerKeyword": 40, "brandIds": [], "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["UNBLOCKER"], }, } # Run the Actor and wait for it to finish run = client.actor("parsebird/coupang-search-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 '{ "keywords": [ "노트북" ], "maxProductsPerKeyword": 40, "brandIds": [], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } }' | apify call parsebird/coupang-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/coupang-search-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/4zDdpkIWfdtBpVJNB/builds/LAfkLFMqRZDklVOKO/openapi.json