# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/uland-taobao/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/uland-taobao/get-homepage-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/uland-taobao/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/uland-taobao/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","size":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.