tw.coupang.com APItw.coupang.com ↗
Access Coupang Taiwan product search, pricing, brand listings, Rocket Delivery filters, and category browsing via 6 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/98980d33-1b01-414b-842f-f120076bd9dd/search_products?page=1&query=milk&sorter=scoreDesc' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Coupang Taiwan. Returns paginated results with product names, prices, delivery badges, and unit pricing information.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'ramen', 'laptop', 'coffee') |
| sorter | string | Sorting option. Accepted values: scoreDesc, priceAsc, priceDesc, salePriceDesc, latestDesc. |
{
"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/589999313436675",
"name": "MARUTAI 丸太 大分雞白湯拉麵 2人份 186g, 1包",
"price": 73,
"product_id": "589999313436675",
"delivery_badge": "Rocket",
"unit_price_raw": "(100g每 $39)"
}
]
},
"status": "success"
}
}About the tw.coupang.com API
The Coupang Taiwan API covers 6 endpoints for querying products, retrieving full product details, and browsing by category or brand on tw.coupang.com. The get_product_detail endpoint returns up to 9 fields per product — including rating, review_count, original_price, currency, and images — giving developers a complete picture of any individual listing. Pagination and sorting are supported across most endpoints.
Search, Browse, and Filter Products
The search_products endpoint accepts a query string and an optional sorter parameter with five accepted values: scoreDesc, priceAsc, priceDesc, salePriceDesc, and latestDesc. Results are paginated via the page parameter and each product object in the response includes product_id, name, price, unit_price_raw, delivery_badge, and a direct url. The get_category_products endpoint works similarly but takes a category_id (formatted like 食品飲料-541149) instead of a keyword, letting you pull products from a known taxonomy node.
Product Detail and Brand Listings
get_product_detail takes a single product_id — obtainable from any search or browse result — and returns the full record: name, brand, price, original_price, currency (e.g. TWD), rating out of 5, review_count, an images array, and a description string. Fields like brand, rating, description, and review_count are nullable, reflecting real listing gaps on the source. get_brand_products performs a brand-scoped search using a brand_name string such as NONGSHIM or AGF MAXIM, returning the same product array shape as keyword search.
Rocket Delivery and Homepage Discovery
get_rocket_delivery_products filters results to items available for fast delivery. The query parameter is optional — omitting it returns the full Rocket Delivery catalog, while providing a keyword narrows it to matching items. get_homepage_featured takes no inputs and returns a featured_categories array of objects with name and url, making it useful for dynamically discovering current category structure without hardcoding category IDs.
Data Shape Notes
Prices are returned as strings alongside a currency field rather than as typed numerics, so downstream parsing should handle formatting variation. unit_price_raw appears in list results and is useful for per-unit price comparison across bulk or multi-pack listings. The delivery_badge field in list responses reflects delivery program labels shown on the site, such as Rocket Delivery markers.
- Track price changes for specific products using
get_product_detailand monitoringpricevsoriginal_priceover time. - Build a cross-brand price comparison tool using
get_brand_productswith multiple brand names and sorting bypriceAsc. - Aggregate Rocket Delivery inventory for a given category by combining
get_rocket_delivery_productswith keyword filters. - Populate a product catalog feed with names, images, ratings, and review counts via
get_product_detail. - Discover active homepage promotions and featured category structure using
get_homepage_featured. - Compare unit pricing across bulk and single-pack listings using the
unit_price_rawfield from search results. - Monitor category-level assortment changes by paginating through
get_category_productsfor a given category ID.
| 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 | 250 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 Taiwan have an official public developer API?+
What does `get_product_detail` return that list endpoints don't?+
get_product_detail adds brand, rating, review_count, images (an array of URLs), description, original_price, and currency — none of which appear in the product arrays returned by search or browse endpoints. List endpoints return only product_id, name, price, unit_price_raw, delivery_badge, and url.Are seller information or seller ratings available through the API?+
Can I retrieve user-written review text through the API?+
get_product_detail returns review_count and a numeric rating, but individual review content and reviewer metadata are not covered by any endpoint. You can fork this API on Parse and revise it to add a review-fetching endpoint.How does category ID formatting work for `get_category_products`?+
食品飲料-541149. You can discover valid category names and their URLs via get_homepage_featured, then construct or look up the corresponding category_id for use in get_category_products.