uland.taobao.com APIuland.taobao.com ↗
Access Taobao Union affiliate product listings, search results, and product details including pricing, coupon amounts, and origin via 3 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/f71dc23f-d59b-4f60-908d-779f7255e571/get_homepage_products?page=1&size=5&floor_id=29709' \ -H 'X-API-Key: $PARSE_API_KEY'
Get product listings from the Taobao Union homepage. Returns paginated affiliate product recommendations from various sections. Supports different floor sections (e.g. 29709 for featured products, 27258 for daily recommendations, 195 for ad products).
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination, starting from 0. |
| size | integer | Number of products to return per page. |
| floor_id | string | The section/floor ID determining which product feed to retrieve. Known values: '29709' (featured products), '27258' (daily recommendations). |
{
"type": "object",
"fields": {
"has_more": "boolean indicating if more pages are available",
"products": "array of product objects with item_id, name, price, price_after_coupon, coupon_amount, image, affiliate_url, coupon_url, commission_rate, seller_id, provcity",
"total_count": "integer total number of products available"
},
"sample": {
"data": {
"has_more": true,
"products": [
{
"name": "雀巢AL110安儿宁能恩乳糖不耐受 特殊医学用途婴儿无乳糖配方食品",
"image": "//img.alicdn.com/bao/uploaded/i1/6000000006148/O1CN01XGdD3Q1vHq8RQqhsp_!!6000000006148-0-at.jpg",
"price": "269",
"item_id": "520498517119",
"provcity": "上海",
"seller_id": 725677994,
"coupon_url": "//uland.taobao.com/coupon/edetail?e=...",
"affiliate_url": "//s.click.taobao.com/t?e=...",
"coupon_amount": "20",
"commission_rate": "750",
"price_after_coupon": "249"
}
],
"total_count": 200
},
"status": "success"
}
}About the uland.taobao.com API
This API exposes 3 endpoints covering Taobao Union's affiliate marketplace at uland.taobao.com, returning product listings, search results, and per-product detail. The get_homepage_products endpoint lets you page through curated affiliate feeds by floor section, while search_products accepts a keyword query and get_product_detail resolves a full product record including place of origin and post-coupon pricing.
Homepage Product Feeds
The get_homepage_products endpoint returns paginated affiliate product recommendations from the Taobao Union homepage. Use the floor_id parameter to target specific sections: 29709 for featured products, 27258 for daily recommendations, or 195 for ad products. Each page response includes a has_more boolean, a total_count integer, and a products array. Each product object carries item_id, name, price, price_after_coupon, coupon_amount, image, affiliate_url, coupon_url, and commission fields. Pagination starts at page=0.
Product Search
The search_products endpoint accepts a required query string and an optional size integer to control result count. It returns a products array with the same product object shape as the homepage feed, making it straightforward to query by keyword and compare prices or coupon values across results.
Product Detail
The get_product_detail endpoint takes an e_token — the encoded e parameter found in an affiliate or coupon URL — and returns a resolved url, name, price, and origin (place of origin). This is the only endpoint that surfaces geographic origin data, which is useful for supply chain research or filtering products by manufacturing region.
- Build an affiliate product feed aggregator using homepage floor sections and coupon_amount fields
- Track price_after_coupon changes on specific Taobao Union items over time
- Power a keyword-based product discovery tool using search_products with custom query terms
- Display place-of-origin labels on product listings using get_product_detail's origin field
- Identify high-commission affiliate opportunities by comparing commission values across homepage floors
- Resolve affiliate coupon URLs to canonical product pages using get_product_detail with e_token
| 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.