# Coupang Search Scraper (쿠팡) - Products, Prices & Specs (`zen-studio/coupang-search-scraper`) Actor

Scrape Coupang (쿠팡) products by keyword: prices, ratings, options, seller, delivery, specs, and certifications. Export thousands to JSON, CSV, or Excel. Korean or English keywords, no login needed. Each product includes the IDs to pull its reviews.

- **URL**: https://apify.com/zen-studio/coupang-search-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.99 / 1,000 product scrapeds

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

## Coupang Search Scraper (쿠팡) | Korea Marketplace Product Data & Reviews (2026)

![Coupang Search Scraper](https://iili.io/C0wKiLQ.png)

<blockquote style="border-left:4px solid #4C945E;background:#F0FDF4;padding:14px 18px;margin:14px 0">
<span style="font-size:20px;font-weight:800;color:#1C1917">The richest Coupang output on Apify: 100+ fields per product.</span>
</blockquote>

<table>
<tr>
<td colspan="5" style="padding:10px 14px;background:#4C945E;border:none;border-radius:4px 4px 0 0">
<span style="color:#FAFAF9;font-size:14px;font-weight:700;letter-spacing:0.5px">Zen Studio Marketplace Scrapers</span>
<span style="color:#E8F5E9;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Product search across Korea &amp; China's top marketplaces</span>
</td>
</tr>
<tr>
<td style="padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 0 4px;background:#E8F5E9;border-right:none;border-top:none;vertical-align:top;width:20%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-vmxh49iJNTXdWaAwE-5U1C2nq87Q-coupang-review-scraper-logo.png" width="24" height="24" style="display:inline-block;vertical-align:middle;width:22px;height:22px"> &nbsp;<a href="https://apify.com/zen-studio/coupang-detail-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Coupang Detail</a><br>
<span style="color:#78716C;font-size:12px">Specs, options, sellers</span>
</td>
<td style="padding:12px 16px;border:1px solid #E7E5E4;background:#D3EDD9;border-right:none;border-top:none;vertical-align:top;width:20%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-vmxh49iJNTXdWaAwE-5U1C2nq87Q-coupang-review-scraper-logo.png" width="24" height="24" style="display:inline-block;vertical-align:middle;width:22px;height:22px"> &nbsp;<a href="https://apify.com/zen-studio/coupang-search-scraper" style="color:#4C945E;text-decoration:none;font-weight:700;font-size:14px">Coupang Search</a><br>
<span style="color:#4C945E;font-size:12px;font-weight:600">&#10148; You are here</span>
</td>
<td style="background:#E8F5E9;padding:12px 16px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:20%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-0hS9yNh3RU8DC6puG-LozxRJkdHN-coupang-review-scraper-logo.png" width="24" height="24" style="display:inline-block;vertical-align:middle;width:22px;height:22px"> &nbsp;<a href="https://apify.com/zen-studio/coupang-review-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Coupang Review</a><br>
<span style="color:#78716C;font-size:12px">Reviews, photos, ratings</span>
</td>
<td style="background:#E8F5E9;padding:12px 16px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:20%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="24" height="24" style="display:inline-block;vertical-align:middle;width:22px;height:22px"> &nbsp;<a href="https://apify.com/zen-studio/jd-com-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">JD.com Search</a><br>
<span style="color:#78716C;font-size:12px">Prices, specs, reviews</span>
</td>
<td style="background:#E8F5E9;padding:12px 16px;border:1px solid #E7E5E4;border-radius:0 0 4px 0;border-top:none;vertical-align:top;width:20%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="24" height="24" style="display:inline-block;vertical-align:middle;width:22px;height:22px"> &nbsp;<a href="https://apify.com/zen-studio/taobao-search-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:14px">Taobao Search</a><br>
<span style="color:#78716C;font-size:12px">Prices, SKUs, reviews</span>
</td>
</tr>
</table>

### Key Features

- **100+ fields per product**: name, price, rating, review count, images, options, delivery, seller, breadcrumbs, and rich attributes, captured automatically.
- **Product detail on by default**: an optional nested `detail` object adds full specifications, certifications, return policy, and selling points.
- **Break the page limit**: keyword fan-out collects far more than a single results page, deduplicated by product.
- **Filters that matter**: price range, minimum rating, condition, rocket delivery, and brand.
- **Free tier**: 10 runs, 1 keyword and about 90 products per run.

### How to Scrape Coupang Product Data

#### Basic: one keyword

```json
{
    "keywords": ["laptop"]
}
````

#### Korean keyword with a product cap

```json
{
    "keywords": ["노트북"],
    "maxProductsPerKeyword": 200
}
```

#### Several keywords, detail off for a faster, cheaper run

```json
{
    "keywords": ["laptop", "mouse", "keyboard"],
    "maxProductsPerKeyword": 100,
    "includeDetail": false
}
```

#### Full catalogue for one keyword

```json
{
    "keywords": ["기계식 키보드"],
    "maxProductsPerKeyword": 0
}
```

Set `maxProductsPerKeyword` to `0` to collect the full available catalogue for a keyword. Values from 1 to 9 are treated as 10.

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `keywords` | array | *required* | Search terms. Korean or English. One dataset section per keyword. |
| `maxProductsPerKeyword` | integer | `100` | Target products per keyword. `0` collects the full catalogue. |
| `includeDetail` | boolean | `true` | Add the nested `detail` object per product (specs, options, pricing, seller, delivery, certifications). |
| `sortBy` | string | `relevance` | `relevance`, `bestSelling`, `priceLow`, or `priceHigh`. |
| `minPrice` | integer | *none* | Minimum price in KRW. |
| `maxPrice` | integer | *none* | Maximum price in KRW. |
| `minRating` | string | *none* | Minimum star rating filter. |
| `offerCondition` | string | *none* | Product condition, for example `USED`. |
| `rocketDeliveryOnly` | boolean | `false` | Keep only rocket delivery products. |
| `brandIds` | array | *none* | Restrict to specific brands. |

### What Data Can You Extract from Coupang?

Every product row includes the three identifiers (`productId`, `itemId`, `vendorItemId`), name, price, rating, review count, image, and URL, plus the full set of attributes Coupang exposes for that product.

When `includeDetail` is on (the default), each row also carries a nested `detail` object: specifications, options, pricing breakdown, delivery, seller, breadcrumbs, certifications, return policy, and selling points.

#### Output Example

```json
// one product with includeDetail on. Every key/value is shown; only long
// arrays and the ~50-field discount matrix are trimmed for readability.
{
  "productId": "6126155781",
  "itemId": "11648349573",
  "vendorItemId": "78922805094",
  "name": "레이저 DeathAdder Essential 유선마우스, RZ01-0385, Black",
  "price": 25900,
  "currency": "KRW",
  "ratingAverage": 5,
  "ratingCount": 5227,
  "image": "https://thumbnail.coupangcdn.com/thumbnails/remote/492x492ex/image/…",
  "url": "https://www.coupang.com/vp/products/6126155781?itemId=11648349573&vendorItemId=78922805094",
  "keyword": "mouse",
  "detail": {
    "core": {
      "finalPrice": "25,900",
      "salePrice": "25,900",
      "couponPrice": "25,900",
      "originPrice": null,
      "discountRate": null,
      "wowMemberPrice": { "price": 25900, "priceWithDeliveryFee": 25900 },
      "nonWowMemberPrice": { "price": 25900, "priceWithDeliveryFee": 25900 },
      "sellerName": null,
      "breadcrumbs": ["쿠팡수입", "가전디지털", "키보드/마우스", "마우스", "유선마우스"],
      "deliveryInfo": { "nonMemberDelivery": { "…": "…" }, "wowMemberDelivery": { "…": "…" } },
      "optionRows": [
        { "name": "모델명/품번", "attributes": [{ "name": "RZ01-0385", "selected": true }] },
        { "name": "색상", "attributes": [{ "name": "Black", "selected": true }, { "name": "화이트", "selected": false }] }
      ]
      // + ~50 more coupon / instant / WOW-member pricing fields
    },
    "specs": [
      { "title": "품명 및 모델명", "description": "레이저 DeathAdder Essential 유선마우스 RZ01-0385" },
      { "title": "KC 인증정보", "description": "R-R-RAZ-RZ01-0385" },
      { "title": "출시년월", "description": "2021.9" },
      { "title": "제조국", "description": "중국, 태국" },
      { "title": "A/S 책임자와 전화번호", "description": "Razer(레이져) AS센터 070-8803-3310" }
      // … +6 more spec rows
    ],
    "certifications": [
      { "certificationNo": "R-R-RAZ-RZ01-0385", "name": "방송통신기자재 적합성 평가 대상" }
    ],
    "detailBlocks": [ "… 3 rich HTML / image description blocks" ],
    "returnPolicy": { "…": "delivery notice, return notice, seller info, return policy (9 keys)" },
    "sellingPoints": []
  }
}
```

Export as JSON, CSV, Excel, XML, or HTML from the run's Storage tab, or through the Apify API.

### Getting Coupang Reviews

This actor gives you every product's `productId` and `url`. Feed those to the **Coupang Review Scraper** to collect the review bodies, ratings, and buyer details.

1. Run this actor on your keyword and open the dataset.
2. Take the `productId` (or `url`) column.
3. Run the [Coupang Review Scraper](https://apify.com/zen-studio/coupang-review-scraper) on those product IDs.

Search finds the products; the Review Scraper reads what buyers said about them.

### Advanced Usage

Ready-made configurations for price-tier research, competitor tracking, used-market sweeps, and brand catalogues.

#### Budget segment under 300,000 KRW

```json
{
    "keywords": ["노트북"],
    "maxPrice": 300000,
    "sortBy": "priceLow"
}
```

#### Rocket delivery, top rated only

```json
{
    "keywords": ["무선 이어폰"],
    "rocketDeliveryOnly": true,
    "minRating": "4"
}
```

#### Used-condition sweep

```json
{
    "keywords": ["아이폰"],
    "offerCondition": "USED",
    "maxProductsPerKeyword": 300
}
```

### Pricing: Pay Per Event (PPE)

**$4.99 per 1,000 products** on the Free and Bronze plans. Silver is $4.29 and Gold is $3.99 per 1,000. Product detail enrichment adds **$2.99 per 1,000** products.

| What you pay for | Per 1,000 products |
|------------------|--------------------|
| Products scraped | $4.99 (Silver $4.29, Gold $3.99) |
| Product detail enrichment | $2.99 |

A minimum of 10 results is billed per keyword. A keyword that returns fewer than 10 products is still billed as 10.

Free tier: 10 runs, 1 keyword and about 90 products per run, with detail on.

### FAQ

**What is Coupang (쿠팡)?**
Coupang is South Korea's largest online marketplace, known for its Rocket Delivery service. This actor searches Coupang by keyword and returns structured product data, with optional deep product detail.

**How many products can I extract?**
As many as a keyword offers. Set `maxProductsPerKeyword` to your target, or `0` for the full catalogue. The keyword fan-out collects well beyond a single results page.

**How fresh is the data?**
Every run fetches live data from Coupang at request time. There is no cache.

**Do I need a Coupang account or cookies?**
No. Provide a keyword and run. No account, login, or cookie export is involved.

**Can I also get product reviews?**
Yes, with the companion actor. This actor outputs each product's `productId` and `url`; run the [Coupang Review Scraper](https://apify.com/zen-studio/coupang-review-scraper) on those to collect review text, ratings, and buyer details.

**Can I search in Korean?**
Yes. Korean and English keywords both work, for example `노트북` or `laptop`.

**How do I export the data?**
Download JSON, CSV, Excel, XML, or HTML from the run's Storage tab, or pull results through the Apify API. JSON preserves the nested `detail` object best.

**What is the free tier?**
10 runs total. Each free run covers 1 keyword and about 90 products, with detail enrichment on.

**Is it legal to scrape Coupang product data?**
This actor collects publicly visible product data only, nothing behind a login. You are responsible for complying with Coupang's terms of service and applicable data protection law, including Korea's PIPA and, where relevant, GDPR or CCPA.

### More Zen Studio scrapers for Asian platforms

**🛒 E-commerce**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-0hS9yNh3RU8DC6puG-LozxRJkdHN-coupang-review-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Coupang 쿠팡**
  - [Coupang Review Scraper](https://apify.com/zen-studio/coupang-review-scraper)
  - [Coupang Product Detail Scraper](https://apify.com/zen-studio/coupang-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-PsAKYWM55HG4AHXjK-ItywU7Bp0s-taobao-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Taobao 淘宝**
  - [Taobao Search Scraper](https://apify.com/zen-studio/taobao-search-scraper)
  - [Taobao Product Detail Scraper](https://apify.com/zen-studio/taobao-detail-scraper)
  - [Taobao Seller Products Scraper](https://apify.com/zen-studio/taobao-seller-products-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-uZy6tbKLKnSVtT4BN-emXnT123uR-jd-com-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **JD.com 京东**
  - [JD.com Search Scraper](https://apify.com/zen-studio/jd-com-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ghXSMZcW3GxsCrkiR-5hnvsKv4Yt-1688-wholesale-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **1688 阿里巴巴**
  - [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper)
  - [Alibaba Scraper](https://apify.com/zen-studio/alibaba-scraper)
  - [1688 Reviews Scraper](https://apify.com/zen-studio/1688-reviews-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-5QcLc4BHaLMBUKYs3-f3CWQ60Row-goofish-search-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Goofish 闲鱼**
  - [Goofish (Xianyu) Search Scraper](https://apify.com/zen-studio/goofish-xianyu-search-scraper)
  - [Goofish (Xianyu) Seller Scraper](https://apify.com/zen-studio/goofish-xianyu-seller-scraper)
  - [Goofish (Xianyu) Item Detail Scraper](https://apify.com/zen-studio/goofish-xianyu-item-detail-scraper)
  - [Goofish (Xianyu) Item Comments & Q\&A Scraper](https://apify.com/zen-studio/goofish-xianyu-item-comments-scraper)
  - [Goofish (Xianyu) Reverse Image Search Scraper](https://apify.com/zen-studio/goofish-xianyu-visual-search-scraper)

**🎬 Short-video & social**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-3TJaaOJDU1AMiOoJM-Vu2eVr0P6N-douyin-profile-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Douyin 抖音**
  - [Douyin Search Scraper](https://apify.com/zen-studio/douyin-search-scraper)
  - [Douyin Profile Scraper](https://apify.com/zen-studio/douyin-profile-scraper)
  - [Douyin Video Scraper](https://apify.com/zen-studio/douyin-video-scraper)
  - [Douyin Comments Scraper](https://apify.com/zen-studio/douyin-comments-scraper)
  - [Douyin Transcripts Scraper](https://apify.com/zen-studio/douyin-transcripts-scraper)
  - [Douyin Creator Rankings Scraper](https://apify.com/zen-studio/douyin-xingtu-rankings-scraper)
  - [Douyin Live Recorder](https://apify.com/zen-studio/douyin-live-recorder)
  - [Douyin Hot Search Scraper](https://apify.com/zen-studio/douyin-hot-search-scraper)
  - [Douyin Product Search Scraper](https://apify.com/zen-studio/douyin-product-search-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-mHKEEgoDqr6btQQer-fUs5ZquIeN-xiaohongshu-search-scraper-logo-square.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **RedNote 小红书**
  - [RedNote User Profile Scraper](https://apify.com/zen-studio/rednote-user-profile-scraper)
  - [RedNote Search Scraper](https://apify.com/zen-studio/rednote-search-scraper)
  - [RedNote Comments Scraper](https://apify.com/zen-studio/rednote-comments-scraper)
  - [RedNote Product Search Scraper](https://apify.com/zen-studio/rednote-product-search-scraper)
  - [RedNote Note Detail Scraper](https://apify.com/zen-studio/rednote-note-detail-scraper)
  - [RedNote Product Reviews Scraper](https://apify.com/zen-studio/rednote-product-reviews-scraper)
  - [RedNote Live Recorder](https://apify.com/zen-studio/rednote-live-recorder)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-dexCSKEZtKS8hg4fT-lD4weyiYga-shigua-____-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Xigua 西瓜视频**
  - [Xigua Video Search Scraper](https://apify.com/zen-studio/xigua-video-search-scraper)
  - [Xigua Video Detail Scraper](https://apify.com/zen-studio/xigua-video-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-oSxuPDE1h3HAsHZSu-x3uV98mgTe-bilibili-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Bilibili 哔哩哔哩**
  - [Bilibili Video Scraper](https://apify.com/zen-studio/bilibili-video-scraper)
  - [Bilibili Danmaku Scraper](https://apify.com/zen-studio/bilibili-danmaku-scraper)

**🏠 Real estate & autos**

- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-1tAzNSf8Kz0v7Q2Lr-AINJ7FsZVU-anjuke-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Anjuke 安居客**
  - [Anjuke For-Sale Listings Scraper](https://apify.com/zen-studio/anjuke-real-estate-scraper)
  - [Anjuke New-Home Scraper](https://apify.com/zen-studio/anjuke-new-home-scraper)
  - [Anjuke Rental Listings Scraper](https://apify.com/zen-studio/anjuke-rent-scraper)
  - [Anjuke Listing Detail Scraper](https://apify.com/zen-studio/anjuke-sale-detail-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-32OkWqsiUywoq2ci3-7JhFlW1qg3-58__-real-estate-scraper-logo.jpg" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **58.com 58同城**
  - [58.com Real Estate Scraper](https://apify.com/zen-studio/58-real-estate-scraper)
- <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-ytaE4YpSmjXDmibPv-L1UMPHa2bO-che168-autohome-scraper-logo.png" width="16" height="16" style="vertical-align:middle;border-radius:3px"> **Autohome 汽车之家**
  - [Autohome (Che168) Used-Car Scraper](https://apify.com/zen-studio/che168-car-scraper)

### Support

- **Bugs**: Issues tab
- **Features**: Issues tab

### Legal Compliance

Extracts publicly available data. Users must comply with Coupang terms and data protection regulations (Korea PIPA, GDPR, CCPA).

***

*Search Coupang by keyword and export structured product data with deep detail, ready to pair with the Coupang Review Scraper.*

# Actor input Schema

## `keywords` (type: `array`):

Add one or more search terms (max 10 per run). Keywords are processed in parallel; each can take a few minutes with enrichment on. Split larger lists across runs. Korean and English both work; Korean matches Coupang's own catalogue best.<br><br>Examples: <code>laptop</code>, <code>무선 마우스</code>

## `maxProductsPerKeyword` (type: `integer`):

Target number of unique products to collect per keyword.<br><br>Coupang only shows a shallow window to logged-out visitors, so a higher number means more work behind the scenes and higher cost. Keep it low for a quick sample; set <code>0</code> to pull the <b>full catalogue</b> for a keyword (can be thousands, slow and costly).<br><br>A minimum of <b>10 results per keyword</b> applies (smaller values are treated as 10).

## `includeDetail` (type: `boolean`):

<b>On by default.</b> For every product found, also collect its product page: options/variants, coupon and member pricing, seller, delivery, breadcrumbs, specifications, certifications and a rating summary (average + count).<br><br>This adds a couple of extra fetches per product, so run time and cost scale with the number of products. Turn it <b>off</b> for a fast, cheap listing-only run.<br><br>Individual customer reviews are <b>not</b> included here; use the Coupang Review Scraper for those.

## `sortBy` (type: `string`):

Ordering of the returned products. Does not change how many are found, only their order.

## `minPrice` (type: `integer`):

Only products priced at or above this amount, in Korean won.

## `maxPrice` (type: `integer`):

Only products priced at or below this amount, in Korean won.

## `minRating` (type: `string`):

Only products with at least this average star rating.

## `offerCondition` (type: `string`):

Restrict to a specific condition. Leave empty for all conditions.

## `rocketDeliveryOnly` (type: `boolean`):

Only products eligible for Coupang Rocket delivery.

## `brandIds` (type: `array`):

Advanced. Restrict to specific brands by their Coupang brand ID (e.g. <code>258</code> = Samsung). Multiple IDs are combined as a union. Leave empty for all brands.

## Actor input object example

```json
{
  "keywords": [
    "laptop"
  ],
  "maxProductsPerKeyword": 100,
  "includeDetail": true,
  "sortBy": "relevance",
  "rocketDeliveryOnly": false
}
```

# Actor output Schema

## `products` (type: `string`):

Coupang search-result products. Each row is one product with its identifiers, price, rating, images, and (when enrichment is on) a nested `detail` object with specifications, options, pricing, seller, delivery, and certifications.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "laptop"
    ],
    "maxProductsPerKeyword": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["laptop"],
    "maxProductsPerKeyword": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/coupang-search-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 '{
  "keywords": [
    "laptop"
  ],
  "maxProductsPerKeyword": 100
}' |
apify call zen-studio/coupang-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=zen-studio/coupang-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Coupang Search Scraper (쿠팡) - Products, Prices & Specs",
        "description": "Scrape Coupang (쿠팡) products by keyword: prices, ratings, options, seller, delivery, specs, and certifications. Export thousands to JSON, CSV, or Excel. Korean or English keywords, no login needed. Each product includes the IDs to pull its reviews.",
        "version": "0.0",
        "x-build-id": "k88EfvJf0XOsHeEXD"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/zen-studio~coupang-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-zen-studio-coupang-search-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/zen-studio~coupang-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-zen-studio-coupang-search-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/zen-studio~coupang-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-zen-studio-coupang-search-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": [
                    "keywords"
                ],
                "properties": {
                    "keywords": {
                        "title": "Search keywords",
                        "maxItems": 10,
                        "type": "array",
                        "description": "Add one or more search terms (max 10 per run). Keywords are processed in parallel; each can take a few minutes with enrichment on. Split larger lists across runs. Korean and English both work; Korean matches Coupang's own catalogue best.<br><br>Examples: <code>laptop</code>, <code>무선 마우스</code>",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxProductsPerKeyword": {
                        "title": "Max products per keyword",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Target number of unique products to collect per keyword.<br><br>Coupang only shows a shallow window to logged-out visitors, so a higher number means more work behind the scenes and higher cost. Keep it low for a quick sample; set <code>0</code> to pull the <b>full catalogue</b> for a keyword (can be thousands, slow and costly).<br><br>A minimum of <b>10 results per keyword</b> applies (smaller values are treated as 10).",
                        "default": 100
                    },
                    "includeDetail": {
                        "title": "Enrich each product with full detail",
                        "type": "boolean",
                        "description": "<b>On by default.</b> For every product found, also collect its product page: options/variants, coupon and member pricing, seller, delivery, breadcrumbs, specifications, certifications and a rating summary (average + count).<br><br>This adds a couple of extra fetches per product, so run time and cost scale with the number of products. Turn it <b>off</b> for a fast, cheap listing-only run.<br><br>Individual customer reviews are <b>not</b> included here; use the Coupang Review Scraper for those.",
                        "default": true
                    },
                    "sortBy": {
                        "title": "Sort results by",
                        "enum": [
                            "relevance",
                            "bestSelling",
                            "priceLow",
                            "priceHigh"
                        ],
                        "type": "string",
                        "description": "Ordering of the returned products. Does not change how many are found, only their order.",
                        "default": "relevance"
                    },
                    "minPrice": {
                        "title": "Min price (KRW)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only products priced at or above this amount, in Korean won."
                    },
                    "maxPrice": {
                        "title": "Max price (KRW)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only products priced at or below this amount, in Korean won."
                    },
                    "minRating": {
                        "title": "Minimum rating",
                        "enum": [
                            "4",
                            "3",
                            "2"
                        ],
                        "type": "string",
                        "description": "Only products with at least this average star rating."
                    },
                    "offerCondition": {
                        "title": "Item condition",
                        "enum": [
                            "NEW",
                            "USED",
                            "REFURBISHED",
                            "RETURN",
                            "PACKAGE_DAMAGED",
                            "REPACKAGING"
                        ],
                        "type": "string",
                        "description": "Restrict to a specific condition. Leave empty for all conditions."
                    },
                    "rocketDeliveryOnly": {
                        "title": "Rocket delivery only",
                        "type": "boolean",
                        "description": "Only products eligible for Coupang Rocket delivery.",
                        "default": false
                    },
                    "brandIds": {
                        "title": "Brand IDs",
                        "type": "array",
                        "description": "Advanced. Restrict to specific brands by their Coupang brand ID (e.g. <code>258</code> = Samsung). Multiple IDs are combined as a union. Leave empty for all brands.",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```