# Coupang Product Listings Scraper (`khadinakbar/coupang-scraper`) Actor

Get validated Coupang product listings from search terms and public Coupang search, category, and product URLs. Returns KRW prices, ratings, review counts, image URLs, Rocket flags, and source context. $0.005/product plus platform usage.

- **URL**: https://apify.com/khadinakbar/coupang-scraper.md
- **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community)
- **Categories:** E-commerce, MCP servers, Automation
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 coupang 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.

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

## Coupang Product Listings Scraper

Get structured product listings from Coupang search terms, Coupang search or category URLs, and direct product URLs or numeric IDs. It is designed for price monitoring, Korean e-commerce catalog research, assortment comparison, and identifying Rocket-delivery products.

Use this actor when you need product-level Coupang data such as a title, KRW price, price discount, rating, review count, image, product URL, and Rocket flags. It is not a customer-review scraper, a Coupang Eats scraper, an order-management tool, or a source of account-only data.

### When To Use It

- Search Korea marketplace inventory from a Korean or English keyword.
- Turn a Coupang category or search page into a product dataset.
- Refresh a known list of Coupang product IDs or product URLs.
- Track KRW prices, original prices, discounts, ratings, review counts, and delivery badges.
- Supply compact product rows to an AI agent, data pipeline, or spreadsheet workflow.

The actor uses a managed Coupang listings route and normalizes every accepted result into one stable output shape. This avoids the access-denied pages that Coupang may return to direct browser sessions, while keeping the input and output contract simple.

### Output

Each dataset item represents one validated Coupang product. Fields are consistent across search, URL, and direct-product runs.

| Field                                      | Description                                        |
| ------------------------------------------ | -------------------------------------------------- |
| `productId`                                | Coupang product ID.                                |
| `itemId` / `vendorItemId`                  | Variant identifiers when available.                |
| `title`                                    | Product title shown in the listing.                |
| `price` / `originalPrice`                  | Current and original prices in KRW.                |
| `discountPercent`                          | Listed discount percentage when available.         |
| `rating` / `reviewCount`                   | Average rating and review count.                   |
| `rocketDelivery` / `rocketFresh`           | Coupang fulfillment flags.                         |
| `isSponsored`                              | Whether the listing was marked as an ad.           |
| `availability`                             | `in_stock`, `sold_out`, or `unknown`.              |
| `imageUrl` / `productUrl`                  | Main product image and canonical product page URL. |
| `sourceType` / `sourceQuery` / `sourceUrl` | Search, category, or product provenance.           |
| `scrapedAt`                                | ISO 8601 normalization timestamp.                  |

The actor also writes `OUTPUT`, `RUN_SUMMARY`, and `LAST_RUN_SUMMARY` to the default key-value store. These records distinguish `COMPLETE`, `PARTIAL`, `VALID_EMPTY`, `INVALID_INPUT`, and honest upstream failures without placing control records in the dataset.

### Inputs

Choose one mode per run.

#### Search Keywords

Use Korean terms where possible, although English queries are accepted too.

```json
{
    "mode": "search",
    "searchQueries": ["노트북", "무선 마우스"],
    "maxResults": 50
}
```

#### Coupang URLs

Provide Coupang search, category, or product URLs. URLs from other sites are rejected with an actionable `INVALID_INPUT` result.

```json
{
    "mode": "url",
    "startUrls": [{ "url": "https://www.coupang.com/np/categories/178255" }],
    "maxResults": 25
}
```

#### Direct Product URLs Or IDs

Use known product URLs or bare numeric product IDs.

```json
{
    "mode": "product",
    "productUrls": ["https://www.coupang.com/vp/products/8499380264", "8499380264"],
    "maxResults": 2
}
```

### Pricing

This actor uses Pay per event + platform usage.

- `apify-actor-start`: $0.00005 once per run.
- `coupang-product`: $0.005 for each validated product row written to the dataset.

For example, a 50-product run has a maximum event charge of `$0.25005`, plus the platform compute and managed-source usage shown by Apify. Invalid input, empty results, rejected rows, and upstream failures do not trigger `coupang-product` charges.

### Reliability And Limits

`maxResults` is a hard maximum for rows written and billed by this actor. The default is 50, with a maximum of 1,000. Use smaller caps for a quick price check and increase them for catalog work.

The actor supports listing-level product data. It does not collect review text, product-page descriptions, seller details, or arbitrary server-side sort and filter controls. These exclusions are deliberate: the output remains reliable and cost-predictable across the supported search, URL, and product modes.

If the managed source processes valid input but finds no matching products, the run succeeds as `VALID_EMPTY`. If the upstream listing route cannot return usable data, the run fails as `UPSTREAM_FAILED` and records a diagnostic in `OUTPUT` and `RUN_SUMMARY`.

### API

```bash
curl -X POST "https://api.apify.com/v2/acts/khadinakbar~coupang-scraper/runs" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "search",
    "searchQueries": ["노트북"],
    "maxResults": 20
  }'
```

### MCP And Agent Scope

Use `khadinakbar/coupang-scraper` when an agent needs current Coupang listing rows from a keyword, a public Coupang URL, or known product identifiers. It returns one compact product record per item, including product ID, title, KRW price, rating, review count, Rocket flags, image, URL, and source context. Do not use it for review text, Coupang Eats, purchases, order history, or private-account content.

### Data Use

Use the returned data responsibly and in accordance with the requirements that apply to your workflow. Check product availability and prices again before making commercial or purchasing decisions because marketplace data changes frequently.

# Actor input Schema

## `mode` (type: `string`):

Use this when choosing a Coupang input type. Choose search for keywords, url for Coupang search/category/product URLs, or product for product URLs and numeric IDs. Defaults to search. Not for customer reviews or Coupang Eats.

## `searchQueries` (type: `array`):

Use this when searching Coupang by keyword. Korean and English terms are accepted, for example 노트북 or wireless mouse. Defaults to 노트북. Not a product URL field.

## `startUrls` (type: `array`):

Use this when you already have Coupang search, category, or product pages. A valid example is https://www.coupang.com/np/search?q=노트북. Defaults to empty. Non-Coupang URLs return INVALID\_INPUT.

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

Use this when the exact Coupang products are already known. Accepts product URLs or numeric IDs such as 8499380264. Defaults to empty. Not for search keywords.

## `maxResults` (type: `integer`):

Use this to cap products written and charged during the run. The actor stops at this cap. Defaults to 50, with a minimum of 1 and maximum of 1000. Platform usage is additional to per-product event charges.

## Actor input object example

```json
{
  "mode": "search",
  "searchQueries": [
    "노트북"
  ],
  "startUrls": [],
  "productUrls": [],
  "maxResults": 50
}
```

# Actor output Schema

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

Validated product records as JSON items.

## `summary` (type: `string`):

Compact terminal outcome with item, billing, and warning counts.

## `diagnostics` (type: `string`):

Detailed input, page, validation, proxy, billing, warning, and error telemetry.

# 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 = {
    "mode": "search",
    "searchQueries": [
        "노트북"
    ]
};

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

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

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

```

## Python example

```python
from apify_client import ApifyClient

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

# Prepare the Actor input
run_input = {
    "mode": "search",
    "searchQueries": ["노트북"],
}

# Run the Actor and wait for it to finish
run = client.actor("khadinakbar/coupang-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 '{
  "mode": "search",
  "searchQueries": [
    "노트북"
  ]
}' |
apify call khadinakbar/coupang-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/rvU46INgPuch5cF45/builds/5pEe9ZsrICTFczpdf/openapi.json