# Coupang Category Products Scraper (`delicious_zebu/coupang-category-products-scraper`) Actor

Scrape every product from any Coupang category page by URL or category ID, with sorting, rating, price and delivery filters.

- **URL**: https://apify.com/delicious\_zebu/coupang-category-products-scraper.md
- **Developed by:** [ВAH](https://apify.com/delicious_zebu) (community)
- **Categories:** E-commerce, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.49 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#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

### What does Coupang Category Products Scraper do?

Coupang Category Products Scraper extracts every product from any category page on [Coupang](https://www.coupang.com), Korea's largest online marketplace. Give it a category page URL (or just a category ID) and it returns clean, structured JSON for each product — title, sale and original price, discount, rating, delivery type, cashback, and more.

It is a fast, no-code **API alternative** for pulling Coupang catalog data at scale. Because it talks to Coupang's own list endpoint over plain HTTP (no headless browser), it is quick and cheap to run, which makes it a good fit for price monitoring, catalog research, and competitive analysis.

### Why use Coupang Category Products Scraper?

- **Two ways to input a category** — paste the full category URL (`https://www.coupang.com/np/categories/498704`) or just the ID (`498704`). Mix and match as many as you like.
- **Coupang's own filters, built in** — sort, minimum rating, price range, and delivery type (로켓배송 / 로켓직구 / 무료배송 / 탑 브랜드), named exactly as they appear on Coupang.
- **Page control** — set how many pages to scrape per category (up to ~120 products per page).
- **Rich, clean fields** — 27 fields per product, ready to use with no post-processing.
- **Efficient** — pure HTTP, no browser, so runs are fast and low-cost.

| | This actor | Typical Coupang scrapers |
|---|---|---|
| Input by category URL **and** ID | ✅ | Sometimes |
| Coupang-matched delivery filter | ✅ | Rarely |
| Sort + rating + price filters | ✅ | Sometimes |
| Pure HTTP (no browser) | ✅ | Often browser-based |

### What data can you extract?

Each product is returned with these fields:

| Field | Type | Description |
|---|---|---|
| `title` | text | Product title |
| `url` | link | Product detail page URL |
| `image_url` | image | Main product image |
| `sale_price` | number | Current price (₩) |
| `origin_price` | number | Original price before discount (₩) |
| `discount_rate` | number | Discount percentage |
| `discount_type` | text | Discount label (할인 / 쿠폰할인 / R.LUX혜택) |
| `currency` | text | Currency code (KRW) |
| `unit_price` | number | Price per unit, when shown |
| `unit` | text | Unit for the unit price (e.g. 100g, 1개) |
| `rating` | number | Average rating (0–5) |
| `rating_count` | number | Number of reviews |
| `brand` | text | Brand name (luxury / R.LUX items) |
| `delivery` | text | Delivery promise text (e.g. 내일(일) 도착 보장) |
| `badges` | array | Delivery badges (ROCKET\_MERCHANT, TOMORROW, …) |
| `is_free_shipping` | boolean | Whether shipping is free |
| `free_ship_over` | number | Free-shipping threshold (₩) |
| `cashback` | text | Cashback reward text |
| `condition` | text | Item condition (새 상품 / 반품 …), for resale items |
| `is_global` | boolean | Overseas direct purchase (해외직구 / Rocket Direct) |
| `is_ad` | boolean | Sponsored ad slot |
| `is_soldout` | boolean | Sold out |
| `rank` | number | Position within the category list |
| `category_id` | text | Source category ID |
| `product_id` | text | Coupang product ID |
| `item_id` | text | Item ID |
| `vendor_item_id` | text | Vendor item ID |

### How to scrape Coupang categories

Every Coupang category has its own page, and the number in that page's URL is the **category ID**. Here is how to grab one:

1. On [Coupang](https://www.coupang.com), hover over **카테고리 (Categories)** at the top-left and pick a category — for example **패션의류/잡화 › 여성패션**. Coupang opens that category's product list page.

![How to find a Coupang category from the Categories (카테고리) menu](https://api.apify.com/v2/key-value-stores/25eaZu3cOI8P2UmgZ/records/find-category)

2. Copy the page URL from your browser, e.g. `https://www.coupang.com/np/categories/498704`. The number at the end (`498704`) is the category ID — you can paste **either the full URL or just that number** into the actor.
3. Paste one or more categories into **Coupang categories**, one per line.
4. Set **Max pages per category** (default 5) to control how many products you collect.
5. Optionally pick a **Sort by** order and add **rating**, **price**, or **delivery** filters — they mirror Coupang's own list-page controls.
6. Click **Start** and download the results as JSON, CSV, or Excel when the run finishes.

### How much does it cost?

The actor uses plain HTTP requests instead of a headless browser, so it consumes very little compute. That keeps runs fast and the per-1,000-product cost low compared with browser-based scrapers. You only pay for what you run, and you can cap usage with **Max pages per category**. New Apify accounts include free monthly usage credits to try it out.

### Input

Configure the run from the **Input** tab (or via the API). Fields:

- **Coupang categories** (`categories`) — category page URLs or IDs, one per line. Required.
- **Max pages per category** (`maxPages`) — pages to scrape per category (default 5).
- **Sort by** (`sortBy`) — 랭킹순 / 낮은가격순 / 높은가격순 / 판매량순 / 최신순.
- **Minimum rating** (`minRating`) — 전체 / 4·3·2·1 stars & up.
- **Delivery filter** (`deliveryFilter`) — All / 로켓배송 / 로켓직구 / 무료배송 / 탑 브랜드.
- **Min price** / **Max price** (`minPrice` / `maxPrice`) — price range in Korean won (₩).

### Output

Each item is one product. Example (real data, some fields shortened):

```json
{
  "category_id": "498704",
  "rank": 0,
  "product_id": "9563451975",
  "item_id": "28540099393",
  "vendor_item_id": "95484971017",
  "title": "리브루아 여성 나시 민소매 골지 나시티 3p",
  "brand": null,
  "url": "https://www.coupang.com/vp/products/9563451975?itemId=28540099393&vendorItemId=95484971017",
  "image_url": "https://thumbnail.coupangcdn.com/thumbnails/remote/230x230ex/image/...jpg",
  "sale_price": 7900,
  "origin_price": 22000,
  "discount_rate": 64,
  "discount_type": "쿠폰할인",
  "currency": "KRW",
  "unit_price": null,          // null when Coupang shows no per-unit price
  "unit": null,
  "rating": 4.5,
  "rating_count": 669,
  "badges": ["ROCKET_MERCHANT", "TOMORROW"],
  "is_global": false,
  "delivery": "내일(일) 도착 보장",
  "is_free_shipping": false,
  "free_ship_over": 19800,
  "cashback": "최대 395원 적립",
  "condition": "",            // filled only for resale / used offers
  "is_ad": false,
  "is_soldout": false
}
```

### Tips

- **Category IDs are stable** — the number in a category URL rarely changes, so you can save IDs and reuse them for scheduled runs.
- **Filters mirror Coupang** — sorting and filters map 1:1 to the controls on Coupang's list page, so results match what you'd see in the browser.
- **Delivery filter + sort** — when a delivery filter like 로켓직구 is applied, Coupang keeps the sort *direction* (low vs high price) but may not order items strictly; sort the dataset yourself if you need exact ordering.
- **Some fields are context-specific** — `brand` appears mainly on luxury (R.LUX) items, and `condition` is filled only when a product has resale/used offers, so they are often empty. This is expected.
- Schedule runs or integrate with your stack via the [Apify API](https://docs.apify.com/api/v2), [scheduler](https://docs.apify.com/platform/schedules), and [integrations](https://docs.apify.com/platform/integrations).

### FAQ and support

**Is scraping Coupang legal?** This actor collects only publicly available product listing data. You are responsible for how you use the data. Do not collect personal data, and comply with Coupang's terms and applicable laws (including GDPR where relevant). It does not collect any personal information.

**Which countries' prices does it show?** Coupang is a Korean marketplace; prices are in Korean won (₩) and reflect the Korean storefront.

**Can I scrape a search or brand page?** This actor targets category pages (`/np/categories/{id}`). For keyword search or other page types, let us know.

**Something's wrong or missing a field?** Open an issue on the actor's **Issues** tab and we'll take a look.

# Actor input Schema

## `categories` (type: `array`):

Coupang category pages to scrape. Paste the full category URL (e.g. https://www.coupang.com/np/categories/498704) or just the category ID (e.g. 498704). One per line.

## `maxPages` (type: `integer`):

How many listing pages to scrape per category (each page has up to 120 products). Default is 5. The actor never goes past a category's real last page.

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

Order of the products, matching Coupang's own sort dropdown on the category page.

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

Only keep products at or above this star rating, matching Coupang's rating filter (별점).

## `deliveryFilter` (type: `string`):

Keep only products with this delivery type, matching Coupang's delivery filter chips. Availability varies by category (e.g. some categories have no Rocket Direct items).

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

Lowest price to include, in Korean won (₩). Leave empty for no minimum.

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

Highest price to include, in Korean won (₩). Leave empty for no maximum.

## Actor input object example

```json
{
  "categories": [
    "https://www.coupang.com/np/categories/498704",
    "185792"
  ],
  "maxPages": 5,
  "sortBy": "ranking",
  "minRating": "0",
  "deliveryFilter": "",
  "minPrice": 10000,
  "maxPrice": 50000
}
```

# Actor output Schema

## `overview` (type: `string`):

Table view of scraped Coupang products using the 'overview' view from dataset\_schema.json.

## `rawResults` (type: `string`):

All Coupang product items from the default dataset without a specific view.

# 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 = {
    "categories": [
        "https://www.coupang.com/np/categories/498704"
    ],
    "maxPages": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("delicious_zebu/coupang-category-products-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "categories": ["https://www.coupang.com/np/categories/498704"],
    "maxPages": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("delicious_zebu/coupang-category-products-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "categories": [
    "https://www.coupang.com/np/categories/498704"
  ],
  "maxPages": 5
}' |
apify call delicious_zebu/coupang-category-products-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/AjZ0JCKJUaSbVK7VP/builds/nkmua1JGf9MoBS3a1/openapi.json