{
  "data": {
    "id": "MNYO7cbYtIvVMGilg",
    "actId": "L6MWvn6dWdGRRNalz",
    "userId": "IYgBDiXtHOijAaUel",
    "startedAt": "2026-11-05T07:19:42.692Z",
    "finishedAt": "2026-11-05T07:19:53.250Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 10452,
      "runTimeSecs": 10.452,
      "computeUnits": 0.011613333333333333,
      "imageSizeBytes": 359313920
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Coupang Best Sellers Scraper Input\",\n  \"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.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"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.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"bestSellers\",\n        \"keywordSuggestions\",\n        \"categories\",\n        \"search\",\n        \"productDetails\",\n        \"reviews\",\n        \"categoryProducts\"\n      ],\n      \"enumTitles\": [\n        \"Best sellers by category\",\n        \"Keyword suggestions\",\n        \"Category tree\",\n        \"Search by keyword (unavailable without a proxy)\",\n        \"Product details (unavailable without a proxy)\",\n        \"Product reviews (unavailable without a proxy)\",\n        \"Category products (legacy alias for best sellers)\"\n      ],\n      \"default\": \"bestSellers\",\n      \"prefill\": \"bestSellers\"\n    },\n    \"category\": {\n      \"title\": \"Category\",\n      \"type\": \"string\",\n      \"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.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"electronics\",\n        \"fashion\",\n        \"beauty\",\n        \"baby\",\n        \"food\",\n        \"kitchen\",\n        \"household\",\n        \"home\",\n        \"sports\",\n        \"automotive\",\n        \"books\",\n        \"toys\",\n        \"office\",\n        \"pets\",\n        \"health\",\n        \"all\"\n      ],\n      \"enumTitles\": [\n        \"Electronics and digital\",\n        \"Fashion\",\n        \"Beauty\",\n        \"Baby and kids\",\n        \"Food\",\n        \"Kitchen\",\n        \"Household\",\n        \"Home and interior\",\n        \"Sports and leisure\",\n        \"Automotive\",\n        \"Books and media\",\n        \"Toys and hobbies\",\n        \"Stationery and office\",\n        \"Pet supplies\",\n        \"Health and supplements\",\n        \"All categories (up to 450 products)\"\n      ],\n      \"default\": \"electronics\",\n      \"prefill\": \"electronics\",\n      \"sectionCaption\": \"Best sellers\",\n      \"sectionDescription\": \"Pick a category. Coupang's best100 page exposes 30 products per category.\"\n    },\n    \"categoryId\": {\n      \"title\": \"Advanced category ID\",\n      \"type\": \"string\",\n      \"description\": \"Optional numeric Coupang best100 category ID or /np/categories/ URL. Overrides the category dropdown.\",\n      \"editor\": \"textfield\"\n    },\n    \"includeSubcategories\": {\n      \"title\": \"Include subcategories\",\n      \"type\": \"boolean\",\n      \"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.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"minPrice\": {\n      \"title\": \"Minimum price (KRW)\",\n      \"type\": \"integer\",\n      \"description\": \"Only return products at or above this price in Korean won.\",\n      \"minimum\": 0,\n      \"maximum\": 100000000,\n      \"sectionCaption\": \"Filters\",\n      \"sectionDescription\": \"Optional filters applied to the best-seller products.\"\n    },\n    \"maxPrice\": {\n      \"title\": \"Maximum price (KRW)\",\n      \"type\": \"integer\",\n      \"description\": \"Only return products at or below this price in Korean won.\",\n      \"minimum\": 0,\n      \"maximum\": 100000000\n    },\n    \"rocketOnly\": {\n      \"title\": \"Rocket delivery only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only products with Coupang's Rocket delivery badge.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"minRating\": {\n      \"title\": \"Minimum rating\",\n      \"type\": \"number\",\n      \"description\": \"Keep only products rated at least this many stars. Products without a rating are skipped.\",\n      \"minimum\": 0,\n      \"maximum\": 5\n    },\n    \"maxItems\": {\n      \"title\": \"Maximum products\",\n      \"type\": \"integer\",\n      \"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.\",\n      \"minimum\": 1,\n      \"maximum\": 5000,\n      \"default\": 20,\n      \"prefill\": 3,\n      \"sectionCaption\": \"Limits\",\n      \"sectionDescription\": \"The daily test uses 3 products. Coupang best100 exposes 30 products per category.\"\n    },\n    \"searchQueries\": {\n      \"title\": \"Keywords\",\n      \"type\": \"array\",\n      \"description\": \"Keywords for keyword suggestions (mode=keywordSuggestions). Korean or English.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": [],\n      \"sectionCaption\": \"Keyword suggestions\",\n      \"sectionDescription\": \"Coupang's own search-box suggestions. No proxy required.\"\n    },\n    \"maxSuggestions\": {\n      \"title\": \"Suggestions per keyword\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum suggestions to return per keyword.\",\n      \"minimum\": 1,\n      \"maximum\": 10,\n      \"default\": 10,\n      \"prefill\": 10\n    },\n    \"maxCategories\": {\n      \"title\": \"Maximum categories\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum category nodes to return from the Coupang category tree.\",\n      \"minimum\": 1,\n      \"maximum\": 5000,\n      \"default\": 1000,\n      \"prefill\": 50,\n      \"sectionCaption\": \"Category tree\",\n      \"sectionDescription\": \"The Coupang category tree with IDs and URLs. No proxy required.\"\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Coupang Best Sellers & Rocket Delivery Flags\n\nCollect 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.\n\nCoupang'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.\n\n## What this actor does\n\n- 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.\n- Walks all 15 top-level categories with `category=all` for up to 450 unique products from the top-level pages.\n- Optionally walks a category's child best100 pages when `includeSubcategories=true`, stopping as soon as `maxItems` is reached.\n- Deduplicates variants by `vendorItemId`, then `itemId`, then `productId` plus price.\n- Returns Coupang's search-box suggestions for a list of keywords.\n- Returns the Coupang category tree with category IDs, names, levels, parent IDs, paths and URLs.\n- Keeps products tied to `productId`, `itemId` and `vendorItemId`, so variants are not merged by product ID alone.\n- Omits fields Coupang does not publish for a product rather than writing nulls or placeholders.\n\n## Output per best-seller product\n\n| Field | Description |\n|---|---|\n| `productId` | Coupang product ID |\n| `itemId` | Coupang item ID for the exact listing |\n| `vendorItemId` | Coupang vendor-item ID for the exact seller option |\n| `productName` | Product name as shown on Coupang |\n| `price` | Current price in KRW |\n| `originalPrice` | Original price in KRW, when higher than the current price |\n| `discountRate` | Discount percentage, when greater than zero |\n| `unitPrice` | Unit-price text, when Coupang shows one |\n| `coupon` | Coupon object or text, when Coupang shows one |\n| `rating` | Average star rating, when shown |\n| `reviewCount` | Number of reviews, when shown |\n| `imageUrl` | Product image URL |\n| `productUrl` | Direct Coupang product URL, preserving item and vendor-item IDs |\n| `isRocket` | `true` when the card carries Coupang's Rocket badge |\n| `isRocketFresh` | `true` only when the card's Rocket image is the Rocket Fresh badge |\n| `isFreeShipping` | `true` only when the card carries Coupang's free-shipping badge |\n| `deliveryPromise` | Coupang's delivery promise text, when shown |\n| `cashbackText` | Coupang's cashback text, when shown |\n| `cashback` | Cashback amount in KRW parsed from `cashbackText` |\n| `isSponsored` | Whether the card is marked as sponsored |\n| `isSoldOut` | Whether the card is marked as sold out |\n| `rank` | Position on the best100 page, starting at 1 |\n| `categoryId` | Coupang best100 category ID that produced the row |\n| `categoryName` | Human-readable category name |\n| `categories` | Category breadcrumb path from the Coupang category tree, when available |\n| `currency` | `KRW` |\n| `source` | `bestSellers` |\n| `recordType` | `product` |\n| `scrapedAt` | UTC timestamp when the record was scraped |\n\nExisting 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.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `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. |\n| `category` | select | `electronics` | Best-seller category. Includes all 15 top-level categories plus All categories. Each page returns up to 30 products. |\n| `categoryId` | string | – | Optional numeric Coupang best100 category ID or `/np/categories/` URL. Overrides the category dropdown. |\n| `includeSubcategories` | boolean | `false` | Continue into child best100 pages until Maximum products is reached. Small `maxItems` values usually need no child pages. |\n| `minPrice` | integer | – | Minimum price in KRW. |\n| `maxPrice` | integer | – | Maximum price in KRW. |\n| `rocketOnly` | boolean | `false` | Keep only products with Coupang's Rocket delivery badge. |\n| `minRating` | number | – | Keep only products rated at least this many stars. Products without a rating are skipped. |\n| `maxItems` | integer | `20` | Maximum products to return. One best100 page has at most 30. |\n| `searchQueries` | string list | `[]` | Keywords for keyword suggestions. Korean or English. |\n| `maxSuggestions` | integer | `10` | Maximum suggestions per keyword (1-10). |\n| `maxCategories` | integer | `1000` | Maximum category nodes to return (1-5000). The full tree currently has about 2,740 nodes. |\n\n### Example: best sellers in electronics\n\n```json\n{\n  \"mode\": \"bestSellers\",\n  \"category\": \"electronics\",\n  \"maxItems\": 30\n}\n```\n\n### Example: more than 30 rows with child categories\n\n```json\n{\n  \"mode\": \"bestSellers\",\n  \"category\": \"electronics\",\n  \"includeSubcategories\": true,\n  \"maxItems\": 100\n}\n```\n\n### Example: keyword suggestions\n\n```json\n{\n  \"mode\": \"keywordSuggestions\",\n  \"searchQueries\": [\"laptop\", \"무선 이어폰\"],\n  \"maxSuggestions\": 10\n}\n```\n\n### Example: category tree\n\n```json\n{\n  \"mode\": \"categories\",\n  \"maxCategories\": 5000\n}\n```\n\n### Example: legacy mode alias\n\n```json\n{\n  \"mode\": \"categoryProducts\",\n  \"category\": \"electronics\",\n  \"maxItems\": 30\n}\n```\n\n`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.\n\n## Use cases\n\n- **Best-seller tracking** — see which products Coupang ranks highest in a category and how their prices and ratings change.\n- **Price monitoring** — track current price, original price, discount, unit price and coupon availability.\n- **Delivery analysis** — compare Rocket, Rocket Fresh, free-shipping and delivery-promise coverage.\n- **Assortment research** — inspect brand and category composition across Coupang's top-level departments.\n- **Search-box research** — collect Coupang's own keyword suggestions for content, SEO and merchandising work.\n- **Category mapping** — export the live category tree with IDs, parent IDs, paths and URLs.\n\n## Limits and behavior\n\n- One Coupang best100 page exposes at most **30 products**. The actor pages into child categories only when `includeSubcategories=true` and `maxItems` is still unmet.\n- `category=all` walks the 15 top-level pages and returns at most **450 unique products**; enable child fan-out to go deeper.\n- 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.\n- Keyword suggestions are capped at 10 per query by Coupang. Multiple queries can be supplied for broader coverage.\n- The category tree currently contains about 2,740 nodes. Raise `maxCategories` to 5000 to export all of them.\n- The actor uses its own hardcoded Apify proxy route when Coupang's edge blocks a request. Users do not configure a proxy.\n- A blocked or parse-failed run fails honestly; it never exits successfully with an empty dataset.\n\n## FAQ\n\n**Do I need a Coupang account, cookie or proxy?**\nNo. The best-seller, keyword-suggestion and category-tree modes work without user credentials or proxy setup. The actor handles any required proxy route itself.\n\n**Why can't I search Coupang by keyword?**\nCoupang'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.\n\n**How do I get more than 30 products from one category?**\nSet `includeSubcategories=true` and raise `maxItems`. The actor reads child best100 pages in order until the limit is met.\n\n**Why are some fields like `brand` or `seller` missing?**\nThose 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.\n\n**Why is `categories` empty sometimes?**\nThe 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.\n\n**What currency are prices in?**\nKorean Won (KRW), matching Coupang.\n\n**How do I find a category ID?**\nCategory IDs are the numeric value in a Coupang category URL, e.g. `178155` in `https://www.coupang.com/np/categories/178155`.\n\n**Is this affiliated with Coupang?**\nNo. This actor reads Coupang's public pages and is not affiliated with, endorsed by, or sponsored by Coupang.\n\n## Data source\n\nCoupang's public best100 category pages, keyword suggestion endpoint and category tree. No private API, partner API, user login or user-supplied credentials are used.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "coupang-product-finder-with-rocket-delivery-flags",
      "title": "Coupang Best Sellers & Rocket Delivery Flags",
      "description": "Collect Coupang best sellers by category (30 products per page, optional child-category fan-out), Coupang keyword suggestions, or the Coupang category tree. Product records include price, unit price, coupon, rating, Rocket delivery, and a category breadcrumb. No proxy, cookies, or login required for these modes.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Coupang Best Sellers & Rocket Delivery Flags\n\nCollect 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.\n\nCoupang'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.\n\n## What this actor does\n\n- 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.\n- Walks all 15 top-level categories with `category=all` for up to 450 unique products from the top-level pages.\n- Optionally walks a category's child best100 pages when `includeSubcategories=true`, stopping as soon as `maxItems` is reached.\n- Deduplicates variants by `vendorItemId`, then `itemId`, then `productId` plus price.\n- Returns Coupang's search-box suggestions for a list of keywords.\n- Returns the Coupang category tree with category IDs, names, levels, parent IDs, paths and URLs.\n- Keeps products tied to `productId`, `itemId` and `vendorItemId`, so variants are not merged by product ID alone.\n- Omits fields Coupang does not publish for a product rather than writing nulls or placeholders.\n\n## Output per best-seller product\n\n| Field | Description |\n|---|---|\n| `productId` | Coupang product ID |\n| `itemId` | Coupang item ID for the exact listing |\n| `vendorItemId` | Coupang vendor-item ID for the exact seller option |\n| `productName` | Product name as shown on Coupang |\n| `price` | Current price in KRW |\n| `originalPrice` | Original price in KRW, when higher than the current price |\n| `discountRate` | Discount percentage, when greater than zero |\n| `unitPrice` | Unit-price text, when Coupang shows one |\n| `coupon` | Coupon object or text, when Coupang shows one |\n| `rating` | Average star rating, when shown |\n| `reviewCount` | Number of reviews, when shown |\n| `imageUrl` | Product image URL |\n| `productUrl` | Direct Coupang product URL, preserving item and vendor-item IDs |\n| `isRocket` | `true` when the card carries Coupang's Rocket badge |\n| `isRocketFresh` | `true` only when the card's Rocket image is the Rocket Fresh badge |\n| `isFreeShipping` | `true` only when the card carries Coupang's free-shipping badge |\n| `deliveryPromise` | Coupang's delivery promise text, when shown |\n| `cashbackText` | Coupang's cashback text, when shown |\n| `cashback` | Cashback amount in KRW parsed from `cashbackText` |\n| `isSponsored` | Whether the card is marked as sponsored |\n| `isSoldOut` | Whether the card is marked as sold out |\n| `rank` | Position on the best100 page, starting at 1 |\n| `categoryId` | Coupang best100 category ID that produced the row |\n| `categoryName` | Human-readable category name |\n| `categories` | Category breadcrumb path from the Coupang category tree, when available |\n| `currency` | `KRW` |\n| `source` | `bestSellers` |\n| `recordType` | `product` |\n| `scrapedAt` | UTC timestamp when the record was scraped |\n\nExisting 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.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `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. |\n| `category` | select | `electronics` | Best-seller category. Includes all 15 top-level categories plus All categories. Each page returns up to 30 products. |\n| `categoryId` | string | – | Optional numeric Coupang best100 category ID or `/np/categories/` URL. Overrides the category dropdown. |\n| `includeSubcategories` | boolean | `false` | Continue into child best100 pages until Maximum products is reached. Small `maxItems` values usually need no child pages. |\n| `minPrice` | integer | – | Minimum price in KRW. |\n| `maxPrice` | integer | – | Maximum price in KRW. |\n| `rocketOnly` | boolean | `false` | Keep only products with Coupang's Rocket delivery badge. |\n| `minRating` | number | – | Keep only products rated at least this many stars. Products without a rating are skipped. |\n| `maxItems` | integer | `20` | Maximum products to return. One best100 page has at most 30. |\n| `searchQueries` | string list | `[]` | Keywords for keyword suggestions. Korean or English. |\n| `maxSuggestions` | integer | `10` | Maximum suggestions per keyword (1-10). |\n| `maxCategories` | integer | `1000` | Maximum category nodes to return (1-5000). The full tree currently has about 2,740 nodes. |\n\n### Example: best sellers in electronics\n\n```json\n{\n  \"mode\": \"bestSellers\",\n  \"category\": \"electronics\",\n  \"maxItems\": 30\n}\n```\n\n### Example: more than 30 rows with child categories\n\n```json\n{\n  \"mode\": \"bestSellers\",\n  \"category\": \"electronics\",\n  \"includeSubcategories\": true,\n  \"maxItems\": 100\n}\n```\n\n### Example: keyword suggestions\n\n```json\n{\n  \"mode\": \"keywordSuggestions\",\n  \"searchQueries\": [\"laptop\", \"무선 이어폰\"],\n  \"maxSuggestions\": 10\n}\n```\n\n### Example: category tree\n\n```json\n{\n  \"mode\": \"categories\",\n  \"maxCategories\": 5000\n}\n```\n\n### Example: legacy mode alias\n\n```json\n{\n  \"mode\": \"categoryProducts\",\n  \"category\": \"electronics\",\n  \"maxItems\": 30\n}\n```\n\n`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.\n\n## Use cases\n\n- **Best-seller tracking** — see which products Coupang ranks highest in a category and how their prices and ratings change.\n- **Price monitoring** — track current price, original price, discount, unit price and coupon availability.\n- **Delivery analysis** — compare Rocket, Rocket Fresh, free-shipping and delivery-promise coverage.\n- **Assortment research** — inspect brand and category composition across Coupang's top-level departments.\n- **Search-box research** — collect Coupang's own keyword suggestions for content, SEO and merchandising work.\n- **Category mapping** — export the live category tree with IDs, parent IDs, paths and URLs.\n\n## Limits and behavior\n\n- One Coupang best100 page exposes at most **30 products**. The actor pages into child categories only when `includeSubcategories=true` and `maxItems` is still unmet.\n- `category=all` walks the 15 top-level pages and returns at most **450 unique products**; enable child fan-out to go deeper.\n- 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.\n- Keyword suggestions are capped at 10 per query by Coupang. Multiple queries can be supplied for broader coverage.\n- The category tree currently contains about 2,740 nodes. Raise `maxCategories` to 5000 to export all of them.\n- The actor uses its own hardcoded Apify proxy route when Coupang's edge blocks a request. Users do not configure a proxy.\n- A blocked or parse-failed run fails honestly; it never exits successfully with an empty dataset.\n\n## FAQ\n\n**Do I need a Coupang account, cookie or proxy?**\nNo. The best-seller, keyword-suggestion and category-tree modes work without user credentials or proxy setup. The actor handles any required proxy route itself.\n\n**Why can't I search Coupang by keyword?**\nCoupang'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.\n\n**How do I get more than 30 products from one category?**\nSet `includeSubcategories=true` and raise `maxItems`. The actor reads child best100 pages in order until the limit is met.\n\n**Why are some fields like `brand` or `seller` missing?**\nThose 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.\n\n**Why is `categories` empty sometimes?**\nThe 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.\n\n**What currency are prices in?**\nKorean Won (KRW), matching Coupang.\n\n**How do I find a category ID?**\nCategory IDs are the numeric value in a Coupang category URL, e.g. `178155` in `https://www.coupang.com/np/categories/178155`.\n\n**Is this affiliated with Coupang?**\nNo. This actor reads Coupang's public pages and is not affiliated with, endorsed by, or sponsored by Coupang.\n\n## Data source\n\nCoupang's public best100 category pages, keyword suggestion endpoint and category tree. No private API, partner API, user login or user-supplied credentials are used.\n",
      "input": {
        "title": "Coupang Best Sellers Scraper Input",
        "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.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "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)"
            ],
            "default": "bestSellers",
            "prefill": "bestSellers"
          },
          "category": {
            "title": "Category",
            "type": "string",
            "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)"
            ],
            "default": "electronics",
            "prefill": "electronics",
            "sectionCaption": "Best sellers",
            "sectionDescription": "Pick a category. Coupang's best100 page exposes 30 products per category."
          },
          "categoryId": {
            "title": "Advanced category ID",
            "type": "string",
            "description": "Optional numeric Coupang best100 category ID or /np/categories/ URL. Overrides the category dropdown.",
            "editor": "textfield"
          },
          "includeSubcategories": {
            "title": "Include subcategories",
            "type": "boolean",
            "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.",
            "default": false,
            "prefill": false
          },
          "minPrice": {
            "title": "Minimum price (KRW)",
            "type": "integer",
            "description": "Only return products at or above this price in Korean won.",
            "minimum": 0,
            "maximum": 100000000,
            "sectionCaption": "Filters",
            "sectionDescription": "Optional filters applied to the best-seller products."
          },
          "maxPrice": {
            "title": "Maximum price (KRW)",
            "type": "integer",
            "description": "Only return products at or below this price in Korean won.",
            "minimum": 0,
            "maximum": 100000000
          },
          "rocketOnly": {
            "title": "Rocket delivery only",
            "type": "boolean",
            "description": "Keep only products with Coupang's Rocket delivery badge.",
            "default": false,
            "prefill": false
          },
          "minRating": {
            "title": "Minimum rating",
            "type": "number",
            "description": "Keep only products rated at least this many stars. Products without a rating are skipped.",
            "minimum": 0,
            "maximum": 5
          },
          "maxItems": {
            "title": "Maximum products",
            "type": "integer",
            "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.",
            "minimum": 1,
            "maximum": 5000,
            "default": 20,
            "prefill": 3,
            "sectionCaption": "Limits",
            "sectionDescription": "The daily test uses 3 products. Coupang best100 exposes 30 products per category."
          },
          "searchQueries": {
            "title": "Keywords",
            "type": "array",
            "description": "Keywords for keyword suggestions (mode=keywordSuggestions). Korean or English.",
            "editor": "stringList",
            "default": [],
            "prefill": [],
            "sectionCaption": "Keyword suggestions",
            "sectionDescription": "Coupang's own search-box suggestions. No proxy required."
          },
          "maxSuggestions": {
            "title": "Suggestions per keyword",
            "type": "integer",
            "description": "Maximum suggestions to return per keyword.",
            "minimum": 1,
            "maximum": 10,
            "default": 10,
            "prefill": 10
          },
          "maxCategories": {
            "title": "Maximum categories",
            "type": "integer",
            "description": "Maximum category nodes to return from the Coupang category tree.",
            "minimum": 1,
            "maximum": 5000,
            "default": 1000,
            "prefill": 50,
            "sectionCaption": "Category tree",
            "sectionDescription": "The Coupang category tree with IDs and URLs. No proxy required."
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Coupang Best Sellers Output",
        "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": {
          "products": {
            "type": "string",
            "title": "Best-seller products",
            "description": "Product records from Coupang best100 (recordType=product), including price, unit price, coupon, rating, Rocket delivery, and categories breadcrumb.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          },
          "prices": {
            "type": "string",
            "title": "Prices",
            "description": "Product records with current price, original price, unit price, coupon, discount, rating, Rocket flag, and categories breadcrumb.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          },
          "categories": {
            "type": "string",
            "title": "Category tree",
            "description": "Category records from the Coupang category tree (recordType=category).",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          },
          "keywordSuggestions": {
            "type": "string",
            "title": "Keyword suggestions",
            "description": "Keyword suggestion records (recordType=keywordSuggestion).",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Best sellers",
              "transformation": {
                "fields": [
                  "productName",
                  "price",
                  "originalPrice",
                  "discountRate",
                  "unitPrice",
                  "coupon",
                  "rating",
                  "reviewCount",
                  "isRocket",
                  "rank",
                  "categoryName",
                  "categories",
                  "productUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            },
            "prices": {
              "title": "Prices",
              "transformation": {
                "fields": [
                  "productId",
                  "productName",
                  "price",
                  "originalPrice",
                  "discountRate",
                  "unitPrice",
                  "coupon",
                  "currency",
                  "isRocket",
                  "rank",
                  "categoryName",
                  "categories"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {},
      "defaultRunOptions": {
        "build": "latest",
        "timeoutSecs": 3600,
        "memoryMbytes": 1024
      }
    },
    "buildNumber": "1.0.2",
    "imageDigest": "a70dbb346902b7d0d2d37dd4bff04badb95fc423c6bf440f39b5d0ec5c756282",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.011613333333333333
    }
  }
}