Use Coupang Best Sellers & Rocket Delivery Flags with Python

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.

1. Choose the data you need

Review the published README for supported collection modes, examples, and limits. The recipe below uses the current published input definition.

2. Prepare a source-based input

This JSON contains published prefills and required-field defaults. Review every value for your task before running it; it is not a promise of successful collection.

{
  "category": "electronics",
  "includeSubcategories": false,
  "maxCategories": 50,
  "maxItems": 3,
  "maxSuggestions": 10,
  "mode": "bestSellers",
  "rocketOnly": false,
  "searchQueries": []
}

Download input.example.json and save your reviewed copy as input.json.

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.

3. Start an Actor run

Set APIFY_TOKEN in your environment. Python 3.10 or newer is sufficient; this recipe uses no third-party packages.

Execution may incur charges. Review current pricing on Apify. The request asks for a 120-second timeout and a charge limit; these settings are subject to Apify’s pricing and do not guarantee an all-inclusive spending cap.

import json
import os
import urllib.request

# Save the schema-derived example as input.json; review and edit it first.
with open("input.json", encoding="utf-8") as stream:
    actor_input = json.load(stream)

token = os.environ["APIFY_TOKEN"]
request = urllib.request.Request(
    "https://api.apify.com/v2/acts/L6MWvn6dWdGRRNalz/runs?timeout=120&maxTotalChargeUsd=0.50",
    data=json.dumps(actor_input).encode("utf-8"),
    headers={"Authorization": "Bearer " + token, "Content-Type": "application/json"},
    method="POST",
)
# This starts a potentially billable run. Do not automatically retry this POST.
with urllib.request.urlopen(request, timeout=40) as response:
    run = json.load(response)["data"]
print("Run ID:", run["id"])
print("Status:", run["status"])
# Inspect and download results in Apify Console once the run succeeds.

4. Inspect the actual results

Open the run in Apify Console and wait for a successful completion. Use the published output schema to locate results and the dataset schema to understand declared views. Missing or optional record fields must not be treated as guaranteed values.

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.

Questions before you run

Which inputs are required?

The published required fields are mode

What does this guide verify?

The fields, prefills, and schema links are rendered from the published build. This is a usage recipe, not a paid live extraction test. Source availability and collection results can vary.

What if the run request times out?

Check Apify Console before retrying. The first request may already have created a run. Do not automatically repeat a run-creation POST.

Open on Apify Full Actor reference

Generated from source build MNYO7cbYtIvVMGilg and its README and schemas. Source changes regenerate this guide; no third-party editorial claims are inferred.