Coupang APItw.coupang.com ↗
Access Coupang Taiwan product search, details, brand listings, Rocket Delivery items, and category navigation via 6 structured API endpoints.
What is the Coupang API?
The Coupang Taiwan API covers 6 endpoints for retrieving product data from tw.coupang.com, including search, category browsing, brand filtering, and Rocket Delivery discovery. The get_product_detail endpoint returns up to 9 fields per product — name, brand, price, original price, rating, review count, images, description, and currency — identified by a product ID obtainable from any search or listing result.
curl -X GET 'https://api.parse.bot/scraper/98980d33-1b01-414b-842f-f120076bd9dd/search_products?page=1&query=coffee&sorter=scoreDesc' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace tw-coupang-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.coupang_taiwan_scraper_api import CoupangTW, Sorter, ProductNotFound
coupang = CoupangTW()
# Search for coffee products sorted by price (ascending), capped at 5 items
for product in coupang.products.search(query="coffee", sort=Sorter.PRICE_ASC, limit=5):
print(product.name, product.price, product.delivery_badge)
# Drill into one product's full details
first = coupang.products.search(query="ramen", limit=1).first()
if first:
detail = first.details()
print(detail.name, detail.brand, detail.price, detail.currency, detail.rating)
# Browse products by brand
for item in coupang.products.by_brand(brand_name="NONGSHIM", sort=Sorter.SCORE_DESC, limit=3):
print(item.name, item.price, item.unit_price_raw)
# Discover Rocket Delivery items
for rocket_item in coupang.products.rocket_delivery(query="tea", limit=3):
print(rocket_item.name, rocket_item.price, rocket_item.url)
# Typed error handling for a missing product
try:
missing = coupang.product(product_id="000000000000000")
missing.details()
except ProductNotFound as exc:
print(f"Product not found: {exc.product_id}")
# List homepage categories
for cat in coupang.categories.list(limit=5):
print(cat.name, cat.url)
print("exercised: products.search / details / by_brand / rocket_delivery / categories.list")
Search for products by keyword on Coupang Taiwan. Returns up to 36 products per page with product names, prices, delivery badges, and unit pricing information. Paginates via integer page number.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'ramen', 'laptop', 'coffee'). |
| sorter | string | Sorting option. |
{
"type": "object",
"fields": {
"products": "array of product objects with product_id, name, price, unit_price_raw, delivery_badge, and url"
},
"sample": {
"data": {
"products": [
{
"url": "https://www.tw.coupang.com/vp/products/265257129820171",
"name": "GEORGIA 喬亞 滴濾無糖黑咖啡, 350ml, 24瓶",
"price": 299,
"product_id": "265257129820171",
"delivery_badge": "Rocket",
"unit_price_raw": "(100ml每 $3)"
}
]
},
"status": "success"
}
}About the Coupang API
Product Search and Detail
The search_products endpoint accepts a required query string and an optional integer page parameter, returning up to 36 products per page. Each result includes product_id, name, price, unit_price_raw, delivery_badge, and url. The sorter parameter is available on search, category, brand, and Rocket Delivery endpoints for consistent result ordering. To go deeper on any listing, pass the product_id to get_product_detail, which returns structured fields including brand, rating out of 5, review_count, original_price before discount, an images array, and currency (typically TWD).
Browsing by Category and Brand
get_category_products accepts a category_id string such as 食品飲料-541149 and returns a paginated products array in the same shape as search results. get_brand_products takes a brand_name string (e.g. NONGSHIM or AGF MAXIM) and runs a brand-scoped query, also returning the standard product array. Both endpoints support page and sorter parameters.
Rocket Delivery and Homepage Navigation
get_rocket_delivery_products filters the catalog to items available for fast delivery. The query parameter is optional — omitting it returns all Rocket Delivery items; supplying a keyword narrows to matching products. Each result carries a delivery_badge field that confirms the delivery type. get_homepage_featured requires no inputs and returns a featured_categories array of objects with name and url, reflecting the main navigation bar of the Coupang Taiwan homepage.
The Coupang API is a managed, monitored endpoint for tw.coupang.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when tw.coupang.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official tw.coupang.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Price monitoring: track
priceandoriginal_pricefields across product IDs to detect discounts over time. - Brand catalog extraction: use
get_brand_productsto compile a full product list for a specific brand on Coupang Taiwan. - Rocket Delivery filtering: use
get_rocket_delivery_productswith a keyword to find fast-shipping options for a product category. - Rating and review aggregation: pull
ratingandreview_countfromget_product_detailacross multiple products for competitive analysis. - Category navigation mapping: call
get_homepage_featuredto programmatically enumerate Coupang Taiwan's top-level category structure. - Unit price comparison: compare
unit_price_rawvalues across search results to identify the best-value listings for commodity products. - Localized e-commerce research: gather TWD-denominated pricing and delivery badge data for Taiwan market entry or competitive benchmarking.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Coupang have an official developer API?+
What does `get_product_detail` return beyond what search results include?+
search_products and the other listing endpoints return product_id, name, price, unit_price_raw, delivery_badge, and url. get_product_detail adds brand, rating, review_count, images (an array of URLs), description, original_price, and currency. Use it when you need the full product record rather than a summary row.Are seller information or stock/inventory fields available?+
How does pagination work across the listing endpoints?+
search_products, get_category_products, get_brand_products, and get_rocket_delivery_products all accept an integer page parameter. search_products returns up to 36 products per page. The get_category_products and brand endpoints follow the same pagination pattern but the per-page ceiling depends on what the category or brand listing renders.Can the API return product reviews or review text?+
get_product_detail returns review_count and a numeric rating, but individual review text, reviewer names, and review dates are not exposed. You can fork the API on Parse and revise it to add a reviews endpoint that returns per-review content for a given product ID.