# Coupang Reviews Scraper (`delicious_zebu/coupang-reviews-scraper`) Actor

Scrape Coupang product reviews at scale: rating, text, photos and videos, buyer survey (size/color fit), helpful votes, verified-buyer and reviewer badges, plus a per-product rating and survey summary. URL or product ID input, with sorting, star and keyword filters.

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

## Pricing

from $2.50 / 1,000 content reviews

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 Reviews Scraper do?

Coupang Reviews Scraper extracts user reviews from any product on [Coupang](https://www.coupang.com), Korea's largest online marketplace. Give it a product page URL (or just the product ID) and it returns clean, structured JSON for every review — star rating, title, text, photos and videos, the **buyer survey** (height, size fit, color accuracy), helpful votes, verified-buyer status and reviewer badges — plus a per-product **summary** with the full rating distribution and survey breakdown.

It is a fast, no-code **API alternative** for pulling Coupang review data at scale. Because it talks to Coupang's own review endpoint over plain HTTP (no headless browser), it is quick and cheap to run — ideal for product research, sentiment analysis, review monitoring, sizing/fit insights for fashion, and competitor research.

### Why use Coupang Reviews Scraper?

- **URL or ID input** — paste a full product URL (`https://www.coupang.com/vp/products/7917472694`) or just the ID (`7917472694`).
- **30+ fields per review** — rating, title, text, photos, videos (with duration and size), helpful votes (split into yes/no), replies, purchased option, and more.
- **Buyer survey** — the height, size-fit (정사이즈/작아요/커요) and color-accuracy answers real buyers leave on Coupang. Perfect for fashion & footwear sizing analysis, and something most review scrapers ignore entirely.
- **Trust & credibility signals** — verified purchaser (실구매), reviewer rank (e.g. TOP10), reviewer badges (real-name reviewer), and tester-program (체험단) flag — everything you need to weigh review authenticity.
- **Per-product summary on every row** — rating distribution with percentages, a satisfaction line, and the survey breakdown, all matching what Coupang shows on the page.
- **Filters that match the site** — sort by 베스트순 / 최신순, filter by star rating, search reviews by keyword, or keep only reviews with photos/videos.
- **Efficient** — pure HTTP, no browser, so runs are fast and low-cost.

| | This actor | Typical review scrapers |
|---|---|---|
| Buyer survey (size / color fit) | ✅ | ❌ |
| Verified-buyer + reviewer badges + tester flag | ✅ | Rarely |
| Rating distribution & survey summary per product | ✅ | Rarely |
| Photos **and** videos (with duration/size) | ✅ | Partial |
| Keyword & photo/video filters | ✅ | Sometimes |
| Pure HTTP (no browser) | ✅ | Often browser-based |

### What data can you extract?

Each item is one review. Every review also carries a `product_summary` object (described below).

| Field | Type | Description |
|---|---|---|
| `product_id` | number | Coupang product ID |
| `product_url` | link | Product detail page URL |
| `review_id` | number | Review ID |
| `rating` | number | Star rating (1–5) |
| `title` | text | Review title (often empty) |
| `content` | text | Review text (empty for star-only reviews) |
| `review_date` | date | Date the review was written |
| `item_name` | text | Exact purchased option (e.g. color, size) |
| `writer_name` | text | Reviewer display name |
| `is_real_buyer` | boolean | Verified Coupang purchaser (쿠팡 실구매) |
| `helpful_count` | number | Total helpful votes |
| `helpful_true_count` | number | "Helpful" votes |
| `helpful_false_count` | number | "Not helpful" votes |
| `comment_count` | number | Replies to the review |
| `images` | array | Review photo URLs (full size) |
| `image_thumbnails` | array | Review photo thumbnail URLs |
| `videos` | array | Review videos (url, thumbnail, duration, width, height) |
| `has_image` | boolean | Whether the review has a photo |
| `has_video` | boolean | Whether the review has a video |
| `survey` | object | Buyer survey answers (height, size fit, color accuracy …) |
| `reviewer_rank` | text | Reviewer rank (e.g. TOP10), when present |
| `reviewer_badges` | array | Reviewer badges (e.g. 실명리뷰어 real-name reviewer) |
| `is_adventurer` | boolean | Tester-program (체험단) review |
| `writer_email` | text | Reviewer email, already masked by Coupang |
| `vendor_name` | text | Seller name |
| `created_at` | date | Review creation date |
| `item_id` | text | Item ID of the purchased option |
| `vendor_item_id` | text | Vendor item ID |
| `item_image` | image | Purchased option image |
| `product_summary` | object | Per-product summary (see Output) |

The `product_summary` object holds: `total_count`, `rating_average`, `satisfaction_text` (e.g. `400명 이상 만족했어요`), `rating_distribution` (1–5 stars with counts and %), `total_image_count`, `total_video_count`, `survey_summary` (each survey question broken down by answer, in the same order Coupang shows), and `survey_highlight` (the top answer per question).

### How to scrape Coupang reviews

1. Open the product you want on [Coupang](https://www.coupang.com) and copy the page URL, e.g. `https://www.coupang.com/vp/products/7917472694`.
2. Paste one or more product URLs into **Coupang product URLs or IDs**, one per line. A bare product ID works too.
3. Optionally set **Max reviews per product**, **Sort by**, **Star rating**, **Keyword**, or **Photos/videos only**.
4. Click **Start** and watch reviews stream in, one clean record each.
5. Download the results as JSON, CSV, or Excel when the run finishes.

### How much does it cost?

You only pay for **content reviews** — reviews that actually have text, a photo, or a video. Plain star-only reviews (very common on Coupang) are delivered too, but **free of charge**. Because the actor uses plain HTTP instead of a headless browser, it consumes very little compute, keeping runs fast and cheap. 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 product URLs or IDs** (`productUrls`) — product page URLs or product IDs, one per line. Required.
- **Max reviews per product** (`maxReviews`) — cap per product; set `0` for all reviews. Default `100`.
- **Sort by** (`sortBy`) — `베스트순 (Most helpful)` or `최신순 (Newest)`.
- **Star rating** (`rating`) — keep only one star rating (Coupang allows a single rating at a time).
- **Keyword search** (`keyword`) — only reviews whose text contains the keyword (Korean works best).
- **Photos/videos only** (`mediaOnly`) — keep only reviews with a photo or video.

### Output

Each item is one review, with the product-level `product_summary` attached. Example (real data, some fields shortened):

```json
{
  "product_id": 7917472694,
  "product_url": "https://www.coupang.com/vp/products/7917472694",
  "review_id": 867103258,
  "rating": 5,
  "title": "그레힙~~~",
  "content": "그레힙은 믿고입습니다\n냉가이너로 봄, 여름, 가을 편하게 입기좋아요 ...",
  "review_date": "2026-03-28",
  "item_name": "그레힙 여성 골프 티셔츠 이너 기능성 쿨링 자외선차단 이너웨어, M, 화이트, M",
  "writer_name": "에스프레소",
  "is_real_buyer": true,
  "helpful_count": 12,
  "helpful_true_count": 10,
  "helpful_false_count": 2,
  "comment_count": 0,
  "images": ["https://thumbnail.coupangcdn.com/thumbnails/local/q-1/image2/PRODUCTREVIEW/.../c46ed9a4....jpg"],
  "image_thumbnails": ["https://thumbnail.coupangcdn.com/thumbnails/local/320/image2/PRODUCTREVIEW/.../c46ed9a4....jpg"],
  "videos": [],                       // e.g. [{ "url": "...m3u8", "thumbnail": "...jpg", "duration": "0:08", "width": 480, "height": 396 }]
  "has_image": true,
  "has_video": false,
  "survey": { "키": "162", "색상": "화면과 같아요", "사이즈": "정사이즈예요" },
  "reviewer_rank": "",                // e.g. "TOP10" — empty for most reviewers
  "reviewer_badges": [],             // e.g. [{ "reviewerBadgeType": "REAL_NAME_REVIEWER", "badgeTitle": "실명리뷰어" }]
  "is_adventurer": false,
  "writer_email": "amp*****@naver.com",   // masked by Coupang
  "vendor_name": "디앤비 (D&B)",
  "created_at": "2026-03-28",
  "item_id": "21741896777",
  "vendor_item_id": "88791004100",
  "item_image": "https://thumbnail.coupangcdn.com/thumbnails/remote/640x640/image/vendor_inventory/....jpg",
  "product_summary": {
    "total_count": 503,
    "rating_average": 4.5,
    "satisfaction_text": "400명 이상 만족했어요",
    "rating_distribution": [
      { "rating": 5, "count": 347, "percentage": "71%" },
      { "rating": 4, "count": 91, "percentage": "18%" },
      { "rating": 3, "count": 34, "percentage": "6%" },
      { "rating": 2, "count": 10, "percentage": "1%" },
      { "rating": 1, "count": 21, "percentage": "4%" }
    ],
    "total_image_count": 5,
    "total_video_count": 0,
    "survey_summary": {
      "사이즈": {
        "생각보다 작아요": { "count": 12, "percentage": "14%" },
        "정사이즈예요": { "count": 66, "percentage": "80%" },
        "생각보다 커요": { "count": 5, "percentage": "6%" }
      },
      "색상": {
        "화면과 비슷해요": { "count": 20, "percentage": "27%" },
        "화면과 같아요": { "count": 52, "percentage": "70%" },
        "화면과 달라요": { "count": 2, "percentage": "3%" }
      }
    },
    "survey_highlight": { "사이즈": "정사이즈예요 80%", "색상": "화면과 같아요 70%" }
  }
}
```

### Tips

- **Filters are one at a time** — if you set a **Keyword**, it takes priority (star rating and photos/videos-only are ignored); otherwise **Photos/videos only** takes priority over **Star rating**. This mirrors how Coupang's own review UI works.
- **Star rating is single-select** — Coupang lets you filter by one rating at a time (e.g. only 5-star), so this actor does the same. To combine ratings, run the product once per rating.
- **Many reviews are star-only** — a large share of Coupang reviews have no text, photo, or video (Koreans often just tap a rating). They are still returned, and they are free — you only pay for content reviews.
- **The buyer survey varies by product** — clothing and shoes usually have 사이즈 (size fit) and 색상 (color accuracy); other categories may have none.
- **Masked contact data** — `writer_name` and `writer_email` are already masked by Coupang (e.g. `amp*****@naver.com`); they cannot be used to contact anyone.
- 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 reviews legal?** This actor collects only publicly available review data that Coupang displays on each product page. Reviewer names and emails are already masked by Coupang. You are responsible for how you use the data — comply with Coupang's terms, applicable laws, and GDPR/PIPA where relevant, and do not use the data to identify, contact, or profile individuals.

**Which language are the reviews in?** Coupang is a Korean marketplace, so review text, survey answers, and badges are in Korean.

**How many reviews can I get per product?** Set **Max reviews per product** to `0` for everything. Coupang exposes up to a few thousand reviews per product through its review pages.

**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

## `productUrls` (type: `array`):

Coupang products to scrape reviews from. Paste the full product URL (e.g. https://www.coupang.com/vp/products/7917472694) or just the product ID (e.g. 7917472694). One per line.

## `maxReviews` (type: `integer`):

How many reviews to scrape per product. Set 0 to scrape every review the product has. Default is 100.

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

Order of the reviews, matching Coupang's own review sort dropdown. Ignored when a Keyword is set (keyword search returns by relevance).

## `rating` (type: `string`):

Keep only reviews with this exact star rating, matching Coupang's review rating filter (Coupang allows only one rating at a time). Ignored when Keyword or Photos/videos only is set.

## `keyword` (type: `string`):

Only return reviews whose text contains this keyword (Korean works best). Takes priority over Star rating and Photos/videos only. Leave empty to skip.

## `mediaOnly` (type: `boolean`):

Only scrape reviews that include a photo or video. Ignored when a Keyword is set.

## Actor input object example

```json
{
  "productUrls": [
    "https://www.coupang.com/vp/products/7917472694",
    "8202544905"
  ],
  "maxReviews": 100,
  "sortBy": "best",
  "rating": "0",
  "keyword": "시원",
  "mediaOnly": false
}
```

# Actor output Schema

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

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

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

All Coupang review 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 = {
    "productUrls": [
        "https://www.coupang.com/vp/products/7917472694?itemId=21741896783&vendorItemId=89882260686",
        "https://www.coupang.com/vp/products/1912642276?itemId=6526770041&vendorItemId=92516830254",
        "https://www.coupang.com/vp/products/8202544905?itemId=20106538968&vendorItemId=3000043960",
        "https://www.coupang.com/vp/products/8596103075?itemId=48878020&vendorItemId=3000580595"
    ],
    "maxReviews": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("delicious_zebu/coupang-reviews-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 = {
    "productUrls": [
        "https://www.coupang.com/vp/products/7917472694?itemId=21741896783&vendorItemId=89882260686",
        "https://www.coupang.com/vp/products/1912642276?itemId=6526770041&vendorItemId=92516830254",
        "https://www.coupang.com/vp/products/8202544905?itemId=20106538968&vendorItemId=3000043960",
        "https://www.coupang.com/vp/products/8596103075?itemId=48878020&vendorItemId=3000580595",
    ],
    "maxReviews": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("delicious_zebu/coupang-reviews-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 '{
  "productUrls": [
    "https://www.coupang.com/vp/products/7917472694?itemId=21741896783&vendorItemId=89882260686",
    "https://www.coupang.com/vp/products/1912642276?itemId=6526770041&vendorItemId=92516830254",
    "https://www.coupang.com/vp/products/8202544905?itemId=20106538968&vendorItemId=3000043960",
    "https://www.coupang.com/vp/products/8596103075?itemId=48878020&vendorItemId=3000580595"
  ],
  "maxReviews": 100
}' |
apify call delicious_zebu/coupang-reviews-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,delicious_zebu/coupang-reviews-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 <APIFY_API_TOKEN>` 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/xDOeJQ1B98Wiw1ArS/builds/gKtaNPr3OjVlOtxFr/openapi.json