# Coupang Scraper: Products, Prices, Rocket Delivery (`automation_craft/coupang-scraper`) Actor

Scrape Coupang searches, categories and product links from coupang.com in Korea: five orders, price bands and related searches past the first 60 cards. Get price, base price, discount, unit price, rating, Rocket delivery badges, rank and sponsored flag. No login; JSON, CSV or Excel; pay per product.

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

## Pricing

from $1.80 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### Coupang Scraper: Products, Prices, Rocket Delivery

**Coupang scraper** for coupang.com, South Korea's largest online shop: get every product of a Coupang search, category or product
link as clean rows with **price, base price, discount, unit price, coupon, cashback, rating, review count, Rocket delivery badges,
delivery promise, sponsored flag and rank**, in each of Coupang's five orders and its own price bands. On request each product's page
adds the **brand, seller and seller rating, other seller count, every option with its own price and stock, member and card prices,
category path, all images and Korea's product information notice** (model, KC certification, maker, country of origin). No login, no
cookies of yours, no API key. You pay per product delivered; repeats, filtered products and misses are free.

It also reads **every product of a seller's store** (shop.coupang.com), Coupang's campaign pages, Coupang Global, the Best 100 lists,
today's new products, the seller deals and the **Goldbox daily deals** (deal price, member price, time left and share sold), and can
search the **suggestions of Coupang's search box** for each search word.

Use it to watch competing sellers' prices, discounts and Rocket badges on the searches your buyers type, to see who ranks and who pays for ads on
a keyword, to export a Coupang category to Excel, or to feed a Korean price comparison sheet or database of your own.

### Quick start

1. Open the Actor and type search words in **Search words** (노트북, 커피, airpods), or paste Coupang links in **Coupang links**.
2. Pick the orders you want in **Orders** (Coupang ranking, lowest price, highest price, best selling, newest). Each order reads one
   more page of 60 products per search.
3. Set **Max products per search** (10 for a first look) and press **Start**.
4. Open the **Storage** tab: the Products view shows the main columns; download JSON, CSV or Excel, or read the dataset through the API.

The input this page opens with (one search for 노트북, ten products) is the run Apify uses for its daily check of the Actor.

### What you get

#### Product rows (the Product event)

One row per offer: Coupang lists each option of a product (size, colour, seller) as its own card, and each card is one row
(`oneRowPerProduct` makes it one row per product). Fill rates are the share of rows that carry the field (true, for a yes or no
field), measured on the platform from 2026-10-29 to 2026-10-31 over 17,688 rows of 121 runs of searches, categories and product
links (`platform-results/`).

| Field | What it holds | Filled |
|---|---|---|
| `productId`, `itemId`, `vendorItemId` | Coupang's product id, option id and offer id (strings) | 100% |
| `title`, `url`, `imageUrl` | the title as Coupang serves it, the offer's product link, its image | 100% |
| `price`, `currency` | sale price in won, and `KRW` | 100% |
| `basePrice`, `discountPercent`, `savings` | struck price, discount and the difference, in won | 49% |
| `discountLabel` / `discountEndsAt` | the discount's label (쿠폰할인, 와우쿠폰할인 ...) / when a timed discount ends | 21% / 2% |
| `unitPrice` | the price per unit the card shows: `{ amount, per, unit }` (88 won per 10 g) | 43% |
| `cashback`, `cashbackText` | the largest cashback the card names (최대 ... 원 적립), in won and as written | 99% |
| `coupon` / `benefits` | a coupon on the card / member benefits | 3% / 7% |
| `rating`, `reviewCount` | average rating out of 5 and the number of ratings | 84% |
| `deliveryBadges`, `rocketDelivery` / `tomorrowDelivery` | Coupang's delivery badges, Rocket delivery / next day arrival | 52%, 51% / 47% |
| `rocketFresh`, `rocketMerchant`, `coupangGlobal`, `rocketLuxury` | the other delivery badges | 4%, 8%, 1%, under 1% |
| `deliveryPromise` / `shippingText` | the arrival promise (내일(토) 도착) / the shipping text of the card | 100% / 85% |
| `freeShipping` / `freeShippingOver` / `shippingFeeText` | free shipping for everyone (a members only "와우는 무료배송" is not) / its threshold / a fee the card names | 80% / 55% / 4% |
| `soldOut`, `soldOutText` / `lowStockText`, `stockLeft` | sold out / the low stock note (단 5개 남음) and its number | under 1% / 5%, 3% |
| `usedOffersText`, `usedLowestPrice` | used, returned or refurbished offers of the product and the lowest price among them | 2% |
| `preOrder` / `couPick` / `bestRank` | pre-order / Coupang's CouPick mark / a best seller rank, or the place in a Best 100 list | under 1% / 1% / 10% |
| `sponsored` | an ad among the results | 6% |
| `rank`, `page`, `sort` / `organicRank` | the card's place on its page, the page and the order it was read in / its place among cards that are not ads | 99% / 93% |
| `priceBand` / `searchedAs` | the price band the card was found in / the search words (empty for a category) | 25% / 65% |
| `source`, `scrapedAt` | the input the row came from, when it was read | 100% |
| `deal` | a deal's member price and label, seconds left, share sold, brand, seller and Goldbox tab | Goldbox and seller deal rows |
| `details`, `detailsStatus` | Product details (below), or why a row has none | with Product details on |

