# Uland Taobao — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for products and retrieve detailed information including pricing, product specifications, and origin details from Taobao's affiliate marketplace. Browse homepage product listings and get comprehensive product data to help you find and analyze items available on the platform.

**Category:** Marketplaces | **Website:** [uland.taobao.com/](https://uland.taobao.com/) | **Docs:** [parse.bot/marketplace/b9f6bb61-932b-478c-b291-028023208496/uland-taobao-com-api](https://parse.bot/marketplace/b9f6bb61-932b-478c-b291-028023208496/uland-taobao-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-uland-taobao-com-api-b9f6bb61/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_homepage_products

Get product listings from the Taobao Union homepage. Returns paginated affiliate product recommendations with pricing and affiliate links. Uses keyword-based feed sections mapped from floor IDs. Some fields (coupon_amount, coupon_url, commission_rate, seller_id, provcity) may be null depending on the product.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `floor_id` | string | No | The section/floor ID determining which product feed to retrieve. |
| `page` | integer | No | Page number for pagination, starting from 0. |
| `size` | integer | No | Number of products to return per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uland-taobao-com-api-b9f6bb61/get_homepage_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"floor_id":"<string>","page":"<integer>","size":"<integer>"}'
```

### get_product_detail

Get detailed information for a specific product by following its affiliate/coupon click-tracking URL. Returns the resolved product page URL and any extractable metadata. The e_token parameter is obtained from the affiliate_url field of get_homepage_products or search_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `e_token` | string | Yes | The encoded token 'e' from the affiliate/coupon URL (from get_homepage_products or search_products affiliate_url field) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uland-taobao-com-api-b9f6bb61/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"e_token":"<string>"}'
```

### search_products

Search for products on Taobao Union by keyword. Returns affiliate product listings matching the search query with pricing and shop details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword |
| `size` | integer | No | Number of results per page |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uland-taobao-com-api-b9f6bb61/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","size":"<integer>"}'
```