Coupang Best Sellers & Rocket Delivery Flags

Collect Coupang best sellers by category (30 per page, optional child fan-out), keyword suggestions, or the category tree. Products include price, unit price, coupon, rating, Rocket delivery, and category breadcrumb. No user proxy, cookies, or login required.

Open on Apify GitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

Field	Type	Required	Description
`mode`	string	required	What to collect. Best sellers returns products with price, unit price, coupon, rating, Rocket delivery, and category breadcrumb; keyword suggestions and the category tree return discovery data. Search, product details, and reviews need a Korean residential proxy and are unavailable unless that connection is enabled.
`category`	string	optional	Coupang best-seller category. Each category page returns up to 30 products; enable Include subcategories to continue into child pages until Maximum products is reached.
`categoryId`	string	optional	Optional numeric Coupang best100 category ID or /np/categories/ URL. Overrides the category dropdown.

Show all input fields

Field	Type	Required	Description
`mode`	string	required	What to collect. Best sellers returns products with price, unit price, coupon, rating, Rocket delivery, and category breadcrumb; keyword suggestions and the category tree return discovery data. Search, product details, and reviews need a Korean residential proxy and are unavailable unless that connection is enabled.
`category`	string	optional	Coupang best-seller category. Each category page returns up to 30 products; enable Include subcategories to continue into child pages until Maximum products is reached.
`categoryId`	string	optional	Optional numeric Coupang best100 category ID or /np/categories/ URL. Overrides the category dropdown.
`includeSubcategories`	boolean	optional	When true, after the selected category page is fetched, also fetch its child category best-seller pages until Maximum products is reached. Default false; small maxItems values usually need no child pages.
`minPrice`	integer	optional	Only return products at or above this price in Korean won.
`maxPrice`	integer	optional	Only return products at or below this price in Korean won.
`rocketOnly`	boolean	optional	Keep only products with Coupang's Rocket delivery badge.
`minRating`	number	optional	Keep only products rated at least this many stars. Products without a rating are skipped.
`maxItems`	integer	optional	Maximum number of best-seller products to return. A single best100 page has at most 30; set includeSubcategories=true to continue into child pages, or use category=all.
`searchQueries`	array	optional	Keywords for keyword suggestions (mode=keywordSuggestions). Korean or English.
`maxSuggestions`	integer	optional	Maximum suggestions to return per keyword.
`maxCategories`	integer	optional	Maximum category nodes to return from the Coupang category tree.

Download the published input schema

View complete JSON

