🛒 Coupang Products Crawler

Extract product listings from Coupang.com (Korea's largest e-commerce site) by search keyword or category ID. Returns structured JSON with 30+ fields per product — title, brand, prices, ratings, delivery flags, sponsorship flags, and more.

🚀 What does this Actor do?

This actor scrapes product listings from Coupang's web search and category pages. You can:

• Provide one or more search queries (Korean or English) — searchQueries
• Provide one or more category IDs — categoryIds
• Mix both in a single run

The actor handles proxy rotation and retries automatically — you just give it the queries or category IDs and download the dataset.

🗾️ Example Input

Search by keyword (Korean works best — Coupang is Korean-locale):

{
  "searchQueries": ["야구 모자", "노트북", "wireless headphones"],
  "maxPagesPerQuery": 1
}

Browse by category:

{
  "categoryIds": ["178255", "175532"],
  "maxPagesPerQuery": 3
}

Both at once:

{
  "searchQueries": ["커피"],
  "categoryIds": ["189408"],
  "maxPagesPerQuery": 2
}

📦 What data do you get?

Every product is returned with the following fields:

{
  "product_id": "9508465677",
  "item_id": "28333543319",
  "vendor_item_id": "95285862563",
  "title": "스트리온 빅사이즈 무지 대두 볼캡",
  "brand": "스트리온",
  "sales_price": 5900,
  "original_price": 30000,
  "unit_price": null,
  "currency": "KRW",
  "discount_rate": "80%",
  "rating_avg": 5,
  "rating_count": 143,
  "thumbnail": "https://thumbnail.coupangcdn.com/.../volcap.png",
  "images": ["https://thumbnail.coupangcdn.com/.../volcap.png"],
  "delivery_badge": "https://image.coupangcdn.com/.../logo_rocket_merchant.png",
  "promise_delivery": null,
  "shipping_cost": null,
  "is_free_shipping": false,
  "is_rocket": true,
  "is_rocket_fresh": false,
  "is_tomorrow_delivery": true,
  "is_overseas": false,
  "is_fresh": false,
  "is_adult": false,
  "is_sponsored": false,
  "is_sold_out": false,
  "is_available": true,
  "is_gift_card": false,
  "is_digital": false,
  "description": null,
  "category_id": null,
  "category_path": null,
  "search_query": "야구 모자",
  "search_rank": 1,
  "product_url": "https://www.coupang.com/vp/products/9508465677?...",
  "scraped_at": "2026-06-09T13:42:24.433Z"
}

Field reference

Field	Type	Notes
product_id	string	Coupang's stable product ID
item_id, vendor_item_id	string	Item / vendor identifiers (extracted from product URL)
title, brand	string	Product name and best-guess brand (first token of title)
sales_price	number	Current sale price in KRW
original_price	number	Pre-discount price (when shown)
unit_price	string	Per-unit pricing like "(1개당 7,150원)" when shown
currency	string	Always "KRW"
discount_rate	string	E.g. "42%"
rating_avg	number	Average review rating (0-5)
rating_count	number	Total review count
thumbnail	string	Primary product image URL
images	array	Array of product image URLs
delivery_badge	string	URL of the rocket/tomorrow/global badge icon
promise_delivery	string	E.g. "내일(수) 도착" when shown
shipping_cost, is_free_shipping	number / bool	0 and true when free shipping detected
is_rocket, is_rocket_fresh, is_tomorrow_delivery, is_overseas	bool	Delivery type flags from product badges
is_sponsored	bool	True for sponsored listings (ads above results)
is_sold_out, is_available	bool	Stock signals
category_id	string	Set when the product was found via a category browse
search_query	string	Set when the product was found via a search query
search_rank	number	Position in the organic search results (null for ads)
product_url	string	Full Coupang product page URL
scraped_at	string	ISO timestamp when the page was extracted

🦖 How to use

1. Enter at least one search query or category ID in the input.
2. Optionally set maxPagesPerQuery (default 1).
3. Run the actor.
4. Download the results from the Dataset tab or fetch them via the API.

Note: A typical run completes in 15–30 seconds. The actor handles transient failures internally with automatic retries.

🔍 Key Features

• Keyword search and category browsing in the same run
• Pagination — maxPagesPerQuery walks pages 1..N per query/category
• Automatic retries with proxy rotation — runs just work
• Structured output — 30+ fields per product, all flags pre-computed

📋 Input Parameters

Parameter	Type	Default	Description
searchQueries	array of strings	[]	Search keywords. Korean queries return the most results.
categoryIds	array of strings	[]	Coupang category IDs to browse.
maxPagesPerQuery	integer	1	Pages to walk per search/category (1–50).
fetchDetails	boolean	false	Reserved — will visit each product page for description and full images gallery.
proxyConfiguration	object	(managed)	Optional proxy override. Defaults are tuned for Coupang.

Popular category IDs

ID	Category
208725	Fashion / Accessories
189408	Foods
114190	Household
175532	Consumer Electronics
174637	Beauty
164352	Home Decor
219079	Maternity / Baby / Kids
317675	Sports / Leisure
166051	Kitchen
317676	Toys / Hobbies
162889	Automotive
114191	Pet Supplies
164687	Stationery / Office
305433	Wellness / Health Foods
317674	Books / Music / DVDs

📩 Feedback

Found a bug or have ideas? Open an issue on the actor's Apify page — happy to improve it.