# Item 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.

> Retrieve detailed product information including pricing, images, and weight specifications directly from Taobao listings to compare products and make informed purchasing decisions. Access comprehensive product data from world.taobao.com to streamline your shopping research and product analysis.

**Category:** Marketplaces | **Website:** [item.taobao.com/item.htm?spm=a21bo.jianhua%2Fa.201876.d293.5af92a89Osg0BL&id=948892581504&scm=1007.40986.420852.528214_527807_537217_521582_543862_533297_528939_530923_532805_528109_545020_537488_546628_537987_547837_538037&pvid=b0977962-c8dc-45f6-8b93-903be6dea2d6&xxc=home_recommend&skuId=6025406526400&mi_id=k3JlF8ZMixNcZ8e5ewtaiU2EDTRR-mR9kswqnB1LVN861HyH-tpvGUsTB0vAQHajOowOWX6bMeM3TPeasgq72tZuGbZ97P8g9MpGQcej2Fs&utparam=%7B%22item_ctr%22%3A0%2C%22x_object_type%22%3A%22item%22%2C%22item_price%22%3A%2259%22%2C%22item_cvr%22%3A0%2C%22pc_scene%22%3A%2220001%22%2C%22aplus_abtest%22%3A%22013ad44fcbdeb9629c92f41f5d2fd86d%22%2C%22tpp_buckets%22%3A%2230986%23420852%23module%22%2C%22ab_info%22%3A%2230986%23420852%23-1%23%22%2C%22abid%22%3A%22528214_527807_537217_521582_543862_533297_528939_530923_532805_528109_545020_537488_546628_537987_547837_538037%22%2C%22pc_pvid%22%3A%22b0977962-c8dc-45f6-8b93-903be6dea2d6%22%2C%22mix_group%22%3A%22L5%22%2C%22item_ecpm%22%3A0%2C%22x_object_id%22%3A948892581504%7D](https://item.taobao.com/item.htm?spm=a21bo.jianhua%2Fa.201876.d293.5af92a89Osg0BL&id=948892581504&scm=1007.40986.420852.528214_527807_537217_521582_543862_533297_528939_530923_532805_528109_545020_537488_546628_537987_547837_538037&pvid=b0977962-c8dc-45f6-8b93-903be6dea2d6&xxc=home_recommend&skuId=6025406526400&mi_id=k3JlF8ZMixNcZ8e5ewtaiU2EDTRR-mR9kswqnB1LVN861HyH-tpvGUsTB0vAQHajOowOWX6bMeM3TPeasgq72tZuGbZ97P8g9MpGQcej2Fs&utparam=%7B%22item_ctr%22%3A0%2C%22x_object_type%22%3A%22item%22%2C%22item_price%22%3A%2259%22%2C%22item_cvr%22%3A0%2C%22pc_scene%22%3A%2220001%22%2C%22aplus_abtest%22%3A%22013ad44fcbdeb9629c92f41f5d2fd86d%22%2C%22tpp_buckets%22%3A%2230986%23420852%23module%22%2C%22ab_info%22%3A%2230986%23420852%23-1%23%22%2C%22abid%22%3A%22528214_527807_537217_521582_543862_533297_528939_530923_532805_528109_545020_537488_546628_537987_547837_538037%22%2C%22pc_pvid%22%3A%22b0977962-c8dc-45f6-8b93-903be6dea2d6%22%2C%22mix_group%22%3A%22L5%22%2C%22item_ecpm%22%3A0%2C%22x_object_id%22%3A948892581504%7D) | **Docs:** [parse.bot/marketplace/40b97764-0bee-499f-9b8f-4c2147213f74/item-taobao-com-api](https://parse.bot/marketplace/40b97764-0bee-499f-9b8f-4c2147213f74/item-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-item-taobao-com-api-40b97764/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_content

Retrieve product description content from a Taobao listing. Returns the item title, description text (SEO/meta description summarizing product reviews and key attributes), and available product images. The international endpoint provides publicly accessible description content without authentication.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Numeric Taobao item ID (e.g. 948892581504). Found in the id= parameter of Taobao product URLs. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-item-taobao-com-api-40b97764/get_product_content \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```

### get_product_detail

Retrieve comprehensive product details from a Taobao product listing including pricing, images, variants, specifications, reviews, seller info, and description content. Uses the public world.taobao.com endpoint. Variants and specifications require authentication and return empty when accessed publicly. Reviews include the review_count (total) and average_rating derived from the good-review percentage, plus a limited preview of individual reviews (typically 1) from the public SSR response; full review pagination requires authentication. Description includes meta-level product copy and gallery images. Seller info includes seller_id, seller_name, and shop_name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Numeric Taobao item ID (e.g. 948892581504). Found in the id= parameter of Taobao product URLs. |

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

### get_product_images

Retrieve all product images and the product name from a Taobao listing. Returns the item title and an array of image URLs from the product gallery. The international endpoint provides the main carousel images available without authentication.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Numeric Taobao item ID (e.g. 948892581504). Found in the id= parameter of Taobao product URLs. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-item-taobao-com-api-40b97764/get_product_images \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```

### get_product_variants

Extract SKU variant data from a Taobao product listing. Tries multiple data locations in the page (skuBase, skuCore, skuMap, inline JS blobs) and falls back to parsing variant properties from review skuInfo strings. Returns structured variant arrays with properties, prices, and stock where available from the public endpoint. Some items may have limited variant data publicly accessible.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Numeric Taobao item ID (e.g. 948892581504). Found in the id= parameter of Taobao product URLs. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-item-taobao-com-api-40b97764/get_product_variants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```