{
  "description": "Scrape Coupang best sellers by category, Coupang keyword suggestions, or the Coupang category tree. Product records include current and original price, unit price, coupon, rating, Rocket delivery, and a category breadcrumb. Set includeSubcategories to walk child best100 pages until Maximum products is reached. No proxy, cookies, or login required for these modes.",
  "properties": {
    "category": {
      "default": "electronics",
      "description": "Coupang best-seller category. Each category page returns up to 30 products; enable Include subcategories to continue into child pages until Maximum products is reached.",
      "editor": "select",
      "enum": [
        "electronics",
        "fashion",
        "beauty",
        "baby",
        "food",
        "kitchen",
        "household",
        "home",
        "sports",
        "automotive",
        "books",
        "toys",
        "office",
        "pets",
        "health",
        "all"
      ],
      "enumTitles": [
        "Electronics and digital",
        "Fashion",
        "Beauty",
        "Baby and kids",
        "Food",
        "Kitchen",
        "Household",
        "Home and interior",
        "Sports and leisure",
        "Automotive",
        "Books and media",
        "Toys and hobbies",
        "Stationery and office",
        "Pet supplies",
        "Health and supplements",
        "All categories (up to 450 products)"
      ],
      "prefill": "electronics",
      "sectionCaption": "Best sellers",
      "sectionDescription": "Pick a category. Coupang's best100 page exposes 30 products per category.",
      "title": "Category",
      "type": "string"
    },
    "categoryId": {
      "description": "Optional numeric Coupang best100 category ID or /np/categories/ URL. Overrides the category dropdown.",
      "editor": "textfield",
      "title": "Advanced category ID",
      "type": "string"
    },
    "includeSubcategories": {
      "default": false,
      "description": "When true, after the selected category page is fetched, also fetch its child category best-seller pages until Maximum products is reached. Default false; small maxItems values usually need no child pages.",
      "prefill": false,
      "title": "Include subcategories",
      "type": "boolean"
    },
    "maxCategories": {
      "default": 1000,
      "description": "Maximum category nodes to return from the Coupang category tree.",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 50,
      "sectionCaption": "Category tree",
      "sectionDescription": "The Coupang category tree with IDs and URLs. No proxy required.",
      "title": "Maximum categories",
      "type": "integer"
    },
    "maxItems": {
      "default": 20,
      "description": "Maximum number of best-seller products to return. A single best100 page has at most 30; set includeSubcategories=true to continue into child pages, or use category=all.",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 3,
      "sectionCaption": "Limits",
      "sectionDescription": "The daily test uses 3 products. Coupang best100 exposes 30 products per category.",
      "title": "Maximum products",
      "type": "integer"
    },
    "maxPrice": {
      "description": "Only return products at or below this price in Korean won.",
      "maximum": 100000000,
      "minimum": 0,
      "title": "Maximum price (KRW)",
      "type": "integer"
    },
    "maxSuggestions": {
      "default": 10,
      "description": "Maximum suggestions to return per keyword.",
      "maximum": 10,
      "minimum": 1,
      "prefill": 10,
      "title": "Suggestions per keyword",
      "type": "integer"
    },
    "minPrice": {
      "description": "Only return products at or above this price in Korean won.",
      "maximum": 100000000,
      "minimum": 0,
      "sectionCaption": "Filters",
      "sectionDescription": "Optional filters applied to the best-seller products.",
      "title": "Minimum price (KRW)",
      "type": "integer"
    },
    "minRating": {
      "description": "Keep only products rated at least this many stars. Products without a rating are skipped.",
      "maximum": 5,
      "minimum": 0,
      "title": "Minimum rating",
      "type": "number"
    },
    "mode": {
      "default": "bestSellers",
      "description": "What to collect. Best sellers returns products with price, unit price, coupon, rating, Rocket delivery, and category breadcrumb; keyword suggestions and the category tree return discovery data. Search, product details, and reviews need a Korean residential proxy and are unavailable unless that connection is enabled.",
      "editor": "select",
      "enum": [
        "bestSellers",
        "keywordSuggestions",
        "categories",
        "search",
        "productDetails",
        "reviews",
        "categoryProducts"
      ],
      "enumTitles": [
        "Best sellers by category",
        "Keyword suggestions",
        "Category tree",
        "Search by keyword (unavailable without a proxy)",
        "Product details (unavailable without a proxy)",
        "Product reviews (unavailable without a proxy)",
        "Category products (legacy alias for best sellers)"
      ],
      "prefill": "bestSellers",
      "title": "Mode",
      "type": "string"
    },
    "rocketOnly": {
      "default": false,
      "description": "Keep only products with Coupang's Rocket delivery badge.",
      "prefill": false,
      "title": "Rocket delivery only",
      "type": "boolean"
    },
    "searchQueries": {
      "default": [],
      "description": "Keywords for keyword suggestions (mode=keywordSuggestions). Korean or English.",
      "editor": "stringList",
      "prefill": [],
      "sectionCaption": "Keyword suggestions",
      "sectionDescription": "Coupang's own search-box suggestions. No proxy required.",
      "title": "Keywords",
      "type": "array"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "Coupang Best Sellers Scraper Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

Field	Type	Required	Description
`products`	string	optional	Product records from Coupang best100 (recordType=product), including price, unit price, coupon, rating, Rocket delivery, and categories breadcrumb.
`prices`	string	optional	Product records with current price, original price, unit price, coupon, discount, rating, Rocket flag, and categories breadcrumb.
`categories`	string	optional	Category records from the Coupang category tree (recordType=category).
`keywordSuggestions`	string	optional	Keyword suggestion records (recordType=keywordSuggestion).

Download the published output schema

View complete JSON

{
  "actorOutputSchemaVersion": 1,
  "description": "Coupang best-seller products, keyword suggestions, or category nodes. Product records include current/original price, unit price, coupon, rating, Rocket delivery, and a category breadcrumb. Best sellers are limited to 30 products per page; optional child-category fan-out continues until maxItems. Search, product details, and reviews require a Korean residential proxy.",
  "properties": {
    "categories": {
      "description": "Category records from the Coupang category tree (recordType=category).",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Category tree",
      "type": "string"
    },
    "keywordSuggestions": {
      "description": "Keyword suggestion records (recordType=keywordSuggestion).",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Keyword suggestions",
      "type": "string"
    },
    "prices": {
      "description": "Product records with current price, original price, unit price, coupon, discount, rating, Rocket flag, and categories breadcrumb.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Prices",
      "type": "string"
    },
    "products": {
      "description": "Product records from Coupang best100 (recordType=product), including price, unit price, coupon, rating, Rocket delivery, and categories breadcrumb.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Best-seller products",
      "type": "string"
    }
  },
  "title": "Coupang Best Sellers Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON

{
  "actorSpecification": 1,
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Best sellers",
      "transformation": {
        "fields": [
          "productName",
          "price",
          "originalPrice",
          "discountRate",
          "unitPrice",
          "coupon",
          "rating",
          "reviewCount",
          "isRocket",
          "rank",
          "categoryName",
          "categories",
          "productUrl"
        ]
      }
    },
    "prices": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Prices",
      "transformation": {
        "fields": [
          "productId",
          "productName",
          "price",
          "originalPrice",
          "discountRate",
          "unitPrice",
          "coupon",
          "currency",
          "isRocket",
          "rank",
          "categoryName",
          "categories"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Coupang Best Sellers & Rocket Delivery Flags

Collect Coupang best sellers by category, Coupang's own keyword suggestions, or the Coupang category tree. The best-seller surface returns product identity, Korean-won pricing, discount, rating, review count, Rocket delivery, delivery promise, cashback, unit price, coupon and category breadcrumb data. No user proxy, cookie, or login is required; the actor selects its own Apify proxy route when Coupang blocks direct access.

Coupang's Akamai edge blocks keyword search, product-detail pages and review pages from non-Korean and datacenter IPs. Those modes are kept in the Mode dropdown for older saved tasks but are marked unavailable; they stop with a clear status message instead of returning an empty dataset. The actor ships the best-seller, keyword-suggestion and category-tree surfaces that work without user credentials.

What this actor does

Ranks the products on a Coupang best100 page from 1 to 30, with current price, original price, discount, rating, review count, Rocket delivery, delivery promise, cashback, unit price and coupon when Coupang publishes them.
Walks all 15 top-level categories with category=all for up to 450 unique products from the top-level pages.
Optionally walks a category's child best100 pages when includeSubcategories=true, stopping as soon as maxItems is reached.
Deduplicates variants by vendorItemId, then itemId, then productId plus price.
Returns Coupang's search-box suggestions for a list of keywords.
Returns the Coupang category tree with category IDs, names, levels, parent IDs, paths and URLs.
Keeps products tied to productId, itemId and vendorItemId, so variants are not merged by product ID alone.
Omits fields Coupang does not publish for a product rather than writing nulls or placeholders.

Output per best-seller product

Field	Description
`productId`	Coupang product ID
`itemId`	Coupang item ID for the exact listing
`vendorItemId`	Coupang vendor-item ID for the exact seller option
`productName`	Product name as shown on Coupang
`price`	Current price in KRW
`originalPrice`	Original price in KRW, when higher than the current price
`discountRate`	Discount percentage, when greater than zero
`unitPrice`	Unit-price text, when Coupang shows one
`coupon`	Coupon object or text, when Coupang shows one
`rating`	Average star rating, when shown
`reviewCount`	Number of reviews, when shown
`imageUrl`	Product image URL
`productUrl`	Direct Coupang product URL, preserving item and vendor-item IDs
`isRocket`	`true` when the card carries Coupang's Rocket badge
`isRocketFresh`	`true` only when the card's Rocket image is the Rocket Fresh badge
`isFreeShipping`	`true` only when the card carries Coupang's free-shipping badge
`deliveryPromise`	Coupang's delivery promise text, when shown
`cashbackText`	Coupang's cashback text, when shown
`cashback`	Cashback amount in KRW parsed from `cashbackText`
`isSponsored`	Whether the card is marked as sponsored
`isSoldOut`	Whether the card is marked as sold out
`rank`	Position on the best100 page, starting at 1
`categoryId`	Coupang best100 category ID that produced the row
`categoryName`	Human-readable category name
`categories`	Category breadcrumb path from the Coupang category tree, when available
`currency`	`KRW`
`source`	`bestSellers`
`recordType`	`product`
`scrapedAt`	UTC timestamp when the record was scraped

Existing compatibility fields brand, seller, description and categories remain in the output schema. brand, seller and description are not published on the best100 page, so they are omitted from best-seller records rather than fabricated.

Input

Field	Type	Default	Description
`mode`	select	`bestSellers`	Best sellers, keyword suggestions, category tree, or a legacy mode. Search, product details and reviews are marked unavailable and stop with a clear status.
`category`	select	`electronics`	Best-seller category. Includes all 15 top-level categories plus All categories. Each page returns up to 30 products.
`categoryId`	string	–	Optional numeric Coupang best100 category ID or `/np/categories/` URL. Overrides the category dropdown.
`includeSubcategories`	boolean	`false`	Continue into child best100 pages until Maximum products is reached. Small `maxItems` values usually need no child pages.
`minPrice`	integer	–	Minimum price in KRW.
`maxPrice`	integer	–	Maximum price in KRW.
`rocketOnly`	boolean	`false`	Keep only products with Coupang's Rocket delivery badge.
`minRating`	number	–	Keep only products rated at least this many stars. Products without a rating are skipped.
`maxItems`	integer	`20`	Maximum products to return. One best100 page has at most 30.
`searchQueries`	string list	`[]`	Keywords for keyword suggestions. Korean or English.
`maxSuggestions`	integer	`10`	Maximum suggestions per keyword (1-10).
`maxCategories`	integer	`1000`	Maximum category nodes to return (1-5000). The full tree currently has about 2,740 nodes.

Example: best sellers in electronics

{
  "mode": "bestSellers",
  "category": "electronics",
  "maxItems": 30
}

Example: more than 30 rows with child categories

{
  "mode": "bestSellers",
  "category": "electronics",
  "includeSubcategories": true,
  "maxItems": 100
}

Example: keyword suggestions

{
  "mode": "keywordSuggestions",
  "searchQueries": ["laptop", "무선 이어폰"],
  "maxSuggestions": 10
}

Example: category tree

{
  "mode": "categories",
  "maxCategories": 5000
}

Example: legacy mode alias

{
  "mode": "categoryProducts",
  "category": "electronics",
  "maxItems": 30
}

categoryProducts is a visible legacy alias that returns best sellers. Legacy keyword, sortBy and productIds keys are tolerated and mapped or ignored as appropriate; they are not shown as separate current inputs.

Use cases

Best-seller tracking — see which products Coupang ranks highest in a category and how their prices and ratings change.
Price monitoring — track current price, original price, discount, unit price and coupon availability.
Delivery analysis — compare Rocket, Rocket Fresh, free-shipping and delivery-promise coverage.
Assortment research — inspect brand and category composition across Coupang's top-level departments.
Search-box research — collect Coupang's own keyword suggestions for content, SEO and merchandising work.
Category mapping — export the live category tree with IDs, parent IDs, paths and URLs.

Limits and behavior

One Coupang best100 page exposes at most 30 products. The actor pages into child categories only when includeSubcategories=true and maxItems is still unmet.
category=all walks the 15 top-level pages and returns at most 450 unique products; enable child fan-out to go deeper.
Keyword search, product-detail pages and reviews are blocked without a Korean residential proxy. They are not claimed as working and fail with a clear status message.
Keyword suggestions are capped at 10 per query by Coupang. Multiple queries can be supplied for broader coverage.
The category tree currently contains about 2,740 nodes. Raise maxCategories to 5000 to export all of them.
The actor uses its own hardcoded Apify proxy route when Coupang's edge blocks a request. Users do not configure a proxy.
A blocked or parse-failed run fails honestly; it never exits successfully with an empty dataset.

FAQ

Do I need a Coupang account, cookie or proxy? No. The best-seller, keyword-suggestion and category-tree modes work without user credentials or proxy setup. The actor handles any required proxy route itself.

Why can't I search Coupang by keyword? Coupang's search page is protected by Akamai and refuses non-Korean and datacenter traffic. This deployment ships the working best-seller, keyword-suggestion and category-tree surfaces instead of claiming a search path it cannot fill.

How do I get more than 30 products from one category? Set includeSubcategories=true and raise maxItems. The actor reads child best100 pages in order until the limit is met.

Why are some fields like brand or seller missing? Those fields are not published on Coupang's best100 cards. The actor omits them rather than inventing values. Product-detail enrichment is unavailable without the blocked detail page.

Why is categories empty sometimes? The breadcrumb comes from Coupang's category tree. If the tree cannot be fetched on a run, products are still returned and the run status says the breadcrumb was unavailable.

What currency are prices in? Korean Won (KRW), matching Coupang.

How do I find a category ID? Category IDs are the numeric value in a Coupang category URL, e.g. 178155 in https://www.coupang.com/np/categories/178155.

Is this affiliated with Coupang? No. This actor reads Coupang's public pages and is not affiliated with, endorsed by, or sponsored by Coupang.

Data source

Coupang's public best100 category pages, keyword suggestion endpoint and category tree. No private API, partner API, user login or user-supplied credentials are used.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build MNYO7cbYtIvVMGilg. Documentation is regenerated from the default published build; private drafts are not included.