#### Product details (the Product details event, optional)

With **Product details** on, each delivered product's own page is read and nested in its row as `details`: the page's own ids and `title`, `brand`, `itemName`,
`optionText`, `categoryId`, `categoryName`, `categoryPath`, `price` (sale, coupon, final, WOW member and non member prices, the card
discount text), `rating`, `reviewCount` and `fourFiveStarReviewCount` (the reviewers who gave 4 or 5 stars), `priceSteps` (price per quantity), `shippingFeeType`, `shippingFee`, `shippingText` and `freeShippingCondition` (the
offer's own shipping), `deliveryText`, `soldOut`, `almostSoldOut`, `buyableQuantity`, `retail` (sold by Coupang),
`used`, `seller` (name, id, store link, rating), `otherSellerCount`, `usedOffers`, `options` and `optionCombinations` (every combination with
its item and offer ids, price and stock flags; `optionCombinationCount` counts them), `images`, `cashback`, `coupons`, `installmentMonths`, `countryOfOrigin`,
`sellingInfo`, `productNotice` (Korea's product information notice: model, KC certification, rated voltage, maker, country, warranty
and after sales contact), `description` (the description blocks, texts and image links), `delivery` and `returns` terms. The row's
price, sold out flag, rating, review count and free shipping flag are then taken from the page, which is newer than the search card. The seller's
legally required business information (business name, representative, phone, e-mail, address, business and mail order numbers) is
added as `sellerBusinessInfo` only with **Seller business information** on: some sellers are sole traders, so it can name a person. Coupang leaves the lower part of the page out for a few offers (2% of 478 product pages in our runs, one offer read again and again): their notice, description, delivery and return terms and seller business information are then empty. Product links and ids are
always read from their pages, so their rows always carry details.

#### Free rows

- `coverage`: one per search or category: what was read (pages, cards, the orders and price bands, Coupang's related searches), how
  many products were delivered, repeated, filtered or left out as ads, and why it stopped.
- `status`: invalid input, a product, category or store Coupang does not have (such a category or store is never marked complete, so a
  resume asks it once more), a search Coupang found nothing for, a filter Coupang does not
  list for a page, pages that could not be read, Coupang refusing the run, inputs not started.
- `summary`: the last row of every run: counts, requests, fresh addresses used, the work allowance and the billing as the platform
  confirmed it.

### How much does it cost to scrape Coupang?

You pay per event, by your Apify plan:

| Event | Free | Bronze | Silver | Gold |
|---|---|---|---|---|
| Product (per 1,000) | $2.52 | $2.30 | $2.09 | $1.80 |
| Product details (per 1,000) | $4.91 | $4.91 | $4.91 | $4.91 |
| Actor start (per run, 256 MB) | $0.055 | $0.055 | $0.055 | $0.055 |

Platinum and Diamond plans pay the Gold price. The Actor start event has no plan discount. The Store pricing card shows these same
prices per 1,000 events: "$4.91 / 1,000" on the Product details row means one product page costs 0.491 cents or less.

A search of one order reads one page of 60 cards; 1,000 products of fresh searches cost about $1.86 at the Gold price with
the start fee. Repeats across orders, price bands and searches are delivered once and charged once. Pages Coupang refuses, misses,
filtered cards and ads you leave out are free.

### Input

| Setting | What it does |
|---|---|
| `searchTerms` | search words, one search per entry (Korean or English) |
| `startUrls` | coupang.com search, category, campaign, Coupang Global, Best 100, today's new products, Goldbox, seller deals and product links, and seller store links (shop.coupang.com/vid/A00996727), with the order and filters Coupang put in the link |
| `categories` | category ids (497135 in coupang.com/np/categories/497135); each category is read page by page |
| `mainCategories` | Coupang's 15 main categories picked by name (fashion, beauty, food, electronics ...), each read as its category id |
| `productUrls` | product links or ids, each read from its product page (one Product and one Product details) |
| `sortBy` | any of `ranking`, `lowestPrice`, `highestPrice`, `bestSelling`, `newest`; each search and category is read once per order |
| `minPrice`, `maxPrice` | in won, sent to Coupang and checked again on each row |
| `minRating` | 1 to 4 stars and above |
| `deliveryTypes` | `rocket`, `rocketLuxury`, `coupangGlobal`, `freeShipping`, `topBrand` (any of them) |
| `offerConditions` | `new`, `used`, `refurbished`, `returned`, `packageDamaged`, `repackaged` |
| `brands` | brand names as Coupang's brand filter lists them for each search or category, or brand ids |
| `attributeFilters` | other filters of the search page, written "<filter name>: <value>" (총 수량: 100개 이하) |
| `splitByPriceBands` | also reads each search and category in each price band Coupang offers for it |
| `includeRelatedSearches` | also searches the related searches Coupang lists under each search word (one level) |
| `includeSuggestedSearches` | also searches the suggestions Coupang's search box gives for each search word (one level, at most 10); the coverage row lists them |
| `includeSponsored` | ads among the results are delivered with `sponsored: true` (default) or left out |
| `oneRowPerProduct` | one row per product instead of one per offer |
| `maxItemsPerSearch`, `maxItems`, `maxPagesPerCategory` | limits per search or category, per run, pages per category |
| `includeDetails`, `includePersonalData` | Product details, and the seller's business information inside it |
| `resumeFromRunId` | continues an earlier run with the same input: searches it read to the end are skipped, the others skip the products they delivered there (a Goldbox or today's list read to its end is skipped too: start a new run for a new day's list; a search resumed with other orders, filters, related or suggested search settings starts fresh) |
| `maxConcurrency`, `requestDelaySecs`, `requestTimeoutSecs`, `maxRequestRetries`, `proxyConfiguration` | run settings; leave the proxy as is |

A campaign link (coupang.com/np/campaigns/1440, a promotion's product list) and Coupang Global (coupang.com/np/coupangglobal, imported
products) are read like a category, page by page, in each order and price band. Three lists are read as the one page Coupang shows, in
its own order: a Best 100 link (coupang.com/np/best100/bestseller or /trending, with or without a category id after it, 30 products,
`bestRank` holds the place in the list), today's new products (coupang.com/np/todayopen, 48 products) and Goldbox, Coupang's daily
deals (coupang.com/np/goldbox, every deal of the list, 100 a page: 207 on 2026-10-31; each row's `deal` holds the member price, the seconds left, the share sold, the brand and the
Goldbox tab). Orders, price bands, brands, offer conditions and attribute filters do not apply to these lists; price, rating and
delivery settings are checked on each row.

A seller store link (shop.coupang.com/vid/A00996727, the store link Product details carries in `seller.storeUrl`) is read as the
store's whole product list, 20 products a page, in each order asked for; every product's link must name the store. The seller deals
(coupang.com/np/omp) are read as Coupang serves them, 30 deals with their member price and seller. Both are read through the store's
or the site's own page first (its cookies), so they are not read while Coupang refuses the run's direct requests (a free row says
so).

Filters a pasted link carries stay applied; a setting you give replaces the same filter of the link. Brand names and attribute
filters are looked up in each search's own filter lists, and one Coupang does not list there is named in a free row with the ones it
does list. Ads do not follow every filter: under a brand, offer condition, attribute, top brand or category in a search filter an ad is left out, free.

### How it works, and its limits

Coupang shows visitors who are not logged in the first page of a search: 60 cards. This Actor reads more of a search by its five
orders and its price bands (about three times the products of one order with all five), and by related searches; a category is read
page by page to its last page (17 pages of 60 at most). It reads Coupang through Apify residential addresses in South Korea, the only
ones Coupang answers, and takes a fresh address when Coupang refuses one (it does after a handful of pages); the run's summary counts
every fresh address used, and a run draws a bounded number. Coupang's bot protection also refuses a client setting after a few
hundred pages; the run then moves to another of a fixed set of client settings, at most 8 a run, each counted in the summary. When it
refuses this Actor's direct requests altogether (it did for more than half an hour after about 650 pages in our tests), the run goes on
through Apify's own unblocker, which answers Coupang's check in a browser: slower (20 to 60 seconds a page) and counted in the summary.
It reads search and category pages only: product pages are not read then, so rows go out without Product details (not charged,
`detailsStatus: source_refused`) and product links get a free row asking you to run them again later.
When the unblocker fails 10 times in a row too, the run stops with a free row that says so and names Coupang as the refusing side; run
it again later. A run of one search takes about 10 seconds.

### What this Actor does NOT do

- No search page past the first: Coupang answers page 2 of a search with "검색결과가 없습니다" to visitors who are not logged in.
- No reviews and no review text, no star breakdown and no buyer survey: Coupang's review door refuses every client of this kind, and
  review text is outside this Actor.
- No brand shops (shop.coupang.com/<brand>/<id>): a brand page's product list answers no product to this client, with or without
  the seller the page names. Best 100 lists give the 30 products their page shows, today's new products the 48 of its first page and
  the seller deals the 30 Coupang serves (its next page answered the same 30).
- No login, no Coupang Partners API, no seller (WING) API.
- No tracking between runs: no "new only" delivery, no price change alerts. Schedule it and compare runs in your own sheet, or use
  `resumeFromRunId` to finish an interrupted run.
- Coupang Taiwan (tw.coupang.com) is not read.

### FAQ

#### Can I scrape Coupang without logging in?

Yes. This Actor reads the search, category and product pages Coupang shows to any visitor, with no login, no cookies of yours and no
API key, through Apify residential addresses in South Korea.

#### How do I get more than 60 products from a Coupang search?

Coupang shows visitors one page of 60 cards per search. Pick several orders in **Orders**, turn on **Read price bands too** to read the
search again in each price band Coupang offers, and turn on **Related searches too**; repeats are delivered and charged once. A category
is read page by page, up to 17 pages of 60.

#### Does it get Rocket delivery badges and WOW member prices?

Every row carries Coupang's delivery badges (`rocketDelivery`, `rocketFresh`, `coupangGlobal`, `rocketLuxury`, `tomorrowDelivery`)
and the arrival promise. WOW member and non member prices, the card discount text and the price per quantity come with
**Product details**.

#### Can I export Coupang products to Excel or Google Sheets?

Yes. Download the dataset as Excel, CSV or JSON from the **Storage** tab, read it through the Apify API, or send each run's rows on
with Apify's integrations (Make, Zapier, n8n, webhooks).

#### Why did my run stop and say Coupang refused it?

Coupang's bot protection sometimes refuses this Actor's requests for an hour or more. The run then goes on through Apify's unblocker,
and stops only when that fails 10 times in a row too: it writes a free row that names Coupang as the refusing side and charges nothing
for what it did not read. Run it again later; `resumeFromRunId` continues where it stopped.

#### Is scraping Coupang legal?

Coupang's terms forbid robots, spiders and scrapers without its approval, and Korean law protects databases and technical measures.
This Actor reads only pages Coupang shows to any visitor, with no login, and no personal data unless you turn on the seller business
information. You are responsible for a lawful use of what you collect, in Korea and where you are; take legal advice for your case.

#### Why does this Actor run with limited permissions?

Least privilege: it reads and writes only its own run's storage (its dataset and key-value store) and, when you give
`resumeFromRunId`, reads that earlier run's dataset. It cannot see your other Actors, datasets or settings.

### Changelog

See the Changelog tab.

### More data tools by Automation Craft

- [Noon Scraper: Products, Prices, Sellers, Stock](https://apify.com/automation_craft/noon-scraper)
- [Trendyol Scraper: Products, Prices, Reviews](https://apify.com/automation_craft/trendyol-scraper)
- [AliExpress Search Scraper - Products and Prices](https://apify.com/automation_craft/aliexpress-search-scraper)
- [Flipkart Scraper: Products, Prices, Sellers](https://apify.com/automation_craft/flipkart-scraper)
- [Meesho Scraper: Products, Prices, Reviews](https://apify.com/automation_craft/meesho-scraper)
- [Nykaa Scraper: Beauty Products, Prices, Reviews](https://apify.com/automation_craft/nykaa-scraper)

# Changelog

This Actor's version history is a separate document: https://apify.com/automation_craft/coupang-scraper/changelog.md

# Actor input Schema

## `searchTerms` (type: `array`):

Words to search on Coupang, one search per entry, in Korean or English (노트북, 커피, airpods). Each search is read once per order set below (Coupang shows visitors who are not logged in the first 60 products of a search; more orders and price bands read more). Each search delivers up to Max products per search.

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

Links copied from coupang.com: a search page (https://www.coupang.com/np/search?q=노트북\&sorter=salePriceAsc), a category page (https://www.coupang.com/np/categories/497135) or a campaign page (https://www.coupang.com/np/campaigns/1440) with the filters and order Coupang put in the link, Coupang Global (https://www.coupang.com/np/coupangglobal, read like a category), a seller store (https://shop.coupang.com/vid/A00996727, the store link a product page names: every product of the store, 20 a page, in each order), a Best 100 list (https://www.coupang.com/np/best100/bestseller, 30 products in Coupang's own order), today's new products (https://www.coupang.com/np/todayopen, 48 products), the seller deals (https://www.coupang.com/np/omp, 30 deals), Goldbox deals (https://www.coupang.com/np/goldbox, 100 deals with their member price, time left and share sold), or a product page (https://www.coupang.com/vp/products/8708162122?itemId=25288657822\&vendorItemId=95393316330, m.coupang.com product links too).

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

Coupang category ids: the digits of a category link (497135 in coupang.com/np/categories/497135). Each category is read page by page, up to its last page (Coupang links 17 pages of 60 at most).

## `mainCategories` (type: `array`):

Coupang's main categories from its top menu, picked by name; each is read like a category id (the id is shown beside its name).

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

Product links (coupang.com/vp/products/<id>, with or without itemId and vendorItemId) or bare product ids. Each is read from its own product page and delivered with its Product details, billed as one Product and one Product details. An id Coupang does not have gets a free status row.

## `sortBy` (type: `array`):

Coupang's own orders. Each search and category is read once per order picked; every product is delivered once, in the first order that found it. Left out: Coupang ranking for search words and categories, and the link's own order for links. Picking all five reads about three times as many products of a search as one order.

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

In Korean won. Sent to Coupang and checked again on each row's sale price.

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

In Korean won. Sent to Coupang and checked again on each row's sale price.

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

Coupang's own rating filter, checked again on each row's rating.

## `deliveryTypes` (type: `array`):

Coupang's own delivery filters. Rocket, Rocket Luxury, Coupang Global and free shipping are checked again on each row.

## `offerConditions` (type: `array`):

Coupang's own offer condition filter.

## `brands` (type: `array`):

Brand names as Coupang's brand filter lists them for a search or category (맥심, 삼성전자, Apple), or brand ids. Each name is looked up in the brand list of that search's or category's own page; a brand Coupang does not list there gets a free row naming the brands it does list.

## `attributeFilters` (type: `array`):

Other filters Coupang's search page offers for a search or category, written "<filter name>: <value>" as the page shows them (총 수량: 100개 이하, 색상: 블랙). Each is looked up in that page's own filter list; one Coupang does not list there gets a free row naming the filters it does list. The same name twice means either value.

## `splitByPriceBands` (type: `boolean`):

Each search and category is also read in each price band Coupang offers for it (about five bands), in every order picked: up to six times the products of one search. Products found twice are delivered once.

## `includeRelatedSearches` (type: `boolean`):

Also searches the related searches Coupang lists under each search word (연관검색어, up to 10 per word, one level), each with the same orders, filters and limits. Their rows carry the word that led to them.

## `includeSuggestedSearches` (type: `boolean`):

Also searches the suggestions Coupang's search box gives for each search word (one level, at most 10 a word), with the same filters, orders and limits; each search word's coverage row lists them. Products found that way carry the word they came from in source.relatedTo. Not read while Coupang refuses the run's direct requests.

## `includeSponsored` (type: `boolean`):

Sponsored products (Coupang's ads among the results) are delivered with sponsored: true and their place on the page. Off: they are left out, free. Under a brand, offer condition, attribute, top brand or category in a search filter a sponsored product is always left out, free, since ads do not follow those filters.

## `oneRowPerProduct` (type: `boolean`):

Coupang lists each option of a product (size, colour, seller) as its own card. Off (default): one row per card. On: one row per product, the first card found.

## `maxItemsPerSearch` (type: `integer`):

The most products each search word, link or category delivers (default 100).

## `maxItems` (type: `integer`):

The most products the whole run delivers (left out: no limit beyond the per search one).

## `maxPagesPerCategory` (type: `integer`):

The most pages read per category and order (Coupang links 17 pages of 60).

## `includeDetails` (type: `boolean`):

Reads each delivered product's own page (one Product details event each): brand, seller and seller rating, other seller count, every option with its own price and stock, price per quantity step, member and card prices, category path, all images, the product information notice (model, KC certification, maker, country of origin), description, delivery and return terms, cashback and coupons. A page that could not be read is free.

## `includePersonalData` (type: `boolean`):

With Product details: adds the seller's business information Coupang shows on the product page (business name, representative, phone, e-mail, address, business and mail order numbers). Some sellers are sole traders, so this can name a person: you are responsible for a lawful use, GDPR and Korea's PIPA included. Off by default.

## `maxConcurrency` (type: `integer`):

Searches or categories read at once (1 or 2, default 2).

## `requestTimeoutSecs` (type: `integer`):

How long one request may take (default 30 s).

## `maxRequestRetries` (type: `integer`):

Attempts per request after Coupang answered without a usable page (default 3). A refused exit is replaced by a fresh one at once.

## `requestDelaySecs` (type: `integer`):

The least time between two requests of one lane (default 0: the Actor's own pace of about one request every 1.5 seconds per lane).

## `proxyConfiguration` (type: `object`):

Leave as is: the Actor uses Apify residential addresses in South Korea, the only ones Coupang answers. Your own Korean proxy links are used for every request when you give them.

## `resumeFromRunId` (type: `string`):

The run id of an earlier run of this Actor with the same input (the id in the run's page address). Searches and categories that run read in full are skipped, and the others skip the products they delivered there; nothing skipped is charged. Use it after a run stopped at a limit or an abort.

## Actor input object example

```json
{
  "searchTerms": [
    "노트북"
  ],
  "splitByPriceBands": false,
  "includeRelatedSearches": false,
  "includeSuggestedSearches": false,
  "includeSponsored": true,
  "oneRowPerProduct": false,
  "maxItemsPerSearch": 10,
  "includeDetails": false,
  "includePersonalData": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `items` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "노트북"
    ],
    "maxItemsPerSearch": 10,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("automation_craft/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 = {
    "searchTerms": ["노트북"],
    "maxItemsPerSearch": 10,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("automation_craft/coupang-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 '{
  "searchTerms": [
    "노트북"
  ],
  "maxItemsPerSearch": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call automation_craft/coupang-scraper --silent --output-dataset

```

## MCP server setup

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